XWININFO(1)

NAME
xwininfo - X Window System, window information summarizer.

SYNOPSIS
xwininfo [ -children ] [ -help ] [ -id id ] [ -int ] [ -root ] [ host:display ]

DESCRIPTION

Xwininfo is a utility for displaying X window information 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
         ==> 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 xwininfo 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 id
    This argument allows the user to specify a target window id 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 interfere 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.

host:display
    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, xwininfo uses the host and display number stored in the environment variable 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 (i.e., =WxH+X+Y)

2.  Provide a `-depth' argument that allows recursive traversal of the window hierarchy to some arbitrary depth.

AUTHOR

Copyright 1985, Massachusetts Institute of Technology.

Tony Della Fera, Digital Equipment Corp., MIT Project Athena