|
|
1.1 root 1: .TH XWININFO 1 "27 July 1985" "X Version 10"
2: .SH NAME
3: xwininfo - X Window System, window information summarizer.
4: .SH SYNOPSIS
5: .B "xwininfo"
6: [ -children ] [ -help ] [ -id \fIid\fP ] [ -int ] [ -root ] [ \fIhost\fP:\fIdisplay\fP ]
7: .SH DESCRIPTION
8: .PP
9: .I Xwininfo
10: is a utility for displaying X window information summaries. All
11: pertinent window information is displayed in an easily readable
12: format. The user has the option of selecting the target window with
13: the mouse (by clicking any mouse button in the desired window) or by
14: specifying its' window id on the command line with the \fB-id\fP argument.
15: There is also a special \fB-root\fP argument to quickly obtain information
16: on X's root window. The following is a sample summary taken with
17: the \fB-children\fP argument specified.
18:
19: xwininfo ==> Please select the window you wish
20: ==> information on by clicking the
21: ==> mouse in that window.
22:
23: xwininfo ==> Window name: ' X Root Window '
24: ==> Window id: 0x10031
25: ==> Parent window id: 0x0
26: ==> Number of children: 13
27: ====> Child window id: 0xb00046
28: ====> Child window id: 0xb2004f
29: ====> Child window id: 0x630051
30: ====> Child window id: 0x5f0055
31: ====> Child window id: 0x5c0058
32: ====> Child window id: 0x55005c
33: ====> Child window id: 0x53005e
34: ====> Child window id: 0x510060
35: ====> Child window id: 0x42000c
36: ====> Child window id: 0x43000b
37: ====> Child window id: 0x3d0011
38: ====> Child window id: 0xa0028
39: ====> Child window id: 0x500061
40: ==> Associated window id: 0x0
41: ==> Window type: IsOpaque
42: ==> Window state: IsMapped
43: ==> Upper left X: 0
44: ==> Upper left Y: 0
45: ==> Width: 1088
46: ==> Height: 864
47: ==> Border width: 0
48: ==> Resize base width: 0
49: ==> Resize base height: 0
50: ==> Resize width increment: 1
51: ==> Resize height increment: 1
52: ==> Root absolute mouse X Position: 691
53: ==> Root absolute mouse Y Position: 261
54: ==> Target relative mouse X Position: 691
55: ==> Target relative mouse Y Position: 261
56:
57: .SH ARGUMENT SUMMARY
58: .PP
59: .TP 8
60: .B "-children"
61: This argument specifies that
62: .I xwininfo
63: should list the window ids' of
64: target window's children. Only the first level of the window
65: hierarchy is shown (i.e., immediate children of the target window).
66: .PP
67: .TP 8
68: .B "-help"
69: Print out the 'Usage:' command syntax summary.
70: .PP
71: .TP 8
72: .B "-id \fIid\fP"
73: This argument allows the user to specify a target window \fIid\fP on the
74: command line rather than using the mouse to select the target window.
75: This is very useful in debugging X applications where the target
76: window is not mapped to the screen or where the use of the mouse might
77: be impossible or interfere with the application.
78: .PP
79: .TP 8
80: .B "-int"
81: This argument specifies that all X window ids should be displayed as
82: integer values. The default is to display them as hexadecimal values.
83: .PP
84: .TP 8
85: .B "-root"
86: This argument specifies that X's root window is the target window.
87: This is useful in situations where the root window is completely
88: obscured.
89: .PP
90: .TP 8
91: .B "\fIhost\fP:\fIdisplay\fP"
92: This argument allow you to specify the host and display number on
93: which to find the target window. For example `xwininfo orpheus:1'
94: would specify that the target window is on display `1' on the machine
95: `orpheus'. By default,
96: .I xwininfo
97: uses the host and display number stored in the environment variable
98: DISPLAY, and therefore this argument is not normally specified.
99: .SH ENVIRONMENT
100: .PP
101: .TP 8
102: .B DISPLAY
103: To get default host and display number.
104: .SH SEE ALSO
105: X(1)
106: .SH FUTURE PLANS
107: If time ever presents itself...
108: .PP
109: .TP 8
110: .B 1.
111: Provide a `-geometry' argument that prints out the window's dimensions
112: in X window geometry format (i.e., =WxH+X+Y)
113: .PP
114: .TP 8
115: .B 2.
116: Provide a `-depth' argument that allows recursive traversal of the
117: window hierarchy to some arbitrary depth.
118: .SH AUTHOR
119: .PP
120: Copyright 1985, Massachusetts Institute of Technology.
121: .PP
122: Tony Della Fera, Digital Equipment Corp., MIT Project Athena
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.