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