--- xscope-1.1.man.txt 2009-10-09 20:25:54.037042000 -0700 +++ xscope-1.2.man.txt 2009-10-09 20:26:00.425607000 -0700 @@ -9,14 +9,18 @@ xscope - X Window Protocol Viewer SYNOPSIS - /usr/X11/bin/xscope [ option ] ... + /usr/X11/bin/xscope [-i] [-o] [- + h] [-d] [-q] [-v] [-r] [- + D] [-S] [-t] DESCRIPTION Xscope sits in-between an X11 client and an X11 server and prints the contents of each request, reply, error, or event - that is communicated between them. This information can be - useful in debugging and performance tuning of X11 servers - and clients. + that is communicated between them. Xscope can decode the + core X11 protocol and several extensions, including BIG- + REQUESTS, LBX, MIT-SHM, NCD-WinCenterPro, RANDR, and RENDER. + This information can be useful in debugging and performance + tuning of X11 servers and clients. To operate, xscope must know the host, port, and display to use to connect to the X11 server. In addition, it must know @@ -72,6 +76,101 @@ level 2 and above the length is explicitly printed. + -r Print only raw data without decoding it. + + -D + Print debugging information at the specified + level. + + -S Toggle output on or off when SIGUSR1 is received. + If n is 0, the initial state is off. If n is 1, + the initial state is on. + + -t Terminate xscope when all clients close. + +INTERACTIVE MODE + When xscope receives an interrupt signal (normally generated + by Control-C) it enters an interactive mode in which it + prompts for commands. Available commands in this mode are: + + audio, a Show current verbosity level for NAS protocol + packets. + + audio n, a n + Set current verbosity level for NAS protocol pack- + ets to n. + + break, b List currently defined breakpoints. + + break request..., b request... + Create a breakpoint for the specified protocol + requests. The breakpoint will be enabled by + default. When the breakpoint is enabled, xscope + will stop for interactive commands after process- + ing a request of the specified type. Requests + and extensions may be specified by name or number. + + + +X Version 11 Last change: xscope 1.2 2 + + + + + + +User Commands XSCOPE(1) + + + + If an extension is followed by a ":" and a number, + it will only break for the specified minor opcode + for that extension. Note that since extension + opcodes are not known until the extension is first + seen, breakpoints cannot currently be set on + extensions until after a QueryExtension request + and reply are processed for that extension, so + users may need to initially set a breakpoint on + QueryExtension, and after processing that set the + breakpoint for the target extension. + + cont, c Resume processing of data passing between server + and clients. + + delete, del + Delete all breakpoints. + + delete breakpoint..., del breakpoint... + Delete listed breakpoints, specified by number. + + disable, d + Disable all breakpoints. + + disable breakpoint..., d breakpoint... + Disable listed breakpoints, specified by number. + + enable, e Enable all breakpoints. + + enable breakpoint..., e breakpoint... + Enable listed breakpoints, specified by number. + + help, ? Print list of available commands. + + help command..., ? command... + Describe specified command or commands. + + level, l Show current verbosity level for X11 protocol + packets. + + level n, l n + Set current verbosity level for X11 protocol pack- + ets to n. + + quit, q Quit xscope. + + step, s Process one request, then prompt for another com- + mand. + EXAMPLES xscope -v4 -hcleo -d0 -o0 -i1 @@ -88,7 +187,8 @@ level 0). SEE ALSO - X(1), X11 Protocol document (doc/Protocol/X11.protocol) + X(5), Xsecurity(5), X11 Protocol and extension protocol + documents AUTHOR James L. Peterson (MCC) @@ -116,8 +216,6 @@ ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -BUGS - Code has only been tested on Sun3's. ATTRIBUTES