|
|
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.