| 1 |
.\" This manpage was written by Richard Braakman and is licensed under the |
| 2 |
.\" XFree86 license. |
| 3 |
.TH Xmark 1 "x11perf 1.6.1" "X Version 11" |
| 4 |
.SH NAME |
| 5 |
Xmark \- summarize x11perf results |
| 6 |
.SH SYNTAX |
| 7 |
.B Xmark |
| 8 |
datafile |
| 9 |
.SH DESCRIPTION |
| 10 |
.B Xmark |
| 11 |
is a shell script that reads the indicated datafile and compiles a |
| 12 |
benchmark which it writes to standard output. It writes three |
| 13 |
numbers: |
| 14 |
.PP |
| 15 |
.RS |
| 16 |
A weighted performance number for the |
| 17 |
.I x11perf |
| 18 |
results. |
| 19 |
.PP |
| 20 |
A weighted performance number for a standard SparcStation 1, with |
| 21 |
SunOS 4.1.2, X11R5 Xsun, and a CG3 dumb Color Frame Buffer. |
| 22 |
.\" I assume the latter is a graphics card. |
| 23 |
.PP |
| 24 |
The Xmark, which is the ratio of the two numbers above. |
| 25 |
.RE |
| 26 |
.PP |
| 27 |
The datafile must be an ordinary file, produced by x11perf in the |
| 28 |
following way: |
| 29 |
.PP |
| 30 |
.BI "x11perf -display " display " -v1.3 -rop GXcopy GXxor -all > " datafile |
| 31 |
.PP |
| 32 |
It is possible to run the GXcopy and GXxor tests separately, as long as they |
| 33 |
are concatenated to the same output file: |
| 34 |
.nf |
| 35 |
.BI "x11perf -display " display " -v1.3 -rop GXcopy -all > " datafile |
| 36 |
.BI "x11perf -display " display " -v1.3 -rop GXxor -all >> " datafile |
| 37 |
.fi |
| 38 |
or |
| 39 |
.nf |
| 40 |
.BI "x11perf -display " display " -v1.3 -rop GXxor -all > " datafile |
| 41 |
.BI "x11perf -display " display " -v1.3 -rop GXcopy -all >> " datafile |
| 42 |
.fi |
| 43 |
.SH FILES |
| 44 |
.TP |
| 45 |
.B temp.$$ |
| 46 |
Temporary file created in the current directory, deleted after use. |
| 47 |
.SH DIAGNOSTICS |
| 48 |
.TP |
| 49 |
.B Usage: Xmark datafile |
| 50 |
.I Xmark |
| 51 |
was invoked without arguments or with more than one argument, or |
| 52 |
with options. Xmark takes no options. |
| 53 |
.TP |
| 54 |
.B "Error: data file does not exist or is not ordinary." |
| 55 |
.I Xmark |
| 56 |
cannot find the datafile named on its command line, or the datafile |
| 57 |
is a special file such as a directory. |
| 58 |
.TP |
| 59 |
.BR "WARNING: datafile contains " nnn ", not 441 or 447 'trep' results;" |
| 60 |
The file named on the command line does not seem to be a file generated |
| 61 |
by x11perf in the expected way. |
| 62 |
.TP |
| 63 |
.BR "Diagnostic: ERROR: sum of weights =" nnn ", not equal to 4566.0;" |
| 64 |
There is an internal error in Xmark. |
| 65 |
.SH "SEE ALSO" |
| 66 |
X(7), x11perf(1), x11perfcomp(1) |