4.3BSD-UWisc/man/cat1/xwininfo.1
XWININFO(1) UNIX Programmer's Manual XWININFO(1)
NAME
xwininfo - X Window System, window information summarizer.
SYNOPSIS
xwininfo [ -children ] [ -help ] [ -id _i_d ] [ -int ] [ -root
] [ _h_o_s_t:_d_i_s_p_l_a_y ]
DESCRIPTION
_X_w_i_n_i_n_f_o is a utility for displaying X window informa-
tion summaries. All pertinent window information is
displayed in an easily readable format. The user has
the option of selecting the target window with the mouse (by
clicking any mouse button in the desired window) or by
specifying its' window id on the command line with the -id
argument. There is also a special -root argument to quickly
obtain information on X's root window. The following is a
sample summary taken with the -children argument specified.
xwininfo ==> Please select the window you wish
==> information on by clicking the
==> mouse in that window.
xwininfo ==> Window name: ' X Root Window '
==> Window id: 0x10031
==> Parent window id: 0x0
==> Number of children: 13
====> Child window id: 0xb00046
====> Child window id: 0xb2004f
====> Child window id: 0x630051
====> Child window id: 0x5f0055
====> Child window id: 0x5c0058
====> Child window id: 0x55005c
====> Child window id: 0x53005e
====> Child window id: 0x510060
====> Child window id: 0x42000c
====> Child window id: 0x43000b
====> Child window id: 0x3d0011
====> Child window id: 0xa0028
====> Child window id: 0x500061
==> Associated window id: 0x0
==> Window type: IsOpaque
==> Window state: IsMapped
==> Upper left X: 0
==> Upper left Y: 0
==> Width: 1088
==> Height: 864
==> Border width: 0
==> Resize base width: 0
==> Resize base height: 0
==> Resize width increment: 1
==> Resize height increment: 1
==> Root absolute mouse X Position: 691
Printed 1/10/87 27 July 1985 1
XWININFO(1) UNIX Programmer's Manual XWININFO(1)
==> Root absolute mouse Y Position: 261
==> Target relative mouse X Position: 691
==> Target relative mouse Y Position: 261
ARGUMENT SUMMARY
-children
This argument specifies that _x_w_i_n_i_n_f_o should list
the window ids' of target window's children.
Only the first level of the window hierarchy
is shown (i.e., immediate children of the target
window).
-help Print out the 'Usage:' command syntax summary.
-id _i_d This argument allows the user to specify a target
window _i_d on the command line rather than using
the mouse to select the target window. This is very
useful in debugging X applications where the
target window is not mapped to the screen or where
the use of the mouse might be impossible or inter-
fere with the application.
-int This argument specifies that all X window ids should
be displayed as integer values. The default is to
display them as hexadecimal values.
-root This argument specifies that X's root window is
the target window. This is useful in situations
where the root window is completely obscured.
_h_o_s_t:_d_i_s_p_l_a_y
This argument allow you to specify the host and
display number on which to find the target window.
For example `xwininfo orpheus:1' would specify that
the target window is on display `1' on the machine
`orpheus'. By default, _x_w_i_n_i_n_f_o uses the host
and display number stored in the environment vari-
able DISPLAY, and therefore this argument is not
normally specified.
ENVIRONMENT
DISPLAY To get default host and display number.
SEE ALSO
X(1)
FUTURE PLANS
If time ever presents itself...
1. Provide a `-geometry' argument that prints out the
window's dimensions in X window geometry format
Printed 1/10/87 27 July 1985 2
XWININFO(1) UNIX Programmer's Manual XWININFO(1)
(i.e., =WxH+X+Y)
2. Provide a `-depth' argument that allows recursive
traversal of the window hierarchy to some arbi-
trary depth.
AUTHOR
Copyright 1985, Massachusetts Institute of Technology.
Tony Della Fera, Digital Equipment Corp., MIT Project Athena
Printed 1/10/87 27 July 1985 3