From 490ceddc3e97e8c5bf1ed61265525c213abf65d1 Mon Sep 17 00:00:00 2001 From: Gaetan Nadon Date: Wed, 19 Jan 2011 10:06:55 -0500 Subject: config: move man pages into their own directory Use services provided by XORG_MANPAGE_SECTIONS. Use standard Makefile for man pages. Signed-off-by: Gaetan Nadon --- Makefile.am | 23 +- Xmark.man | 66 ---- configure.ac | 5 +- man/Makefile.am | 12 + man/Xmark.man | 66 ++++ man/x11perf.man | 1016 +++++++++++++++++++++++++++++++++++++++++++++++++++ man/x11perfcomp.man | 80 ++++ x11perf.man | 1016 --------------------------------------------------- x11perfcomp.man | 80 ---- 9 files changed, 1180 insertions(+), 1184 deletions(-) delete mode 100644 Xmark.man create mode 100644 man/Makefile.am create mode 100644 man/Xmark.man create mode 100644 man/x11perf.man create mode 100644 man/x11perfcomp.man delete mode 100644 x11perf.man delete mode 100644 x11perfcomp.man diff --git a/Makefile.am b/Makefile.am index c14391c..3b6d13b 100644 --- a/Makefile.am +++ b/Makefile.am @@ -19,6 +19,7 @@ # TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. +SUBDIRS = man bin_PROGRAMS = x11perf bin_SCRIPTS = x11perfcomp @@ -52,34 +53,14 @@ x11perf_SOURCES = \ x11perf.c \ x11perf.h -appman_PRE = \ - x11perfcomp.man \ - x11perf.man \ - Xmark.man - x11perfcomp: x11pcomp.cpp $(AM_V_GEN)$(SED) s/LIBPATH/`echo $(LIBPATH) | sed -e s/\\\\//\\\\\\\\\\\\\//g`/ < $(srcdir)/x11pcomp.cpp | \ $(SED) s/XCOMM/\#/ > $@ - -MAINTAINERCLEANFILES = ChangeLog INSTALL CLEANFILES = $(bin_SCRIPTS) x11perfcomp - EXTRA_DIST = x11pcomp.cpp -appmandir = $(APP_MAN_DIR) - -appman_DATA = $(appman_PRE:man=@APP_MAN_SUFFIX@) - -EXTRA_DIST += $(appman_PRE) -CLEANFILES += $(appman_DATA) - -SUFFIXES = .$(APP_MAN_SUFFIX) .man - -# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure -.man.$(APP_MAN_SUFFIX): - $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@ - +MAINTAINERCLEANFILES = ChangeLog INSTALL .PHONY: ChangeLog INSTALL diff --git a/Xmark.man b/Xmark.man deleted file mode 100644 index 4e91162..0000000 --- a/Xmark.man +++ /dev/null @@ -1,66 +0,0 @@ -.\" This manpage was written by Richard Braakman and is licensed under the -.\" XFree86 license. -.TH Xmark 1 __xorgversion__ -.SH NAME -Xmark \- summarize x11perf results -.SH SYNTAX -.B Xmark -datafile -.SH DESCRIPTION -.B Xmark -is a shell script that reads the indicated datafile and compiles a -benchmark which it writes to standard output. It writes three -numbers: -.PP -.RS -A weighted performance number for the -.I x11perf -results. -.PP -A weighted performance number for a standard SparcStation 1, with -SunOS 4.1.2, X11R5 Xsun, and a CG3 dumb Color Frame Buffer. -.\" I assume the latter is a graphics card. -.PP -The Xmark, which is the ratio of the two numbers above. -.RE -.PP -The datafile must be an ordinary file, produced by x11perf in the -following way: -.PP -.BI "x11perf -display " display " -v1.3 -rop GXcopy GXxor -all > " datafile -.PP -It is possible to run the GXcopy and GXxor tests separately, as long as they -are concatenated to the same output file: -.nf -.BI "x11perf -display " display " -v1.3 -rop GXcopy -all > " datafile -.BI "x11perf -display " display " -v1.3 -rop GXxor -all >> " datafile -.fi -or -.nf -.BI "x11perf -display " display " -v1.3 -rop GXxor -all > " datafile -.BI "x11perf -display " display " -v1.3 -rop GXcopy -all >> " datafile -.fi -.SH FILES -.TP -.B temp.$$ -Temporary file created in the current directory, deleted after use. -.SH DIAGNOSTICS -.TP -.B Usage: Xmark datafile -.I Xmark -was invoked without arguments or with more than one argument, or -with options. Xmark takes no options. -.TP -.B "Error: data file does not exist or is not ordinary." -.I Xmark -cannot find the datafile named on its command line, or the datafile -is a special file such as a directory. -.TP -.BR "WARNING: datafile contains " nnn ", not 441 or 447 'trep' results;" -The file named on the command line does not seem to be a file generated -by x11perf in the expected way. -.TP -.BR "Diagnostic: ERROR: sum of weights =" nnn ", not equal to 4566.0;" -There is an internal error in Xmark. -.SH "SEE ALSO" -X(__miscmansuffix__), x11perf(__appmansuffix__), x11perfcomp(__appmansuffix__) diff --git a/configure.ac b/configure.ac index 552ea8d..96126f2 100644 --- a/configure.ac +++ b/configure.ac @@ -72,4 +72,7 @@ yes) ;; esac -AC_OUTPUT([Makefile]) +AC_CONFIG_FILES([ + Makefile + man/Makefile]) +AC_OUTPUT diff --git a/man/Makefile.am b/man/Makefile.am new file mode 100644 index 0000000..14c63bd --- /dev/null +++ b/man/Makefile.am @@ -0,0 +1,12 @@ + +appmandir = $(APP_MAN_DIR) +appman_PRE = x11perfcomp.man x11perf.man Xmark.man +appman_DATA = $(appman_PRE:man=$(APP_MAN_SUFFIX)) + +EXTRA_DIST = $(appman_PRE) +CLEANFILES = $(appman_DATA) +SUFFIXES = .$(APP_MAN_SUFFIX) .man + +# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure +.man.$(APP_MAN_SUFFIX): + $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@ diff --git a/man/Xmark.man b/man/Xmark.man new file mode 100644 index 0000000..4e91162 --- /dev/null +++ b/man/Xmark.man @@ -0,0 +1,66 @@ +.\" This manpage was written by Richard Braakman and is licensed under the +.\" XFree86 license. +.TH Xmark 1 __xorgversion__ +.SH NAME +Xmark \- summarize x11perf results +.SH SYNTAX +.B Xmark +datafile +.SH DESCRIPTION +.B Xmark +is a shell script that reads the indicated datafile and compiles a +benchmark which it writes to standard output. It writes three +numbers: +.PP +.RS +A weighted performance number for the +.I x11perf +results. +.PP +A weighted performance number for a standard SparcStation 1, with +SunOS 4.1.2, X11R5 Xsun, and a CG3 dumb Color Frame Buffer. +.\" I assume the latter is a graphics card. +.PP +The Xmark, which is the ratio of the two numbers above. +.RE +.PP +The datafile must be an ordinary file, produced by x11perf in the +following way: +.PP +.BI "x11perf -display " display " -v1.3 -rop GXcopy GXxor -all > " datafile +.PP +It is possible to run the GXcopy and GXxor tests separately, as long as they +are concatenated to the same output file: +.nf +.BI "x11perf -display " display " -v1.3 -rop GXcopy -all > " datafile +.BI "x11perf -display " display " -v1.3 -rop GXxor -all >> " datafile +.fi +or +.nf +.BI "x11perf -display " display " -v1.3 -rop GXxor -all > " datafile +.BI "x11perf -display " display " -v1.3 -rop GXcopy -all >> " datafile +.fi +.SH FILES +.TP +.B temp.$$ +Temporary file created in the current directory, deleted after use. +.SH DIAGNOSTICS +.TP +.B Usage: Xmark datafile +.I Xmark +was invoked without arguments or with more than one argument, or +with options. Xmark takes no options. +.TP +.B "Error: data file does not exist or is not ordinary." +.I Xmark +cannot find the datafile named on its command line, or the datafile +is a special file such as a directory. +.TP +.BR "WARNING: datafile contains " nnn ", not 441 or 447 'trep' results;" +The file named on the command line does not seem to be a file generated +by x11perf in the expected way. +.TP +.BR "Diagnostic: ERROR: sum of weights =" nnn ", not equal to 4566.0;" +There is an internal error in Xmark. +.SH "SEE ALSO" +X(__miscmansuffix__), x11perf(__appmansuffix__), x11perfcomp(__appmansuffix__) diff --git a/man/x11perf.man b/man/x11perf.man new file mode 100644 index 0000000..1fcbf20 --- /dev/null +++ b/man/x11perf.man @@ -0,0 +1,1016 @@ +.\" Copyright 1988, 1989 Digital Equipment Corporation. +.\" Copyright 1989, 1994, 1998 The Open Group +.\" +.\" Permission to use, copy, modify, distribute, and sell this software and its +.\" documentation for any purpose is hereby granted without fee, provided that +.\" the above copyright notice appear in all copies and that both that +.\" copyright notice and this permission notice appear in supporting +.\" documentation. +.\" +.\" The above copyright notice and this permission notice shall be included +.\" in all copies or substantial portions of the Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR +.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +.\" OTHER DEALINGS IN THE SOFTWARE. +.\" +.\" Except as contained in this notice, the name of The Open Group shall +.\" not be used in advertising or otherwise to promote the sale, use or +.\" other dealings in this Software without prior written authorization +.\" from The Open Group. +.\" +.\" +.TH X11PERF 1 __xorgversion__ +.SH NAME +x11perf \- X11 server performance test program +.SH SYNTAX +.B x11perf +[ \-option ... ] +.SH DESCRIPTION +The +.I x11perf +program runs one or more performance tests and reports how fast an X server can +execute the tests. +.PP +Many graphics benchmarks assume that the graphics device is used to display the +output of a single fancy graphics application, and that the user gets his work +done on some other device, like a terminal. Such benchmarks usually measure +drawing speed for lines, polygons, text, etc. +.PP +Since workstations are not used as standalone graphics engines, but as +super-terminals, +.I x11perf +measures window management performance as well as +traditional graphics performance. +.I x11perf +includes benchmarks for the time it +takes to create and map windows (as when you start up an application); to map a +pre-existing set of windows onto the screen (as when you deiconify an +application or pop up a menu); and to rearrange windows (as when you slosh +windows to and fro trying to find the one you want). +.PP +.I x11perf +also measures graphics performance for operations not normally used in +standalone graphics displays, but are nonetheless used frequently by X +applications. Such operations include CopyPlane (used to map bitmaps into +pixels), scrolling (used in text windows), and various stipples and tiles +(used for CAD and color half-toning, respectively). +.PP +.I x11perf +should be used to analyze particular strengths and weaknesses +of servers, and is most useful to a server writer who wants to +analyze and improve a server. +.I x11perf +is meant to comprehensively exercise just about every X11 operation you can +perform; it does not purport to be a representative sample of the +operations that X11 applications actually use. +While it can be used as a benchmark, it was written and is intended as +a performance testing tool. +.PP +As such, +.I x11perf +DOES NOT whittle down measurements to a single ``HeXStones'' +or ``MeXops'' number. We consider such numbers to be uninformative +at best and misleading at worst. +Some servers which are very fast for certain applications can be +very slow for others. +No single number or small set of numbers are sufficient to +characterize how an X implementation will perform on all applications. +However, by knowledge of your favorite application, you +may be able to use the numbers +.I x11perf +reports to predict its performance on a given X implementation. +.PP +That said, you might also want to look at +.I x11perfcomp(__appmansuffix__), +a program to compare the outputs of different +.I x11perf +runs. You provide a list of files containing results from +.I x11perf, +and it lays them out in a nice tabular format. +.PP +For repeatable results, +.I x11perf +should be run using a local connection on a +freshly-started server. The default configuration runs each test 5 times, in +order to see if each trial takes approximately the same amount of time. +Strange glitches should be examined; if non-repeatable one might +chalk them up to +daemons and network traffic. Each trial is run for 5 seconds, in order to +reduce random time differences. The number of objects processed per second is +displayed to 3 significant digits, but you'll be lucky on most UNIX system if +the numbers are actually consistent to 2 digits. +.I x11perf +moves the cursor out of the test window; you should be careful not +to bump the mouse and move it back into the window. +(A prize to people who correctly explain why!!). +.PP +Before running a test, +.I x11perf +determines what the round trip time to the server is, and factors this out of +the final timing reported. It ensures that the server has actually performed +the work requested by fetching a pixel back from the test window, which means +that servers talking to graphics accelerators can't claim that they are done, +while in the meantime the accelerator is painting madly. +.PP +By default +.I x11perf +automatically calibrates the number of repetitions of each test, +so that each should take approximately the same length of time to run across +servers of widely differing speeds. However, since each test must be run to +completion at least once, some slow servers may take a very long time, +particularly on the window moving and resizing tests, and on the arc drawing +tests. +.PP +All timing reports are for the smallest object involved. For example, the line +tests use a PolyLine request to paint several lines at once, but report how +many lines per second the server can paint, not how many PolyLine requests per +second. Text tests paint a line of characters, but report on the number of +characters per second. Some window tests map, unmap, or move a single parent +window, but report on how many children windows per second the server can map, +unmap, or move. +.PP +The current program is mostly the responsibility of Joel McCormack. It is +based upon the x11perf developed by Phil Karlton, Susan Angebranndt, Chris +Kent, Mary Walker, and Todd Newman, who wanted to assess performance differences between various servers. +Several tests were added in order to write and tune +the PMAX (DECStation 3100) servers. +For a general release to the world, +.I x11perf +was rewritten to ease making comparisons between widely varying +machines, to cover most important (and unimportant) X functionality, +and to exercise graphics operations in as many different +orientations and alignments as possible. +.SH OPTIONS +.I x11perf +is solely Xlib based, and +accepts the options listed below: +.TP 14 +.B \-display host:dpy +Specifies which display to use. +.TP 14 +.B \-sync +Runs the tests in synchronous mode. +Normally only useful for debugging +.I x11perf . +.TP 14 +.B \-pack +Runs rectangle tests so that they pack rectangles right next to each other. +This makes it easy to debug server code for stipples and tiles...if the +pattern looks ugly, you've got alignment problems. +.TP 14 +.B \-repeat \fI\fP +Repeats each test +.I n +times (by default each test is run 5 times). +.TP 14 +.B \-time \fI\fP +Specifies how long in seconds each test should be run (default 5 seconds). +.TP 14 +.B \-all +Runs all tests. This may take a while. +.TP 14 +.B \-range \fI\fP[,\fI\fP] +Runs all the tests starting from the specified name \fItest1\fP until +the name \fItest2\fP, including both the specified tests. The testnames +should be one of the options starting from -dot. (eg) -range line100 +will perform the tests from the 100 pixel line test, and go on till the +last test, -range line100,dline10 will do the tests from line100 to +dline10. +.TP 14 +.B \-labels +Generates just the descriptive labels for each test specified. See +.I x11perfcomp +for more details. +.TP 14 +.B \-fg \fIcolor-or-pixel\fP +Specifies the foreground color or pixel value to use. +.TP 14 +.B \-bg \fIcolor-or-pixel\fP +Specifies the background color or pixel value to use. +.TP 14 +.B \-clips \fIdefault\fP +Default number of clip windows. +.TP 14 +.B \-ddbg \fIcolor-or-pixel\fP +Specifies the color or pixel value to use for drawing +the odd segments of a DoubleDashed line or arc. +This will default to the bg color. +.TP 14 +.B \-rop +Use specified raster ops (default is GXcopy). +This option only affects graphics +benchmarks in which the graphics function is actually used. +.TP 14 +.B \-pm +Use specified planemasks (default is ~0). +This option only affects graphics +benchmarks in which the planemask is actually used. +.TP 14 +.B \-depth +Use a visual with planes per pixel (default is the default +visual). +.TP 14 +.B \-vclass +Use a visual with of class . can be StaticGray, GrayScale, +StaticColor, PseudoColor, TrueColor, or DirectColor. (default is the default +visual). +.TP 14 +.B \-reps +Specify the repetition count (Default is number that takes approx. 5 seconds) +.TP 14 +.B \-subs +Specify the number of sub windows to use in the Window tests. +Default is 4, 16, 25, 50, 75, 100 and 200. +.TP 14 +.B \-v1.2 +Perform only x11perf Version 1.2 tests using Version 1.2 semantics. +.TP 14 +.B \-v1.3 +Perform only x11perf Version 1.3 tests using Version 1.3 semantics. +.TP 14 +.B \-su +Set the save_under window attribute to True on all windows created by x11perf. +Default is False. +.TP 14 +.B \-bs +Set the backing_store window attribute to the given value on all windows +created by x11perf. can be WhenMapped or +Always. Default is NotUseful. +.TP 14 +.B \-dot +Dot. +.TP 14 +.B \-rect1 +1x1 solid-filled rectangle. +.TP 14 +.B \-rect10 +10x10 solid-filled rectangle. +.TP 14 +.B \-rect100 +100x100 solid-filled rectangle. +.TP 14 +.B \-rect500 +500x500 solid-filled rectangle. +.TP 14 +.B \-srect1 +1x1 transparent stippled rectangle, 8x8 stipple pattern. +.TP 14 +.B \-srect10 +10x10 transparent stippled rectangle, 8x8 stipple pattern. +.TP 14 +.B \-srect100 +100x100 transparent stippled rectangle, 8x8 stipple pattern. +.TP 14 +.B \-srect500 +500x500 transparent stippled rectangle, 8x8 stipple pattern. +.TP 14 +.B \-osrect1 +1x1 opaque stippled rectangle, 8x8 stipple pattern. +.TP 14 +.B \-osrect10 +10x10 opaque stippled rectangle, 8x8 stipple pattern. +.TP 14 +.B \-osrect100 +100x100 opaque stippled rectangle, 8x8 stipple pattern. +.TP 14 +.B \-osrect500 +500x500 opaque stippled rectangle, 8x8 stipple pattern. +.TP 14 +.B \-tilerect1 +1x1 tiled rectangle, 4x4 tile pattern. +.TP 14 +.B \-tilerect10 +10x10 tiled rectangle, 4x4 tile pattern. +.TP 14 +.B \-tilerect100 +100x100 tiled rectangle, 4x4 tile pattern. +.TP 14 +.B \-tilerect500 +500x500 tiled rectangle, 4x4 tile pattern. +.TP 14 +.B \-oddsrect1 +1x1 transparent stippled rectangle, 17x15 stipple pattern. +.TP 14 +.B \-oddsrect10 +10x10 transparent stippled rectangle, 17x15 stipple pattern. +.TP 14 +.B \-oddsrect100 +100x100 transparent stippled rectangle, 17x15 stipple pattern. +.TP 14 +.B \-oddsrect500 +500x500 transparent stippled rectangle, 17x15 stipple pattern. +.TP 14 +.B \-oddosrect1 +1x1 opaque stippled rectangle, 17x15 stipple pattern. +.TP 14 +.B \-oddosrect10 +10x10 opaque stippled rectangle, 17x15 stipple pattern. +.TP 14 +.B \-oddosrect100 +100x100 opaque stippled rectangle, 17x15 stipple pattern. +.TP 14 +.B \-oddosrect500 +500x500 opaque stippled rectangle, 17x15 stipple pattern. +.TP 14 +.B \-oddtilerect1 +1x1 tiled rectangle, 17x15 tile pattern. +.TP 14 +.B \-oddtilerect10 +10x10 tiled rectangle, 17x15 tile pattern. +.TP 14 +.B \-oddtilerect100 +100x100 tiled rectangle, 17x15 tile pattern. +.TP 14 +.B \-oddtilerect500 +500x500 tiled rectangle, 17x15 tile pattern. +.TP 14 +.B \-bigsrect1 +1x1 stippled rectangle, 161x145 stipple pattern. +.TP 14 +.B \-bigsrect10 +10x10 stippled rectangle, 161x145 stipple pattern. +.TP 14 +.B \-bigsrect100 +100x100 stippled rectangle, 161x145 stipple pattern. +.TP 14 +.B \-bigsrect500 +500x500 stippled rectangle, 161x145 stipple pattern. +.TP 14 +.B \-bigosrect1 +1x1 opaque stippled rectangle, 161x145 stipple pattern. +.TP 14 +.B \-bigosrect10 +10x10 opaque stippled rectangle, 161x145 stipple pattern. +.TP 14 +.B \-bigosrect100 +100x100 opaque stippled rectangle, 161x145 stipple pattern. +.TP 14 +.B \-bigosrect500 +500x500 opaque stippled rectangle, 161x145 stipple pattern. +.TP 14 +.B \-bigtilerect1 +1x1 tiled rectangle, 161x145 tile pattern. +.TP 14 +.B \-bigtilerect10 +10x10 tiled rectangle, 161x145 tile pattern. +.TP 14 +.B \-bigtilerect100 +100x100 tiled rectangle, 161x145 tile pattern. +.TP 14 +.B \-bigtilerect500 +500x500 tiled rectangle, 161x145 tile pattern. +.TP 14 +.B \-eschertilerect1 +1x1 tiled rectangle, 215x208 tile pattern. +.TP 14 +.B \-eschertilerect10 +10x10 tiled rectangle, 215x208 tile pattern. +.TP 14 +.B \-eschertilerect100 +100x100 tiled rectangle, 215x208 tile pattern. +.TP 14 +.B \-eschertilerect500 +500x500 tiled rectangle, 215x208 tile pattern. +.TP 14 +.B \-seg1 +1-pixel thin line segment. +.TP 14 +.B \-seg10 +10-pixel thin line segment. +.TP 14 +.B \-seg100 +100-pixel thin line segment. +.TP 14 +.B \-seg500 +500-pixel thin line segment. +.TP 14 +.B \-seg100c1 +100-pixel thin line segment (1 obscuring rectangle). +.TP 14 +.B \-seg100c2 +100-pixel thin line segment (2 obscuring rectangles). +.TP 14 +.B \-seg100c3 +100-pixel thin line segment (3 obscuring rectangles). +.TP 14 +.B \-dseg10 +10-pixel thin dashed segment (3 on, 2 off). +.TP 14 +.B \-dseg100 +100-pixel thin dashed segment (3 on, 2 off). +.TP 14 +.B \-ddseg100 +100-pixel thin double-dashed segment (3 fg, 2 bg). +.TP 14 +.B \-hseg10 +10-pixel thin horizontal line segment. +.TP 14 +.B \-hseg100 +100-pixel thin horizontal line segment. +.TP 14 +.B \-hseg500 +500-pixel thin horizontal line segment. +.TP 14 +.B \-vseg10 +10-pixel thin vertical line segment. +.TP 14 +.B \-vseg100 +100-pixel thin vertical line segment. +.TP 14 +.B \-vseg500 +500-pixel thin vertical line segment. +.TP 14 +.B \-whseg10 +10-pixel wide horizontal line segment. +.TP 14 +.B \-whseg100 +100-pixel wide horizontal line segment. +.TP 14 +.B \-whseg500 +500-pixel wide horizontal line segment. +.TP 14 +.B \-wvseg10 +10-pixel wide vertical line segment. +.TP 14 +.B \-wvseg100 +100-pixel wide vertical line segment. +.TP 14 +.B \-wvseg500 +500-pixel wide vertical line segment. +.TP 14 +.B \-line1 +1-pixel thin (width 0) line. +.TP 14 +.B \-line10 +10-pixel thin line. +.TP 14 +.B \-line100 +100-pixel thin line. +.TP 14 +.B \-line500 +500-pixel thin line. +.TP 14 +.B \-dline10 +10-pixel thin dashed line (3 on, 2 off). +.TP 14 +.B \-dline100 +100-pixel thin dashed line (3 on, 2 off). +.TP 14 +.B \-ddline100 +100-pixel thin double-dashed line (3 fg, 2 bg). +.TP 14 +.B \-wline10 +10-pixel line, line width 1. +.TP 14 +.B \-wline100 +100-pixel line, line width 10. +.TP 14 +.B \-wline500 +500-pixel line, line width 50. +.TP 14 +.B \-wdline100 +100-pixel dashed line, line width 10 (30 on, 20 off). +.TP 14 +.B \-wddline100 +100-pixel double-dashed line, line width 10 (30 fg, 20 bg). +.TP 14 +.B \-orect10 +10x10 thin rectangle outline. +.TP 14 +.B \-orect100 +100-pixel thin vertical line segment. +.TP 14 +.B \-orect500 +500-pixel thin vertical line segment. +.TP 14 +.B \-worect10 +10x10 wide rectangle outline. +.TP 14 +.B \-worect100 +100-pixel wide vertical line segment. +.TP 14 +.B \-worect500 +500-pixel wide vertical line segment. +.TP 14 +.B \-circle1 +1-pixel diameter thin (line width 0) circle. +.TP 14 +.B \-circle10 +10-pixel diameter thin circle. +.TP 14 +.B \-circle100 +100-pixel diameter thin circle. +.TP 14 +.B \-circle500 +500-pixel diameter thin circle. +.TP 14 +.B \-dcircle100 +100-pixel diameter thin dashed circle (3 on, 2 off). +.TP 14 +.B \-ddcircle100 +100-pixel diameter thin double-dashed circle (3 fg, 2 bg). +.TP 14 +.B \-wcircle10 +10-pixel diameter circle, line width 1. +.TP 14 +.B \-wcircle100 +100-pixel diameter circle, line width 10. +.TP 14 +.B \-wcircle500 +500-pixel diameter circle, line width 50. +.TP 14 +.B \-wdcircle100 +100-pixel diameter dashed circle, line width 10 (30 on, 20 off). +.TP 14 +.B \-wddcircle100 +100-pixel diameter double-dashed circle, line width 10 (30 fg, 20 bg). +.TP 14 +.B \-pcircle10 +10-pixel diameter thin partial circle, +orientation and arc angle evenly distributed. +.TP 14 +.B \-pcircle100 +100-pixel diameter thin partial circle. +.TP 14 +.B \-wpcircle10 +10-pixel diameter wide partial circle. +.TP 14 +.B \-wpcircle100 +100-pixel diameter wide partial circle. +.TP 14 +.B \-fcircle1 +1-pixel diameter filled circle. +.TP 14 +.B \-fcircle10 +10-pixel diameter filled circle. +.TP 14 +.B \-fcircle100 +100-pixel diameter filled circle. +.TP 14 +.B \-fcircle500 +500-pixel diameter filled circle. +.TP 14 +.B \-fcpcircle10 +10-pixel diameter partial filled circle, chord fill, +orientation and arc angle evenly distributed. +.TP 14 +.B \-fcpcircle100 +100-pixel diameter partial filled circle, chord fill. +.TP 14 +.B \-fspcircle10 +10-pixel diameter partial filled circle, pie slice fill, +orientation and arc angle evenly distributed. +.TP 14 +.B \-fspcircle100 +100-pixel diameter partial filled circle, pie slice fill. +.TP 14 +.B \-ellipse10 +10-pixel diameter thin (line width 0) ellipse, major and +minor axis sizes evenly distributed. +.TP 14 +.B \-ellipse100 +100-pixel diameter thin ellipse. +.TP 14 +.B \-ellipse500 +500-pixel diameter thin ellipse. +.TP 14 +.B \-dellipse100 +100-pixel diameter thin dashed ellipse (3 on, 2 off). +.TP 14 +.B \-ddellipse100 +100-pixel diameter thin double-dashed ellipse (3 fg, 2 bg). +.TP 14 +.B \-wellipse10 +10-pixel diameter ellipse, line width 1. +.TP 14 +.B \-wellipse100 +100-pixel diameter ellipse, line width 10. +.TP 14 +.B \-wellipse500 +500-pixel diameter ellipse, line width 50. +.TP 14 +.B \-wdellipse100 +100-pixel diameter dashed ellipse, line width 10 (30 on, 20 off). +.TP 14 +.B \-wddellipse100 +100-pixel diameter double-dashed ellipse, line width 10 (30 fg, 20 bg). +.TP 14 +.B \-pellipse10 +10-pixel diameter thin partial ellipse. +.TP 14 +.B \-pellipse100 +100-pixel diameter thin partial ellipse. +.TP 14 +.B \-wpellipse10 +10-pixel diameter wide partial ellipse. +.TP 14 +.B \-wpellipse100 +100-pixel diameter wide partial ellipse. +.TP 14 +.B \-fellipse10 +10-pixel diameter filled ellipse. +.TP 14 +.B \-fellipse100 +100-pixel diameter filled ellipse. +.TP 14 +.B \-fellipse500 +500-pixel diameter filled ellipse. +.TP 14 +.B \-fcpellipse10 +10-pixel diameter partial filled ellipse, chord fill. +.TP 14 +.B \-fcpellipse100 +100-pixel diameter partial filled ellipse, chord fill. +.TP 14 +.B \-fspellipse10 +10-pixel diameter partial filled ellipse, pie slice fill. +.TP 14 +.B \-fspellipse100 +100-pixel diameter partial filled ellipse, pie slice fill. +.TP 14 +.B \-triangle1 +Fill 1-pixel/side triangle. +.TP 14 +.B \-triangle10 +Fill 10-pixel/side triangle. +.TP 14 +.B \-triangle100 +Fill 100-pixel/side triangle. +.TP 14 +.B \-trap1 +Fill 1x1 trapezoid. +.TP 14 +.B \-trap10 +Fill 10x10 trapezoid. +.TP 14 +.B \-trap100 +Fill 100x100 trapezoid. +.TP 14 +.B \-trap300 +Fill 300x300 trapezoid. +.TP 14 +.B \-strap1 +Fill 1x1 transparent stippled trapezoid, 8x8 stipple pattern. +.TP 14 +.B \-strap10 +Fill 10x10 transparent stippled trapezoid, 8x8 stipple pattern. +.TP 14 +.B \-strap100 +Fill 100x100 transparent stippled trapezoid, 8x8 stipple pattern. +.TP 14 +.B \-strap300 +Fill 300x300 transparent stippled trapezoid, 8x8 stipple pattern. +.TP 14 +.B \-ostrap1 +Fill 10x10 opaque stippled trapezoid, 8x8 stipple pattern. +.TP 14 +.B \-ostrap10 +Fill 10x10 opaque stippled trapezoid, 8x8 stipple pattern. +.TP 14 +.B \-ostrap100 +Fill 100x100 opaque stippled trapezoid, 8x8 stipple pattern. +.TP 14 +.B \-ostrap300 +Fill 300x300 opaque stippled trapezoid, 8x8 stipple pattern. +.TP 14 +.B \-tiletrap1 +Fill 10x10 tiled trapezoid, 4x4 tile pattern. +.TP 14 +.B \-tiletrap10 +Fill 10x10 tiled trapezoid, 4x4 tile pattern. +.TP 14 +.B \-tiletrap100 +Fill 100x100 tiled trapezoid, 4x4 tile pattern. +.TP 14 +.B \-tiletrap300 +Fill 300x300 tiled trapezoid, 4x4 tile pattern. +.TP 14 +.B \-oddstrap1 +Fill 1x1 transparent stippled trapezoid, 17x15 stipple pattern. +.TP 14 +.B \-oddstrap10 +Fill 10x10 transparent stippled trapezoid, 17x15 stipple pattern. +.TP 14 +.B \-oddstrap100 +Fill 100x100 transparent stippled trapezoid, 17x15 stipple pattern. +.TP 14 +.B \-oddstrap300 +Fill 300x300 transparent stippled trapezoid, 17x15 stipple pattern. +.TP 14 +.B \-oddostrap1 +Fill 10x10 opaque stippled trapezoid, 17x15 stipple pattern. +.TP 14 +.B \-oddostrap10 +Fill 10x10 opaque stippled trapezoid, 17x15 stipple pattern. +.TP 14 +.B \-oddostrap100 +Fill 100x100 opaque stippled trapezoid, 17x15 stipple pattern. +.TP 14 +.B \-oddostrap300 +Fill 300x300 opaque stippled trapezoid, 17x15 stipple pattern. +.TP 14 +.B \-oddtiletrap1 +Fill 10x10 tiled trapezoid, 17x15 tile pattern. +.TP 14 +.B \-oddtiletrap10 +Fill 10x10 tiled trapezoid, 17x15 tile pattern. +.TP 14 +.B \-oddtiletrap100 +Fill 100x100 tiled trapezoid, 17x15 tile pattern. +.TP 14 +.B \-oddtiletrap300 +Fill 300x300 tiled trapezoid, 17x15 tile pattern. +.TP 14 +.B \-bigstrap1 +Fill 1x1 transparent stippled trapezoid, 161x145 stipple pattern. +.TP 14 +.B \-bigstrap10 +Fill 10x10 transparent stippled trapezoid, 161x145 stipple pattern. +.TP 14 +.B \-bigstrap100 +Fill 100x100 transparent stippled trapezoid, 161x145 stipple pattern. +.TP 14 +.B \-bigstrap300 +Fill 300x300 transparent stippled trapezoid, 161x145 stipple pattern. +.TP 14 +.B \-bigostrap1 +Fill 10x10 opaque stippled trapezoid, 161x145 stipple pattern. +.TP 14 +.B \-bigostrap10 +Fill 10x10 opaque stippled trapezoid, 161x145 stipple pattern. +.TP 14 +.B \-bigostrap100 +Fill 100x100 opaque stippled trapezoid, 161x145 stipple pattern. +.TP 14 +.B \-bigostrap300 +Fill 300x300 opaque stippled trapezoid, 161x145 stipple pattern. +.TP 14 +.B \-bigtiletrap1 +Fill 10x10 tiled trapezoid, 161x145 tile pattern. +.TP 14 +.B \-bigtiletrap10 +Fill 10x10 tiled trapezoid, 161x145 tile pattern. +.TP 14 +.B \-bigtiletrap100 +Fill 100x100 tiled trapezoid, 161x145 tile pattern. +.TP 14 +.B \-bigtiletrap300 +Fill 300x300 tiled trapezoid, 161x145 tile pattern. +.TP 14 +.B \-eschertiletrap1 +Fill 1x1 tiled trapezoid, 216x208 tile pattern. +.TP 14 +.B \-eschertiletrap10 +Fill 10x10 tiled trapezoid, 216x208 tile pattern. +.TP 14 +.B \-eschertiletrap100 +Fill 100x100 tiled trapezoid, 216x208 tile pattern. +.TP 14 +.B \-eschertiletrap300 +Fill 300x300 tiled trapezoid, 216x208 tile pattern. +.TP 14 +.B \-complex10 +Fill 10-pixel/side complex polygon. +.TP 14 +.B \-complex100 +Fill 100-pixel/side complex polygon. +.TP 14 +.B \-64poly10convex +Fill 10x10 convex 64-gon. +.TP 14 +.B \-64poly100convex +Fill 100x100 convex 64-gon. +.TP 14 +.B \-64poly10complex +Fill 10x10 complex 64-gon. +.TP 14 +.B \-64poly100complex +Fill 100x100 complex 64-gon. +.TP 14 +.B \-ftext +Character in 80-char line (6x13). +.TP 14 +.B \-f8text +Character in 70-char line (8x13). +.TP 14 +.B \-f9text +Character in 60-char line (9x15). +.TP 14 +.B \-f14text16 +2-byte character in 40-char line (k14). +.TP 14 +.B \-tr10text +Character in 80-char line (Times-Roman 10). +.TP 14 +.B \-tr24text +Character in 30-char line (Times-Roman 24). +.TP 14 +.B \-polytext +Character in 20/40/20 line (6x13, Times-Roman 10, 6x13). +.TP 14 +.B \-polytext16 +2-byte character in 7/14/7 line (k14, k24). +.TP 14 +.B \-fitext +Character in 80-char image line (6x13). +.TP 14 +.B \-f8itext +Character in 70-char image line (8x13). +.TP 14 +.B \-f9itext +Character in 60-char image line (9x15). +.TP 14 +.B \-f14itext16 +2-byte character in 40-char image line (k14). +.TP 14 +.B \-f24itext16 +2-byte character in 23-char image line (k24). +.TP 14 +.B \-tr10itext +Character in 80-char image line (Times-Roman 10). +.TP 14 +.B \-tr24itext +Character in 30-char image line (Times-Roman 24). +.TP 14 +.B \-scroll10 +Scroll 10x10 pixels vertically. +.TP 14 +.B \-scroll100 +Scroll 100x100 pixels vertically. +.TP 14 +.B \-scroll500 +Scroll 500x500 pixels vertically. +.TP 14 +.B \-copywinwin10 +Copy 10x10 square from window to window. +.TP 14 +.B \-copywinwin100 +Copy 100x100 square from window to window. +.TP 14 +.B \-copywinwin500 +Copy 500x500 square from window to window. +.TP 14 +.B \-copypixwin10 +Copy 10x10 square from pixmap to window. +.TP 14 +.B \-copypixwin100 +Copy 100x100 square from pixmap to window. +.TP 14 +.B \-copypixwin500 +Copy 500x500 square from pixmap to window. +.TP 14 +.B \-copywinpix10 +Copy 10x10 square from window to pixmap. +.TP 14 +.B \-copywinpix100 +Copy 100x100 square from window to pixmap. +.TP 14 +.B \-copywinpix500 +Copy 500x500 square from window to pixmap. +.TP 14 +.B \-copypixpix10 +Copy 10x10 square from pixmap to pixmap. +.TP 14 +.B \-copypixpix100 +Copy 100x100 square from pixmap to pixmap. +.TP 14 +.B \-copypixpix500 +Copy 500x500 square from pixmap to pixmap. +.TP 14 +.B \-copyplane10 +Copy 10x10 1-bit deep plane. +.TP 14 +.B \-copyplane100 +Copy 100x100 1-bit deep plane. +.TP 14 +.B \-copyplane500 +Copy 500x500 1-bit deep plane. +.TP 14 +.B \-putimage10 +PutImage 10x10 square. +.TP 14 +.B \-putimage100 +PutImage 100x100 square. +.TP 14 +.B \-putimage500 +PutImage 500x500 square. +.TP 14 +.B \-putimagexy10 +PutImage XY format 10x10 square. +.TP 14 +.B \-putimagexy100 +PutImage XY format 100x100 square. +.TP 14 +.B \-putimagexy500 +PutImage XY format 500x500 square. +.TP 14 +.B \-shmput10 +PutImage 10x10 square, MIT shared memory extension. +.TP 14 +.B \-shmput100 +PutImage 100x100 square, MIT shared memory extension. +.TP 14 +.B \-shmput500 +PutImage 500x500 square, MIT shared memory extension. +.TP 14 +.B \-shmputxy10 +PutImage XY format 10x10 square, MIT shared memory extension. +.TP 14 +.B \-shmputxy100 +PutImage XY format 100x100 square, MIT shared memory extension. +.TP 14 +.B \-shmputxy500 +PutImage XY format 500x500 square, MIT shared memory extension. +.TP 14 +.B \-getimage10 +GetImage 10x10 square. +.TP 14 +.B \-getimage100 +GetImage 100x100 square. +.TP 14 +.B \-getimage500 +GetImage 500x500 square. +.TP 14 +.B \-getimagexy10 +GetImage XY format 10x10 square. +.TP 14 +.B \-getimagexy100 +GetImage XY format 100x100 square. +.TP 14 +.B \-getimagexy500 +GetImage XY format 500x500 square. +.TP 14 +.B \-noop +X protocol NoOperation. +.TP 14 +.B \-atom +GetAtomName. +.TP 14 +.B \-pointer +QueryPointer. +.TP 14 +.B \-prop +GetProperty. +.TP 14 +.B \-gc +Change graphics context. +.TP 14 +.B \-create +Create child window and map using MapSubwindows. +.TP 14 +.B \-ucreate +Create unmapped window. +.TP 14 +.B \-map +Map child window via MapWindow on parent. +.TP 14 +.B \-unmap +Unmap child window via UnmapWindow on parent. +.TP 14 +.B \-destroy +Destroy child window via DestroyWindow parent. +.TP 14 +.B \-popup +Hide/expose window via Map/Unmap popup window. +.TP 14 +.B \-move +Move window. +.TP 14 +.B \-umove +Moved unmapped window. +.TP 14 +.B \-movetree +Move window via MoveWindow on parent. +.TP 14 +.B \-resize +Resize window. +.TP 14 +.B \-uresize +Resize unmapped window. +.TP 14 +.B \-circulate +Circulate lowest window to top. +.TP 14 +.B \-ucirculate +Circulate unmapped window to top. +.SH X DEFAULTS +There are no X defaults used by this program. +.SH "SEE ALSO" +X(__miscmansuffix__), x11perfcomp(__appmansuffix__) +.SH AUTHORS +Joel McCormack +.br +Phil Karlton +.br +Susan Angebranndt +.br +Chris Kent +.br +Keith Packard +.br +Graeme Gill diff --git a/man/x11perfcomp.man b/man/x11perfcomp.man new file mode 100644 index 0000000..4f567d2 --- /dev/null +++ b/man/x11perfcomp.man @@ -0,0 +1,80 @@ +.\" Copyright 1993, 1994, 1998 The Open Group +.\" +.\" Permission to use, copy, modify, distribute, and sell this software and its +.\" documentation for any purpose is hereby granted without fee, provided that +.\" the above copyright notice appear in all copies and that both that +.\" copyright notice and this permission notice appear in supporting +.\" documentation. +.\" +.\" The above copyright notice and this permission notice shall be included +.\" in all copies or substantial portions of the Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR +.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +.\" OTHER DEALINGS IN THE SOFTWARE. +.\" +.\" Except as contained in this notice, the name of The Open Group shall +.\" not be used in advertising or otherwise to promote the sale, use or +.\" other dealings in this Software without prior written authorization +.\" from The Open Group. +.\" +.\" +.TH X11PERFCOMP 1 __xorgversion__ +.SH NAME +x11perfcomp \- X11 server performance comparison program +.SH SYNTAX +.B x11perfcomp +[ \-r | \-ro ] [ \-l label_file ] files +.SH DESCRIPTION +The +.I x11perfcomp +program merges the output of several +.I x11perf(__appmansuffix__) +runs into a nice tabular +format. It takes the results in each file, fills in any missing test results if +necessary, and for each test shows the objects/second rate of each server. +If invoked with the -r or -ro options, it shows the relative performance +of each server to the first server. +.PP +Normally, +.I x11perfcomp +uses the first file specified to determine which specific tests it should +report on. Some (non-DEC :) servers may fail to perform +all tests. In this case, +.I x11perfcomp +automatically substitutes in a rate of 0.0 objects/second. +Since the first file +determines which tests to report on, this file must contain a superset of +the tests reported in the other files, else +.I x11perfcomp +will fail. +.PP +You can provide an explicit list of tests to report on +by using the -l switch to specify a file of labels. You can create a label +file by using the -label option in +.I x11perf. +.SH OPTIONS +.I x11perfcomp +accepts the options listed below: +.TP 16 +.B \-r +Specifies that the output should also include relative server +performance. +.TP 16 +.B \-ro +Specifies that the output should include only relative server performance. +.TP 16 +.B \-l label_file +Specifies a label file to use. +.SH X DEFAULTS +There are no X defaults used by this program. +.SH "SEE ALSO" +X(__miscmansuffix__), x11perf(__appmansuffix__) +.SH AUTHORS +Mark Moraes wrote the original scripts to compare servers. +.br +Joel McCormack just munged them together a bit. diff --git a/x11perf.man b/x11perf.man deleted file mode 100644 index 1fcbf20..0000000 --- a/x11perf.man +++ /dev/null @@ -1,1016 +0,0 @@ -.\" Copyright 1988, 1989 Digital Equipment Corporation. -.\" Copyright 1989, 1994, 1998 The Open Group -.\" -.\" Permission to use, copy, modify, distribute, and sell this software and its -.\" documentation for any purpose is hereby granted without fee, provided that -.\" the above copyright notice appear in all copies and that both that -.\" copyright notice and this permission notice appear in supporting -.\" documentation. -.\" -.\" The above copyright notice and this permission notice shall be included -.\" in all copies or substantial portions of the Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS -.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. -.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR -.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, -.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -.\" OTHER DEALINGS IN THE SOFTWARE. -.\" -.\" Except as contained in this notice, the name of The Open Group shall -.\" not be used in advertising or otherwise to promote the sale, use or -.\" other dealings in this Software without prior written authorization -.\" from The Open Group. -.\" -.\" -.TH X11PERF 1 __xorgversion__ -.SH NAME -x11perf \- X11 server performance test program -.SH SYNTAX -.B x11perf -[ \-option ... ] -.SH DESCRIPTION -The -.I x11perf -program runs one or more performance tests and reports how fast an X server can -execute the tests. -.PP -Many graphics benchmarks assume that the graphics device is used to display the -output of a single fancy graphics application, and that the user gets his work -done on some other device, like a terminal. Such benchmarks usually measure -drawing speed for lines, polygons, text, etc. -.PP -Since workstations are not used as standalone graphics engines, but as -super-terminals, -.I x11perf -measures window management performance as well as -traditional graphics performance. -.I x11perf -includes benchmarks for the time it -takes to create and map windows (as when you start up an application); to map a -pre-existing set of windows onto the screen (as when you deiconify an -application or pop up a menu); and to rearrange windows (as when you slosh -windows to and fro trying to find the one you want). -.PP -.I x11perf -also measures graphics performance for operations not normally used in -standalone graphics displays, but are nonetheless used frequently by X -applications. Such operations include CopyPlane (used to map bitmaps into -pixels), scrolling (used in text windows), and various stipples and tiles -(used for CAD and color half-toning, respectively). -.PP -.I x11perf -should be used to analyze particular strengths and weaknesses -of servers, and is most useful to a server writer who wants to -analyze and improve a server. -.I x11perf -is meant to comprehensively exercise just about every X11 operation you can -perform; it does not purport to be a representative sample of the -operations that X11 applications actually use. -While it can be used as a benchmark, it was written and is intended as -a performance testing tool. -.PP -As such, -.I x11perf -DOES NOT whittle down measurements to a single ``HeXStones'' -or ``MeXops'' number. We consider such numbers to be uninformative -at best and misleading at worst. -Some servers which are very fast for certain applications can be -very slow for others. -No single number or small set of numbers are sufficient to -characterize how an X implementation will perform on all applications. -However, by knowledge of your favorite application, you -may be able to use the numbers -.I x11perf -reports to predict its performance on a given X implementation. -.PP -That said, you might also want to look at -.I x11perfcomp(__appmansuffix__), -a program to compare the outputs of different -.I x11perf -runs. You provide a list of files containing results from -.I x11perf, -and it lays them out in a nice tabular format. -.PP -For repeatable results, -.I x11perf -should be run using a local connection on a -freshly-started server. The default configuration runs each test 5 times, in -order to see if each trial takes approximately the same amount of time. -Strange glitches should be examined; if non-repeatable one might -chalk them up to -daemons and network traffic. Each trial is run for 5 seconds, in order to -reduce random time differences. The number of objects processed per second is -displayed to 3 significant digits, but you'll be lucky on most UNIX system if -the numbers are actually consistent to 2 digits. -.I x11perf -moves the cursor out of the test window; you should be careful not -to bump the mouse and move it back into the window. -(A prize to people who correctly explain why!!). -.PP -Before running a test, -.I x11perf -determines what the round trip time to the server is, and factors this out of -the final timing reported. It ensures that the server has actually performed -the work requested by fetching a pixel back from the test window, which means -that servers talking to graphics accelerators can't claim that they are done, -while in the meantime the accelerator is painting madly. -.PP -By default -.I x11perf -automatically calibrates the number of repetitions of each test, -so that each should take approximately the same length of time to run across -servers of widely differing speeds. However, since each test must be run to -completion at least once, some slow servers may take a very long time, -particularly on the window moving and resizing tests, and on the arc drawing -tests. -.PP -All timing reports are for the smallest object involved. For example, the line -tests use a PolyLine request to paint several lines at once, but report how -many lines per second the server can paint, not how many PolyLine requests per -second. Text tests paint a line of characters, but report on the number of -characters per second. Some window tests map, unmap, or move a single parent -window, but report on how many children windows per second the server can map, -unmap, or move. -.PP -The current program is mostly the responsibility of Joel McCormack. It is -based upon the x11perf developed by Phil Karlton, Susan Angebranndt, Chris -Kent, Mary Walker, and Todd Newman, who wanted to assess performance differences between various servers. -Several tests were added in order to write and tune -the PMAX (DECStation 3100) servers. -For a general release to the world, -.I x11perf -was rewritten to ease making comparisons between widely varying -machines, to cover most important (and unimportant) X functionality, -and to exercise graphics operations in as many different -orientations and alignments as possible. -.SH OPTIONS -.I x11perf -is solely Xlib based, and -accepts the options listed below: -.TP 14 -.B \-display host:dpy -Specifies which display to use. -.TP 14 -.B \-sync -Runs the tests in synchronous mode. -Normally only useful for debugging -.I x11perf . -.TP 14 -.B \-pack -Runs rectangle tests so that they pack rectangles right next to each other. -This makes it easy to debug server code for stipples and tiles...if the -pattern looks ugly, you've got alignment problems. -.TP 14 -.B \-repeat \fI\fP -Repeats each test -.I n -times (by default each test is run 5 times). -.TP 14 -.B \-time \fI\fP -Specifies how long in seconds each test should be run (default 5 seconds). -.TP 14 -.B \-all -Runs all tests. This may take a while. -.TP 14 -.B \-range \fI\fP[,\fI\fP] -Runs all the tests starting from the specified name \fItest1\fP until -the name \fItest2\fP, including both the specified tests. The testnames -should be one of the options starting from -dot. (eg) -range line100 -will perform the tests from the 100 pixel line test, and go on till the -last test, -range line100,dline10 will do the tests from line100 to -dline10. -.TP 14 -.B \-labels -Generates just the descriptive labels for each test specified. See -.I x11perfcomp -for more details. -.TP 14 -.B \-fg \fIcolor-or-pixel\fP -Specifies the foreground color or pixel value to use. -.TP 14 -.B \-bg \fIcolor-or-pixel\fP -Specifies the background color or pixel value to use. -.TP 14 -.B \-clips \fIdefault\fP -Default number of clip windows. -.TP 14 -.B \-ddbg \fIcolor-or-pixel\fP -Specifies the color or pixel value to use for drawing -the odd segments of a DoubleDashed line or arc. -This will default to the bg color. -.TP 14 -.B \-rop -Use specified raster ops (default is GXcopy). -This option only affects graphics -benchmarks in which the graphics function is actually used. -.TP 14 -.B \-pm -Use specified planemasks (default is ~0). -This option only affects graphics -benchmarks in which the planemask is actually used. -.TP 14 -.B \-depth -Use a visual with planes per pixel (default is the default -visual). -.TP 14 -.B \-vclass -Use a visual with of class . can be StaticGray, GrayScale, -StaticColor, PseudoColor, TrueColor, or DirectColor. (default is the default -visual). -.TP 14 -.B \-reps -Specify the repetition count (Default is number that takes approx. 5 seconds) -.TP 14 -.B \-subs -Specify the number of sub windows to use in the Window tests. -Default is 4, 16, 25, 50, 75, 100 and 200. -.TP 14 -.B \-v1.2 -Perform only x11perf Version 1.2 tests using Version 1.2 semantics. -.TP 14 -.B \-v1.3 -Perform only x11perf Version 1.3 tests using Version 1.3 semantics. -.TP 14 -.B \-su -Set the save_under window attribute to True on all windows created by x11perf. -Default is False. -.TP 14 -.B \-bs -Set the backing_store window attribute to the given value on all windows -created by x11perf. can be WhenMapped or -Always. Default is NotUseful. -.TP 14 -.B \-dot -Dot. -.TP 14 -.B \-rect1 -1x1 solid-filled rectangle. -.TP 14 -.B \-rect10 -10x10 solid-filled rectangle. -.TP 14 -.B \-rect100 -100x100 solid-filled rectangle. -.TP 14 -.B \-rect500 -500x500 solid-filled rectangle. -.TP 14 -.B \-srect1 -1x1 transparent stippled rectangle, 8x8 stipple pattern. -.TP 14 -.B \-srect10 -10x10 transparent stippled rectangle, 8x8 stipple pattern. -.TP 14 -.B \-srect100 -100x100 transparent stippled rectangle, 8x8 stipple pattern. -.TP 14 -.B \-srect500 -500x500 transparent stippled rectangle, 8x8 stipple pattern. -.TP 14 -.B \-osrect1 -1x1 opaque stippled rectangle, 8x8 stipple pattern. -.TP 14 -.B \-osrect10 -10x10 opaque stippled rectangle, 8x8 stipple pattern. -.TP 14 -.B \-osrect100 -100x100 opaque stippled rectangle, 8x8 stipple pattern. -.TP 14 -.B \-osrect500 -500x500 opaque stippled rectangle, 8x8 stipple pattern. -.TP 14 -.B \-tilerect1 -1x1 tiled rectangle, 4x4 tile pattern. -.TP 14 -.B \-tilerect10 -10x10 tiled rectangle, 4x4 tile pattern. -.TP 14 -.B \-tilerect100 -100x100 tiled rectangle, 4x4 tile pattern. -.TP 14 -.B \-tilerect500 -500x500 tiled rectangle, 4x4 tile pattern. -.TP 14 -.B \-oddsrect1 -1x1 transparent stippled rectangle, 17x15 stipple pattern. -.TP 14 -.B \-oddsrect10 -10x10 transparent stippled rectangle, 17x15 stipple pattern. -.TP 14 -.B \-oddsrect100 -100x100 transparent stippled rectangle, 17x15 stipple pattern. -.TP 14 -.B \-oddsrect500 -500x500 transparent stippled rectangle, 17x15 stipple pattern. -.TP 14 -.B \-oddosrect1 -1x1 opaque stippled rectangle, 17x15 stipple pattern. -.TP 14 -.B \-oddosrect10 -10x10 opaque stippled rectangle, 17x15 stipple pattern. -.TP 14 -.B \-oddosrect100 -100x100 opaque stippled rectangle, 17x15 stipple pattern. -.TP 14 -.B \-oddosrect500 -500x500 opaque stippled rectangle, 17x15 stipple pattern. -.TP 14 -.B \-oddtilerect1 -1x1 tiled rectangle, 17x15 tile pattern. -.TP 14 -.B \-oddtilerect10 -10x10 tiled rectangle, 17x15 tile pattern. -.TP 14 -.B \-oddtilerect100 -100x100 tiled rectangle, 17x15 tile pattern. -.TP 14 -.B \-oddtilerect500 -500x500 tiled rectangle, 17x15 tile pattern. -.TP 14 -.B \-bigsrect1 -1x1 stippled rectangle, 161x145 stipple pattern. -.TP 14 -.B \-bigsrect10 -10x10 stippled rectangle, 161x145 stipple pattern. -.TP 14 -.B \-bigsrect100 -100x100 stippled rectangle, 161x145 stipple pattern. -.TP 14 -.B \-bigsrect500 -500x500 stippled rectangle, 161x145 stipple pattern. -.TP 14 -.B \-bigosrect1 -1x1 opaque stippled rectangle, 161x145 stipple pattern. -.TP 14 -.B \-bigosrect10 -10x10 opaque stippled rectangle, 161x145 stipple pattern. -.TP 14 -.B \-bigosrect100 -100x100 opaque stippled rectangle, 161x145 stipple pattern. -.TP 14 -.B \-bigosrect500 -500x500 opaque stippled rectangle, 161x145 stipple pattern. -.TP 14 -.B \-bigtilerect1 -1x1 tiled rectangle, 161x145 tile pattern. -.TP 14 -.B \-bigtilerect10 -10x10 tiled rectangle, 161x145 tile pattern. -.TP 14 -.B \-bigtilerect100 -100x100 tiled rectangle, 161x145 tile pattern. -.TP 14 -.B \-bigtilerect500 -500x500 tiled rectangle, 161x145 tile pattern. -.TP 14 -.B \-eschertilerect1 -1x1 tiled rectangle, 215x208 tile pattern. -.TP 14 -.B \-eschertilerect10 -10x10 tiled rectangle, 215x208 tile pattern. -.TP 14 -.B \-eschertilerect100 -100x100 tiled rectangle, 215x208 tile pattern. -.TP 14 -.B \-eschertilerect500 -500x500 tiled rectangle, 215x208 tile pattern. -.TP 14 -.B \-seg1 -1-pixel thin line segment. -.TP 14 -.B \-seg10 -10-pixel thin line segment. -.TP 14 -.B \-seg100 -100-pixel thin line segment. -.TP 14 -.B \-seg500 -500-pixel thin line segment. -.TP 14 -.B \-seg100c1 -100-pixel thin line segment (1 obscuring rectangle). -.TP 14 -.B \-seg100c2 -100-pixel thin line segment (2 obscuring rectangles). -.TP 14 -.B \-seg100c3 -100-pixel thin line segment (3 obscuring rectangles). -.TP 14 -.B \-dseg10 -10-pixel thin dashed segment (3 on, 2 off). -.TP 14 -.B \-dseg100 -100-pixel thin dashed segment (3 on, 2 off). -.TP 14 -.B \-ddseg100 -100-pixel thin double-dashed segment (3 fg, 2 bg). -.TP 14 -.B \-hseg10 -10-pixel thin horizontal line segment. -.TP 14 -.B \-hseg100 -100-pixel thin horizontal line segment. -.TP 14 -.B \-hseg500 -500-pixel thin horizontal line segment. -.TP 14 -.B \-vseg10 -10-pixel thin vertical line segment. -.TP 14 -.B \-vseg100 -100-pixel thin vertical line segment. -.TP 14 -.B \-vseg500 -500-pixel thin vertical line segment. -.TP 14 -.B \-whseg10 -10-pixel wide horizontal line segment. -.TP 14 -.B \-whseg100 -100-pixel wide horizontal line segment. -.TP 14 -.B \-whseg500 -500-pixel wide horizontal line segment. -.TP 14 -.B \-wvseg10 -10-pixel wide vertical line segment. -.TP 14 -.B \-wvseg100 -100-pixel wide vertical line segment. -.TP 14 -.B \-wvseg500 -500-pixel wide vertical line segment. -.TP 14 -.B \-line1 -1-pixel thin (width 0) line. -.TP 14 -.B \-line10 -10-pixel thin line. -.TP 14 -.B \-line100 -100-pixel thin line. -.TP 14 -.B \-line500 -500-pixel thin line. -.TP 14 -.B \-dline10 -10-pixel thin dashed line (3 on, 2 off). -.TP 14 -.B \-dline100 -100-pixel thin dashed line (3 on, 2 off). -.TP 14 -.B \-ddline100 -100-pixel thin double-dashed line (3 fg, 2 bg). -.TP 14 -.B \-wline10 -10-pixel line, line width 1. -.TP 14 -.B \-wline100 -100-pixel line, line width 10. -.TP 14 -.B \-wline500 -500-pixel line, line width 50. -.TP 14 -.B \-wdline100 -100-pixel dashed line, line width 10 (30 on, 20 off). -.TP 14 -.B \-wddline100 -100-pixel double-dashed line, line width 10 (30 fg, 20 bg). -.TP 14 -.B \-orect10 -10x10 thin rectangle outline. -.TP 14 -.B \-orect100 -100-pixel thin vertical line segment. -.TP 14 -.B \-orect500 -500-pixel thin vertical line segment. -.TP 14 -.B \-worect10 -10x10 wide rectangle outline. -.TP 14 -.B \-worect100 -100-pixel wide vertical line segment. -.TP 14 -.B \-worect500 -500-pixel wide vertical line segment. -.TP 14 -.B \-circle1 -1-pixel diameter thin (line width 0) circle. -.TP 14 -.B \-circle10 -10-pixel diameter thin circle. -.TP 14 -.B \-circle100 -100-pixel diameter thin circle. -.TP 14 -.B \-circle500 -500-pixel diameter thin circle. -.TP 14 -.B \-dcircle100 -100-pixel diameter thin dashed circle (3 on, 2 off). -.TP 14 -.B \-ddcircle100 -100-pixel diameter thin double-dashed circle (3 fg, 2 bg). -.TP 14 -.B \-wcircle10 -10-pixel diameter circle, line width 1. -.TP 14 -.B \-wcircle100 -100-pixel diameter circle, line width 10. -.TP 14 -.B \-wcircle500 -500-pixel diameter circle, line width 50. -.TP 14 -.B \-wdcircle100 -100-pixel diameter dashed circle, line width 10 (30 on, 20 off). -.TP 14 -.B \-wddcircle100 -100-pixel diameter double-dashed circle, line width 10 (30 fg, 20 bg). -.TP 14 -.B \-pcircle10 -10-pixel diameter thin partial circle, -orientation and arc angle evenly distributed. -.TP 14 -.B \-pcircle100 -100-pixel diameter thin partial circle. -.TP 14 -.B \-wpcircle10 -10-pixel diameter wide partial circle. -.TP 14 -.B \-wpcircle100 -100-pixel diameter wide partial circle. -.TP 14 -.B \-fcircle1 -1-pixel diameter filled circle. -.TP 14 -.B \-fcircle10 -10-pixel diameter filled circle. -.TP 14 -.B \-fcircle100 -100-pixel diameter filled circle. -.TP 14 -.B \-fcircle500 -500-pixel diameter filled circle. -.TP 14 -.B \-fcpcircle10 -10-pixel diameter partial filled circle, chord fill, -orientation and arc angle evenly distributed. -.TP 14 -.B \-fcpcircle100 -100-pixel diameter partial filled circle, chord fill. -.TP 14 -.B \-fspcircle10 -10-pixel diameter partial filled circle, pie slice fill, -orientation and arc angle evenly distributed. -.TP 14 -.B \-fspcircle100 -100-pixel diameter partial filled circle, pie slice fill. -.TP 14 -.B \-ellipse10 -10-pixel diameter thin (line width 0) ellipse, major and -minor axis sizes evenly distributed. -.TP 14 -.B \-ellipse100 -100-pixel diameter thin ellipse. -.TP 14 -.B \-ellipse500 -500-pixel diameter thin ellipse. -.TP 14 -.B \-dellipse100 -100-pixel diameter thin dashed ellipse (3 on, 2 off). -.TP 14 -.B \-ddellipse100 -100-pixel diameter thin double-dashed ellipse (3 fg, 2 bg). -.TP 14 -.B \-wellipse10 -10-pixel diameter ellipse, line width 1. -.TP 14 -.B \-wellipse100 -100-pixel diameter ellipse, line width 10. -.TP 14 -.B \-wellipse500 -500-pixel diameter ellipse, line width 50. -.TP 14 -.B \-wdellipse100 -100-pixel diameter dashed ellipse, line width 10 (30 on, 20 off). -.TP 14 -.B \-wddellipse100 -100-pixel diameter double-dashed ellipse, line width 10 (30 fg, 20 bg). -.TP 14 -.B \-pellipse10 -10-pixel diameter thin partial ellipse. -.TP 14 -.B \-pellipse100 -100-pixel diameter thin partial ellipse. -.TP 14 -.B \-wpellipse10 -10-pixel diameter wide partial ellipse. -.TP 14 -.B \-wpellipse100 -100-pixel diameter wide partial ellipse. -.TP 14 -.B \-fellipse10 -10-pixel diameter filled ellipse. -.TP 14 -.B \-fellipse100 -100-pixel diameter filled ellipse. -.TP 14 -.B \-fellipse500 -500-pixel diameter filled ellipse. -.TP 14 -.B \-fcpellipse10 -10-pixel diameter partial filled ellipse, chord fill. -.TP 14 -.B \-fcpellipse100 -100-pixel diameter partial filled ellipse, chord fill. -.TP 14 -.B \-fspellipse10 -10-pixel diameter partial filled ellipse, pie slice fill. -.TP 14 -.B \-fspellipse100 -100-pixel diameter partial filled ellipse, pie slice fill. -.TP 14 -.B \-triangle1 -Fill 1-pixel/side triangle. -.TP 14 -.B \-triangle10 -Fill 10-pixel/side triangle. -.TP 14 -.B \-triangle100 -Fill 100-pixel/side triangle. -.TP 14 -.B \-trap1 -Fill 1x1 trapezoid. -.TP 14 -.B \-trap10 -Fill 10x10 trapezoid. -.TP 14 -.B \-trap100 -Fill 100x100 trapezoid. -.TP 14 -.B \-trap300 -Fill 300x300 trapezoid. -.TP 14 -.B \-strap1 -Fill 1x1 transparent stippled trapezoid, 8x8 stipple pattern. -.TP 14 -.B \-strap10 -Fill 10x10 transparent stippled trapezoid, 8x8 stipple pattern. -.TP 14 -.B \-strap100 -Fill 100x100 transparent stippled trapezoid, 8x8 stipple pattern. -.TP 14 -.B \-strap300 -Fill 300x300 transparent stippled trapezoid, 8x8 stipple pattern. -.TP 14 -.B \-ostrap1 -Fill 10x10 opaque stippled trapezoid, 8x8 stipple pattern. -.TP 14 -.B \-ostrap10 -Fill 10x10 opaque stippled trapezoid, 8x8 stipple pattern. -.TP 14 -.B \-ostrap100 -Fill 100x100 opaque stippled trapezoid, 8x8 stipple pattern. -.TP 14 -.B \-ostrap300 -Fill 300x300 opaque stippled trapezoid, 8x8 stipple pattern. -.TP 14 -.B \-tiletrap1 -Fill 10x10 tiled trapezoid, 4x4 tile pattern. -.TP 14 -.B \-tiletrap10 -Fill 10x10 tiled trapezoid, 4x4 tile pattern. -.TP 14 -.B \-tiletrap100 -Fill 100x100 tiled trapezoid, 4x4 tile pattern. -.TP 14 -.B \-tiletrap300 -Fill 300x300 tiled trapezoid, 4x4 tile pattern. -.TP 14 -.B \-oddstrap1 -Fill 1x1 transparent stippled trapezoid, 17x15 stipple pattern. -.TP 14 -.B \-oddstrap10 -Fill 10x10 transparent stippled trapezoid, 17x15 stipple pattern. -.TP 14 -.B \-oddstrap100 -Fill 100x100 transparent stippled trapezoid, 17x15 stipple pattern. -.TP 14 -.B \-oddstrap300 -Fill 300x300 transparent stippled trapezoid, 17x15 stipple pattern. -.TP 14 -.B \-oddostrap1 -Fill 10x10 opaque stippled trapezoid, 17x15 stipple pattern. -.TP 14 -.B \-oddostrap10 -Fill 10x10 opaque stippled trapezoid, 17x15 stipple pattern. -.TP 14 -.B \-oddostrap100 -Fill 100x100 opaque stippled trapezoid, 17x15 stipple pattern. -.TP 14 -.B \-oddostrap300 -Fill 300x300 opaque stippled trapezoid, 17x15 stipple pattern. -.TP 14 -.B \-oddtiletrap1 -Fill 10x10 tiled trapezoid, 17x15 tile pattern. -.TP 14 -.B \-oddtiletrap10 -Fill 10x10 tiled trapezoid, 17x15 tile pattern. -.TP 14 -.B \-oddtiletrap100 -Fill 100x100 tiled trapezoid, 17x15 tile pattern. -.TP 14 -.B \-oddtiletrap300 -Fill 300x300 tiled trapezoid, 17x15 tile pattern. -.TP 14 -.B \-bigstrap1 -Fill 1x1 transparent stippled trapezoid, 161x145 stipple pattern. -.TP 14 -.B \-bigstrap10 -Fill 10x10 transparent stippled trapezoid, 161x145 stipple pattern. -.TP 14 -.B \-bigstrap100 -Fill 100x100 transparent stippled trapezoid, 161x145 stipple pattern. -.TP 14 -.B \-bigstrap300 -Fill 300x300 transparent stippled trapezoid, 161x145 stipple pattern. -.TP 14 -.B \-bigostrap1 -Fill 10x10 opaque stippled trapezoid, 161x145 stipple pattern. -.TP 14 -.B \-bigostrap10 -Fill 10x10 opaque stippled trapezoid, 161x145 stipple pattern. -.TP 14 -.B \-bigostrap100 -Fill 100x100 opaque stippled trapezoid, 161x145 stipple pattern. -.TP 14 -.B \-bigostrap300 -Fill 300x300 opaque stippled trapezoid, 161x145 stipple pattern. -.TP 14 -.B \-bigtiletrap1 -Fill 10x10 tiled trapezoid, 161x145 tile pattern. -.TP 14 -.B \-bigtiletrap10 -Fill 10x10 tiled trapezoid, 161x145 tile pattern. -.TP 14 -.B \-bigtiletrap100 -Fill 100x100 tiled trapezoid, 161x145 tile pattern. -.TP 14 -.B \-bigtiletrap300 -Fill 300x300 tiled trapezoid, 161x145 tile pattern. -.TP 14 -.B \-eschertiletrap1 -Fill 1x1 tiled trapezoid, 216x208 tile pattern. -.TP 14 -.B \-eschertiletrap10 -Fill 10x10 tiled trapezoid, 216x208 tile pattern. -.TP 14 -.B \-eschertiletrap100 -Fill 100x100 tiled trapezoid, 216x208 tile pattern. -.TP 14 -.B \-eschertiletrap300 -Fill 300x300 tiled trapezoid, 216x208 tile pattern. -.TP 14 -.B \-complex10 -Fill 10-pixel/side complex polygon. -.TP 14 -.B \-complex100 -Fill 100-pixel/side complex polygon. -.TP 14 -.B \-64poly10convex -Fill 10x10 convex 64-gon. -.TP 14 -.B \-64poly100convex -Fill 100x100 convex 64-gon. -.TP 14 -.B \-64poly10complex -Fill 10x10 complex 64-gon. -.TP 14 -.B \-64poly100complex -Fill 100x100 complex 64-gon. -.TP 14 -.B \-ftext -Character in 80-char line (6x13). -.TP 14 -.B \-f8text -Character in 70-char line (8x13). -.TP 14 -.B \-f9text -Character in 60-char line (9x15). -.TP 14 -.B \-f14text16 -2-byte character in 40-char line (k14). -.TP 14 -.B \-tr10text -Character in 80-char line (Times-Roman 10). -.TP 14 -.B \-tr24text -Character in 30-char line (Times-Roman 24). -.TP 14 -.B \-polytext -Character in 20/40/20 line (6x13, Times-Roman 10, 6x13). -.TP 14 -.B \-polytext16 -2-byte character in 7/14/7 line (k14, k24). -.TP 14 -.B \-fitext -Character in 80-char image line (6x13). -.TP 14 -.B \-f8itext -Character in 70-char image line (8x13). -.TP 14 -.B \-f9itext -Character in 60-char image line (9x15). -.TP 14 -.B \-f14itext16 -2-byte character in 40-char image line (k14). -.TP 14 -.B \-f24itext16 -2-byte character in 23-char image line (k24). -.TP 14 -.B \-tr10itext -Character in 80-char image line (Times-Roman 10). -.TP 14 -.B \-tr24itext -Character in 30-char image line (Times-Roman 24). -.TP 14 -.B \-scroll10 -Scroll 10x10 pixels vertically. -.TP 14 -.B \-scroll100 -Scroll 100x100 pixels vertically. -.TP 14 -.B \-scroll500 -Scroll 500x500 pixels vertically. -.TP 14 -.B \-copywinwin10 -Copy 10x10 square from window to window. -.TP 14 -.B \-copywinwin100 -Copy 100x100 square from window to window. -.TP 14 -.B \-copywinwin500 -Copy 500x500 square from window to window. -.TP 14 -.B \-copypixwin10 -Copy 10x10 square from pixmap to window. -.TP 14 -.B \-copypixwin100 -Copy 100x100 square from pixmap to window. -.TP 14 -.B \-copypixwin500 -Copy 500x500 square from pixmap to window. -.TP 14 -.B \-copywinpix10 -Copy 10x10 square from window to pixmap. -.TP 14 -.B \-copywinpix100 -Copy 100x100 square from window to pixmap. -.TP 14 -.B \-copywinpix500 -Copy 500x500 square from window to pixmap. -.TP 14 -.B \-copypixpix10 -Copy 10x10 square from pixmap to pixmap. -.TP 14 -.B \-copypixpix100 -Copy 100x100 square from pixmap to pixmap. -.TP 14 -.B \-copypixpix500 -Copy 500x500 square from pixmap to pixmap. -.TP 14 -.B \-copyplane10 -Copy 10x10 1-bit deep plane. -.TP 14 -.B \-copyplane100 -Copy 100x100 1-bit deep plane. -.TP 14 -.B \-copyplane500 -Copy 500x500 1-bit deep plane. -.TP 14 -.B \-putimage10 -PutImage 10x10 square. -.TP 14 -.B \-putimage100 -PutImage 100x100 square. -.TP 14 -.B \-putimage500 -PutImage 500x500 square. -.TP 14 -.B \-putimagexy10 -PutImage XY format 10x10 square. -.TP 14 -.B \-putimagexy100 -PutImage XY format 100x100 square. -.TP 14 -.B \-putimagexy500 -PutImage XY format 500x500 square. -.TP 14 -.B \-shmput10 -PutImage 10x10 square, MIT shared memory extension. -.TP 14 -.B \-shmput100 -PutImage 100x100 square, MIT shared memory extension. -.TP 14 -.B \-shmput500 -PutImage 500x500 square, MIT shared memory extension. -.TP 14 -.B \-shmputxy10 -PutImage XY format 10x10 square, MIT shared memory extension. -.TP 14 -.B \-shmputxy100 -PutImage XY format 100x100 square, MIT shared memory extension. -.TP 14 -.B \-shmputxy500 -PutImage XY format 500x500 square, MIT shared memory extension. -.TP 14 -.B \-getimage10 -GetImage 10x10 square. -.TP 14 -.B \-getimage100 -GetImage 100x100 square. -.TP 14 -.B \-getimage500 -GetImage 500x500 square. -.TP 14 -.B \-getimagexy10 -GetImage XY format 10x10 square. -.TP 14 -.B \-getimagexy100 -GetImage XY format 100x100 square. -.TP 14 -.B \-getimagexy500 -GetImage XY format 500x500 square. -.TP 14 -.B \-noop -X protocol NoOperation. -.TP 14 -.B \-atom -GetAtomName. -.TP 14 -.B \-pointer -QueryPointer. -.TP 14 -.B \-prop -GetProperty. -.TP 14 -.B \-gc -Change graphics context. -.TP 14 -.B \-create -Create child window and map using MapSubwindows. -.TP 14 -.B \-ucreate -Create unmapped window. -.TP 14 -.B \-map -Map child window via MapWindow on parent. -.TP 14 -.B \-unmap -Unmap child window via UnmapWindow on parent. -.TP 14 -.B \-destroy -Destroy child window via DestroyWindow parent. -.TP 14 -.B \-popup -Hide/expose window via Map/Unmap popup window. -.TP 14 -.B \-move -Move window. -.TP 14 -.B \-umove -Moved unmapped window. -.TP 14 -.B \-movetree -Move window via MoveWindow on parent. -.TP 14 -.B \-resize -Resize window. -.TP 14 -.B \-uresize -Resize unmapped window. -.TP 14 -.B \-circulate -Circulate lowest window to top. -.TP 14 -.B \-ucirculate -Circulate unmapped window to top. -.SH X DEFAULTS -There are no X defaults used by this program. -.SH "SEE ALSO" -X(__miscmansuffix__), x11perfcomp(__appmansuffix__) -.SH AUTHORS -Joel McCormack -.br -Phil Karlton -.br -Susan Angebranndt -.br -Chris Kent -.br -Keith Packard -.br -Graeme Gill diff --git a/x11perfcomp.man b/x11perfcomp.man deleted file mode 100644 index 4f567d2..0000000 --- a/x11perfcomp.man +++ /dev/null @@ -1,80 +0,0 @@ -.\" Copyright 1993, 1994, 1998 The Open Group -.\" -.\" Permission to use, copy, modify, distribute, and sell this software and its -.\" documentation for any purpose is hereby granted without fee, provided that -.\" the above copyright notice appear in all copies and that both that -.\" copyright notice and this permission notice appear in supporting -.\" documentation. -.\" -.\" The above copyright notice and this permission notice shall be included -.\" in all copies or substantial portions of the Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS -.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. -.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR -.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, -.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -.\" OTHER DEALINGS IN THE SOFTWARE. -.\" -.\" Except as contained in this notice, the name of The Open Group shall -.\" not be used in advertising or otherwise to promote the sale, use or -.\" other dealings in this Software without prior written authorization -.\" from The Open Group. -.\" -.\" -.TH X11PERFCOMP 1 __xorgversion__ -.SH NAME -x11perfcomp \- X11 server performance comparison program -.SH SYNTAX -.B x11perfcomp -[ \-r | \-ro ] [ \-l label_file ] files -.SH DESCRIPTION -The -.I x11perfcomp -program merges the output of several -.I x11perf(__appmansuffix__) -runs into a nice tabular -format. It takes the results in each file, fills in any missing test results if -necessary, and for each test shows the objects/second rate of each server. -If invoked with the -r or -ro options, it shows the relative performance -of each server to the first server. -.PP -Normally, -.I x11perfcomp -uses the first file specified to determine which specific tests it should -report on. Some (non-DEC :) servers may fail to perform -all tests. In this case, -.I x11perfcomp -automatically substitutes in a rate of 0.0 objects/second. -Since the first file -determines which tests to report on, this file must contain a superset of -the tests reported in the other files, else -.I x11perfcomp -will fail. -.PP -You can provide an explicit list of tests to report on -by using the -l switch to specify a file of labels. You can create a label -file by using the -label option in -.I x11perf. -.SH OPTIONS -.I x11perfcomp -accepts the options listed below: -.TP 16 -.B \-r -Specifies that the output should also include relative server -performance. -.TP 16 -.B \-ro -Specifies that the output should include only relative server performance. -.TP 16 -.B \-l label_file -Specifies a label file to use. -.SH X DEFAULTS -There are no X defaults used by this program. -.SH "SEE ALSO" -X(__miscmansuffix__), x11perf(__appmansuffix__) -.SH AUTHORS -Mark Moraes wrote the original scripts to compare servers. -.br -Joel McCormack just munged them together a bit. -- cgit v1.2.3