Debian Codegraph @

upstream/debian-unstable/man1/x11perfcomp.1

raw
1 .\" Copyright 1993, 1994, 1998 The Open Group
2 .\"
3 .\" Permission to use, copy, modify, distribute, and sell this software and its
4 .\" documentation for any purpose is hereby granted without fee, provided that
5 .\" the above copyright notice appear in all copies and that both that
6 .\" copyright notice and this permission notice appear in supporting
7 .\" documentation.
8 .\"
9 .\" The above copyright notice and this permission notice shall be included
10 .\" in all copies or substantial portions of the Software.
11 .\"
12 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
13 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
14 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
15 .\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
16 .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
17 .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
18 .\" OTHER DEALINGS IN THE SOFTWARE.
19 .\"
20 .\" Except as contained in this notice, the name of The Open Group shall
21 .\" not be used in advertising or otherwise to promote the sale, use or
22 .\" other dealings in this Software without prior written authorization
23 .\" from The Open Group.
24 .\"
25 .\"
26 .TH X11PERFCOMP 1 "x11perf 1.6.1" "X Version 11"
27 .SH NAME
28 x11perfcomp \- X11 server performance comparison program
29 .SH SYNTAX
30 .B x11perfcomp
31 [ \-r | \-ro ] [ \-l label_file ] files
32 .SH DESCRIPTION
33 The
34 .I x11perfcomp
35 program merges the output of several
36 .I x11perf(1)
37 runs into a nice tabular
38 format. It takes the results in each file, fills in any missing test results if
39 necessary, and for each test shows the objects/second rate of each server.
40 If invoked with the -r or -ro options, it shows the relative performance
41 of each server to the first server.
42 .PP
43 Normally,
44 .I x11perfcomp
45 uses the first file specified to determine which specific tests it should
46 report on. Some (non-DEC :) servers may fail to perform
47 all tests. In this case,
48 .I x11perfcomp
49 automatically substitutes in a rate of 0.0 objects/second.
50 Since the first file
51 determines which tests to report on, this file must contain a superset of
52 the tests reported in the other files, else
53 .I x11perfcomp
54 will fail.
55 .PP
56 You can provide an explicit list of tests to report on
57 by using the -l switch to specify a file of labels. You can create a label
58 file by using the -label option in
59 .I x11perf.
60 .SH OPTIONS
61 .I x11perfcomp
62 accepts the options listed below:
63 .TP 16
64 .B \-r
65 Specifies that the output should also include relative server
66 performance.
67 .TP 16
68 .B \-ro
69 Specifies that the output should include only relative server performance.
70 .TP 16
71 .B \-l label_file
72 Specifies a label file to use.
73 .SH X DEFAULTS
74 There are no X defaults used by this program.
75 .SH "SEE ALSO"
76 X(7), x11perf(1)
77 .SH AUTHORS
78 Mark Moraes wrote the original scripts to compare servers.
79 .br
80 Joel McCormack just munged them together a bit.