Debian Codegraph @

upstream/debian-unstable/man1/Xmark.1

raw
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)