axdpyinfo − show information about the X11 server and display
axdpyinfo [−help] [−version] [−display address] [−xauthfile file] [−xauthtype type] [−xauthindex index]
Axdpyinfo connects to an X11 server and prints information about its configuration. Its function is similar to the xdpyinfo(1) program.
−h, −help, −−help
Print a brief usage summary and exit.
−V, −version, −−version
Print version and copyright information and exit.
The following
options control the X11 connection:
−d, −display
The address argument
specifies the X11 server endpoint to connect to. It can have
one of the following forms:
ip or ip:port
IPv4 address. If :port is omitted, a default of 6000 is assumed.
[ip6] or [ip6]:port
IPv6 address. Default port: 6000.
filename
Unix domain socket.
Without this option, axdpyinfo will attempt to connect via the Unix domain socket /tmp/.X11−unix/X0.
Note that this form differs from the standard DISPLAY format for X11 programs, and that the DISPLAY environment variable is ignored. The main reason for this (and for having the −xauth* options) is that axdpyinfo cannot resolve host names.
−xaf, −xauthfile
Choose which file to load X11 authentication data from. Without this option, the file name is determined from the environment (see the ENVIRONMENT section below). If the file cannot be loaded or no matching entry is found within it, axdpyinfo will attempt to connect with no authentication.
−xat, −xauthtype
When searching the .Xauthority file, only consider entries of the given type. It corresponds to the "family" field in <X11/Xauth.h> and the type of network layer used to connect to the display. Potentially useful values are: −1 to match any type of entry, 0 for an IPv4 entry, 6 for an IPv6 entry, and 256 for a local (Unix domain socket) entry. The default value is 256, which is useful in combination with the default value for the −display option (see above).
−xai, −xauthindex
When searching the .Xauthority file, the (index+1)’st entry of the matching type is used to authenticate. For example, if type is 256 and the index is 1, the second local (Unix domain socket) entry will be chosen. The default index is 0.
|
HOME |
If $XAUTHORITY is not set and no −xauthfile option is given, X11 authentication data is loaded from $HOME/.Xauthority. |
XAUTHORITY
If set and no −xauthfile option is given, X11 authentication data is loaded from this file.
Axdpyinfo is written in a custom programming language called Asterix, without using the Xlib (or xcb) library normally used for X11 client programs; as such it has some limitations that X11 programs normally don’t have.
The DISPLAY environment variable is ignored.
For X11 authentication, only MIT-MAGIC-COOKIE-1 keys are supported.
Exit codes are somewhat arbitrary and undocumented.
(See aximgview(1) for more detailed information.)
Copyright (c) 2020 Pim Goossens
This program is free software: you are free to change and redistribute it under the terms of the GNU General Public License (GPL) version 3 or (at your option) any later version. A copy of this license should be included with the program in a file named COPYING.
There is NO WARRANTY, to the extent permitted by law.
aximgview(1), xdpyinfo(1)