|
|
1.1 root 1: .TH XWININFO 1 "1 July 1987" "X Version 11"
2: .SH NAME
3: xwininfo - X Window System window information summarizer.
4: .SH SYNOPSIS
5: .B "xwininfo"
6: [ -help ] [ -id \fIid\fP ] [ -root ] [ -name \fIname\fP ] [ -int ]
7: [ -tree ] [ -stats ]
8: [ -bits ] [ -events ] [ -size ] [ -wm ] [ \fIhost\fP:\fIdisplay\fP ]
9: .SH DESCRIPTION
10: .PP
11: .I Xwininfo
12: is a utility for displaying X window information summaries.
13: Depending on what options are choosen, various information is displayed.
14: Refer to the various options for what information is available.
15: If no options are choosen, -stats is assumed.
16: .PP
17: The user has the option of selecting the target window with
18: the mouse (by clicking any mouse button in the desired window) or by
19: specifying its window id on the command line with the \fB-id\fP argument.
20: In addition, if it is easier, instead of specifying
21: the window by its id number, the \fB-name\fP argument may be used to specify
22: which window is desired by name.
23: There is also a special \fB-root\fP argument to quickly obtain information
24: on X's root window.
25: .PP
26: The following is a sample summary taken with
27: no arguments specified:
28:
29: xwininfo ==> Please select the window you wish
30: ==> information on by clicking the
31: ==> mouse in that window.
32:
33: xwininfo ==> Window id: 0x8006b (fred)
34:
35: ==> Upper left X: 0
36: ==> Upper left Y: 0
37: ==> Width: 1024
38: ==> Height: 864
39: ==> Depth: 1
40: ==> Border width: 0
41: ==> Window class: InputOutput
42: ==> Window Map State: IsUnviewable
43:
44: .SH ARGUMENT SUMMARY
45: .PP
46: .TP 8
47: .B "-help"
48: Print out the 'Usage:' command syntax summary.
49: .PP
50: .TP 8
51: .B "-id \fIid\fP"
52: This argument allows the user to specify a target window \fIid\fP on the
53: command line rather than using the mouse to select the target window.
54: This is very useful in debugging X applications where the target
55: window is not mapped to the screen or where the use of the mouse might
56: be impossible or interfere with the application.
57: .PP
58: .TP 8
59: .B "-name \fIname\fP"
60: This argument allows the user to specify that the window named \fIname\fP
61: is the target window on the command line rather than using the mouse to
62: select the target window.
63: .PP
64: .TP 8
65: .B "-root"
66: This argument specifies that X's root window is the target window.
67: This is useful in situations where the root window is completely
68: obscured.
69: .PP
70: .TP 8
71: .B "-int"
72: This argument specifies that all X window ids should be displayed as
73: integer values. The default is to display them as hexadecimal values.
74: .PP
75: .TP 8
76: .B -tree
77: This argument causes the root, parent, and children windows id's and name's of
78: the selected window to be displayed.
79: .PP
80: .TP 8
81: .B -stats
82: This argument causes various attributes of the selected window having
83: to do with its location and appearence to be displayed.
84: Information displayed includes the location of the window,
85: its width and height, its depth, border width, class, and map state.
86: .PP
87: .TP 8
88: .B -bits
89: This argument causes various attributes of the selected window having
90: to do with its raw bits and how it is to be stored to be displayed.
91: Information displayed includes the window's window and bit gravities,
92: the window's backing store hint and backing_planes value, its backing pixel,
93: and whether or not the window has save-under set.
94: .PP
95: .TP 8
96: .B -events
97: This argument causes the selected window's event masks to be displayed.
98: Both the event mask of events wanted by some client and the event mask of
99: events not to prograte are displayed.
100: .PP
101: .TP 8
102: .B -size
103: This argument causes the selected window's sizing hints to be displayed.
104: Information displayed includes for both the normal size hints and the
105: zoom size hints the user supplied location if any, the program supplied
106: location if any, the user supplied size if any, the program supplied size if
107: any, the minimum size if any, the maximum size if any, the resize increments
108: if any, and the minimum and maximum aspect ratios if any.
109: .PP
110: .TP 8
111: .B -wm
112: This argument causes the selected window's window manager hints to be
113: displayed. Information displayed may include whether or not the application
114: accepts input, what the window's icon window # and name is, where the window's
115: icon should go, and what the window's initial state should be.
116: .PP
117: .TP 8
118: .B "\fIhost\fP:\fIdisplay\fP"
119: This argument allow you to specify the host and display number on
120: which to find the target window. For example `xwininfo orpheus:1'
121: would specify that the target window is on display `1' on the machine
122: `orpheus'. By default,
123: .I xwininfo
124: uses the host and display number stored in the environment variable
125: DISPLAY, and therefore this argument is not normally specified.
126: .SH ENVIRONMENT
127: .PP
128: .TP 8
129: .B DISPLAY
130: To get default host and display number.
131: .SH SEE ALSO
132: X(1)
133: .SH AUTHOR
134: Mark Lillibridge, MIT Project Athena
135: .br
136: Copyright 1987, Massachusetts Institute of Technology.
137:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.