320 lines
8.6 KiB
HTML
320 lines
8.6 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XWININFO</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XWININFO</H1>
|
|
Section: User Commands (1)<BR>Updated: xwininfo 1.1.5<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
xwininfo - window information utility for X
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>xwininfo</B>
|
|
|
|
[-help] [-id <I>wdid</I>] [-root] [-name <I>wdname</I>] [-int]
|
|
[-children] [-tree] [-stats] [-bits] [-events] [-size] [-wm] [-shape]
|
|
[-frame] [-all]
|
|
[-english] [-metric]
|
|
[-display <I>host:dpy</I>] [-version]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
|
|
<I>Xwininfo</I>
|
|
|
|
is a utility for displaying information about windows.
|
|
Various information is displayed depending on which options are selected.
|
|
If no options are chosen, <B>-stats</B> is assumed.
|
|
<P>
|
|
|
|
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 <B>-id</B> option.
|
|
Or instead of specifying
|
|
the window by its id number, the <B>-name</B> option may be used to specify
|
|
which window is desired by name.
|
|
There is also a special <B>-root</B> option to quickly obtain information
|
|
on the screen's root window.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-help</B>
|
|
|
|
<DD>
|
|
Print out the `Usage:' command syntax summary.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="2"><B>-id </B><I>wdid</I>
|
|
|
|
<DD>
|
|
This option allows the user to specify a target window <I>wdid</I> 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.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="3"><B>-name </B><I>wdname</I>
|
|
|
|
<DD>
|
|
This option allows the user to specify that the window named <I>wdname</I>
|
|
is the target window on the command line rather than using the mouse to
|
|
select the target window.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="4"><B>-root</B>
|
|
|
|
<DD>
|
|
This option specifies that X's root window is the target window.
|
|
This is useful in situations where the root window is completely obscured.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="5"><B>-int</B>
|
|
|
|
<DD>
|
|
This option specifies that all X window ids should be displayed as
|
|
integer values. The default is to display them as hexadecimal values.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="6"><B>-children</B>
|
|
|
|
<DD>
|
|
This option causes the root, parent, and children windows' ids and names of
|
|
the selected window to be displayed.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="7"><B>-tree</B>
|
|
|
|
<DD>
|
|
This option is like <B>-children</B> but displays all children recursively.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="8"><B>-stats</B>
|
|
|
|
<DD>
|
|
This option causes the display of various attributes pertaining to
|
|
the location and appearance of the selected window.
|
|
Information displayed includes the location of the window,
|
|
its width and height, its depth, border width, visual id and class,
|
|
colormap id if any, map state, backing-store hint, and location of the corners.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="9"><B>-bits</B>
|
|
|
|
<DD>
|
|
This option causes the display of various attributes pertaining to
|
|
the selected window's raw bits and how the selected window is to be stored.
|
|
Displayed information includes the selected window's bit gravity,
|
|
window gravity, backing-store hint, backing-planes value, backing pixel,
|
|
and whether or not the window has save-under set.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="10"><B>-events</B>
|
|
|
|
<DD>
|
|
This option causes the selected window's event masks to be displayed.
|
|
Both the event mask of events wanted by some client and the event mask of
|
|
events not to propagate are displayed.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="11"><B>-size</B>
|
|
|
|
<DD>
|
|
This option causes the selected window's sizing hints to be displayed.
|
|
Displayed information includes: for both the normal size hints and the
|
|
zoom size hints, the user supplied location if any; the program supplied
|
|
location if any; the user supplied size if any; the program supplied size if
|
|
any; the minimum size if any; the maximum size if any; the resize increments
|
|
if any; and the minimum and maximum aspect ratios if any.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="12"><B>-wm</B>
|
|
|
|
<DD>
|
|
This option causes the selected window's window manager hints to be
|
|
displayed. Information displayed may include whether or not the application
|
|
accepts input, what the window's icon window # and name is, where the window's
|
|
icon should go, and what the window's initial state should be.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="13"><B>-shape</B>
|
|
|
|
<DD>
|
|
This option causes the selected window's window and border shape extents to
|
|
be displayed.
|
|
<DT id="14"><B>-frame</B>
|
|
|
|
<DD>
|
|
This option causes window manager frames to be considered when manually
|
|
selecting windows.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="15"><B>-metric</B>
|
|
|
|
<DD>
|
|
This option causes all individual height, width, 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
|
|
<B>+x+y</B> form are not changed.
|
|
<DT id="16"><B>-english</B>
|
|
|
|
<DD>
|
|
This option causes all individual height, width, and x and y positions to be
|
|
displayed in inches (and feet, yards, and miles if necessary) as well as
|
|
number of pixels. <B>-metric</B> and <B>-english</B> may both be enabled at the
|
|
same time.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="17"><B>-all</B>
|
|
|
|
<DD>
|
|
This option is a quick way to ask for all information possible.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="18"><B>-d, -display </B><I>host:dpy</I>
|
|
|
|
<DD>
|
|
This option allows you to specify the server to connect to; see <I><A HREF="/cgi-bin/man/man2html?7+X">X</A>(7)</I>.
|
|
</DL>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="19"><B>-version</B>
|
|
|
|
<DD>
|
|
This option indicates that
|
|
<I>xwininfo</I>
|
|
|
|
should print its version information and exit.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>EXAMPLE</H2>
|
|
|
|
<P>
|
|
|
|
The following is a sample summary taken with no options specified:
|
|
<P>
|
|
xwininfo: Window id: 0x60000f "xterm"
|
|
<P>
|
|
<BR> Absolute upper-left X: 2
|
|
<BR> Absolute upper-left Y: 85
|
|
<BR> Relative upper-left X: 0
|
|
<BR> Relative upper-left Y: 25
|
|
<BR> Width: 579
|
|
<BR> Height: 316
|
|
<BR> Depth: 8
|
|
<BR> Visual: 0x1e
|
|
<BR> Visual Class: PseudoColor
|
|
<BR> Border width: 0
|
|
<BR> Class: InputOutput
|
|
<BR> Colormap: 0x27 (installed)
|
|
<BR> Bit Gravity State: NorthWestGravity
|
|
<BR> Window Gravity State: NorthWestGravity
|
|
<BR> Backing Store State: NotUseful
|
|
<BR> Save Under State: no
|
|
<BR> Map State: IsViewable
|
|
<BR> Override Redirect State: no
|
|
<BR> Corners: +2+85 -699+85 -699-623 +2-623
|
|
<BR> -geometry 80x24+0+58
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="20"><B>DISPLAY</B>
|
|
|
|
<DD>
|
|
To get the default host and display number.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?7+X">X</A></I>(7),
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xprop">xprop</A></I>(1),
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xdpyinfo">xdpyinfo</A></I>(1),
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xdriinfo">xdriinfo</A></I>(1),
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xvinfo">xvinfo</A></I>(1),
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+glxinfo">glxinfo</A></I>(1)
|
|
|
|
<A NAME="lbAI"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
Using <B>-stats -bits</B> shows some redundant information.
|
|
<P>
|
|
|
|
The <B>-geometry</B> string displayed must make assumptions about the
|
|
window's border width and the behavior of the application and the
|
|
window manager. As a result, the location given is not always
|
|
correct.
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Mark Lillibridge, MIT Project Athena
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="21"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="22"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="23"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="24"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="25"><A HREF="#lbAF">EXAMPLE</A><DD>
|
|
<DT id="26"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="27"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="28"><A HREF="#lbAI">BUGS</A><DD>
|
|
<DT id="29"><A HREF="#lbAJ">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:31 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|