xwininfo(1) X Version 11 (24 October 1988) xwininfo(1)
NAME
xwininfo - displays window information
SYNOPSIS
xwininfo [-options. . .]
DESCRIPTION
The xwininfo utility displays information about windows.
Depending upon which options you choose, various information
is displayed. If you choose no options, xwininfo assumes
-stats.
You can select the target window with the mouse (by clicking
any mouse button in the desired window) or on the command
line by specifying the window ID with the -id option. You
can also use the -name option to specify the desired window
by name.
If you want to quickly obtain information about the root
window, use the -root option.
OPTIONS
-help
Prints out the command syntax summary.
-id id
Specifies a target window id on the command line. This
is very useful in debugging X applications where the
target window is not mapped to the screen or when you
cannot use the mouse.
-name name
Specifies the window name as the target window.
-root
Specifies the root window as the target window. This
option is useful when the root window is completely
obscured.
-int Displays all X window IDs as integer values. The
default displays them as hexadecimal values.
-tree
Displays the root, parent, and children window IDs as
well as the name of the selected window.
-stats
Displays various attributes of the selected window.
Information displayed includes the location of the
window, its width and height, its depth, border width,
class, colormap ID if any, map state, backing-store
hint, and location of the corners.
Page 1 (printed 10/4/89)
xwininfo(1) X Version 11 (24 October 1988) xwininfo(1)
-bits
Displays information on the target window's bit
gravity, window gravity, backing-store hint, backing-
planes value, backing pixel, and whether or not the
window has save-under set.
-events
Dispalys the selected window's event masks. This
option displays both the event mask of events wanted by
some client and the event mask of events not to
propagate.
-size
Displays the selected window's sizing hints. The
information displayed for both normal size and zoom
size hints includes where applicable: the user supplied
location, the program supplied location, the user
supplied size, the program supplied size, the minimum
size, the maximum size, the resize increments, and the
minimum and maximum aspect ratios.
-wm Displays the hints of the selected window manager.
Information displayed may include whether or not the
application accepts input, the window's icon window
number and name, where the window's icon should go, and
what the window's initial state should be.
-metric
Dispalys all individual height, width, and X and Y
positions in millimeters as well as number of pixels,
based on what the server thinks the resolution is.
Geometry specifications in the +x+y form are not
changed.
-english
Displays all individual height, width, and X and Y
positions in inches (and feet, yards, and miles if
necessary) as well as number of pixels. You can specify
both -metric and -english at the same time.
-all Displays all information possible.
-display display
Specifies the server.
EXAMPLE
The following is a sample summary taken with no options
specified:
xwininfo ==> Please select the window about which you
==> would like information by clicking the
==> mouse in that window.
Page 2 (printed 10/4/89)
xwininfo(1) X Version 11 (24 October 1988) xwininfo(1)
xwininfo ==> Window id: 0x60000f (xterm)
==> Upper left X: 4
==> Upper left Y: 19
==> Width: 726
==> Height: 966
==> Depth: 4
==> Border width: 3
==> Window class: InputOutput
==> Colormap: 0x80065
==> Window Bit Gravity State: NorthWestGravity
==> Window Window Gravity State: NorthWestGravity
==> Window Backing Store State: NotUseful
==> Window Save Under State: no
==> Window Map State: IsViewable
==> Window Override Redirect State: no
==> Corners: +4+19 -640+19 -640-33 +4-33
ENVIRONMENT
DISPLAY
Gets the default host and display number.
SEE ALSO
X(1)
xprop(1)
COPYRIGHT
Copyright 1988, Massachusetts Institute of Technology.
See X(1) for a full statement of rights and permissions.
AUTHOR
Mark Lillibridge, MIT Project Athena.
Page 3 (printed 10/4/89)