xwininfo(1X) xwininfo(1X)NAME xwininfo - displays information about windows SYNOPSIS xwininfo [-help] [-root] [-id id] [-name name] [-int] [- tree] [-stats] [-bits] [-events] [-size] [-wm] [-all] [-english] [-metric] [-display display] [-shape] [-frame] DESCRIPTION xwininfo displays information about windows. Depending on the options you use, various information is displayed. If you do not use any options, xwininfo assumes that you used the -stats option. You can select the target window by positioning the pointer in the desired window and pressing the mouse button (or the LEFT or RIGHT ARROW key). You can also specify the target window on the command line. Options The xwininfo command accepts these options: -all Displays all possible information. -bits Displays various attributes of the selected window that have to do with its raw bits and how it is to be stored. The information includes the window's window and bit gravities, its backing-store hint and backing-planes value, its backing pixel, and whether the window has save-under set. -display display Specifies the server to connect to. See X(1X) for details. -english Causes all individual width and height and x and y positions to be displayed in inches (and feet, yards, and miles, if necessary) as well as number of pixels. You can use the -metric and -english options at the same time. -events Displays the event masks of the selected window. Both the event mask of events wanted by some client and the event mask of events not to propagate are displayed. -frame Causes window manager frames not to be ignored when manually selecting windows. -help Displays a summary of the command syntax. November, 1990 1
xwininfo(1X) xwininfo(1X)-id id Specifies a target window ID. This option is useful in debugging X applications where the target window is not mapped to the screen or where the using the mouse might be impossible or interfere with the ap- plication. -int Displays all window IDs as integer values. The de- fault is to display them as hexadecimal values. -metric Causes all individual width and height and x and y positions to be displayed in millimeters as well as number of pixels, based on what the server thinks the resolution is. Geometry specifications that are in +x+y form are not changed. You can use the -metric and -english options at the same time. -name name Specifies that the window called name is the target window. -root Specifies that the X background window is the target window. This option is useful in situations where the background window is completely obscured. -shape Causes the shape extents of the selected window to be displayed. For example, try this option on an oclock or a shaped xlogo window. -size Displays the sizing hints of the selected window. The information includes the normal size hints and the zoom size hints, any user-supplied location, any program-supplied location, any user-supplied size, any program-supplied size, any minimum size, any maximum size, any resize increments, and any minimum and maximum aspect ratios. -stats Displays various attributes of the selected window that have to do with its location and appearance. The information includes the window's location, width, height, depth, border width, class, colormap ID (if any), map state, and backing-store hint as well as the location of its corners. -tree Displays the window IDs and names of the selected window's root, parent, and child windows. -wm Displays the window manager hints of the selected window. The information may include whether the ap- plication accepts input, what the icon window number and name are, where the window's icon should go, and what the window's initial state should be. 2 November, 1990
xwininfo(1X) xwininfo(1X)Environment variables The xwininfo command uses the following environment vari- able: DISPLAY Specifies the default host, display number, and screen. EXAMPLES The following example shows the status information that xwininfo displayed for a selected window: xwininfo ==> Please select the window you ==> wish information on by clicking ==> the mouse in that window. 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 LIMITATIONS Using both the -stats and the -bits options cause xwininfo to display redundant information. NOTES Copyright 1988, Massachusetts Institute of Technology. See X(1X) for a full statement of rights and permissions. Author: Mark Lillibridge, MIT Project Athena SEE ALSO X(1X), xprop(1X) November, 1990 3