summaryrefslogtreecommitdiff
path: root/app/x11perf/Xmark.man
blob: 6e110211bed522613e3b5220287feb9bd837842f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
.\" This manpage was written by Richard Braakman and is licensed under the
.\" XFree86 license.
.\" $XFree86: xc/programs/x11perf/Xmark.man,v 1.2 2001/01/24 00:06:42 dawes Exp $
.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:
.PP
.BI "x11perf -display " display " -v1.3 -rop GXcopy -all > " datafile 
.br
.BI "x11perf -display " display " -v1.3 -rop GXxor -all >> " datafile 
.PP
or
.PP
.BI "x11perf -display " display " -v1.3 -rop GXxor -all > " datafile 
.br
.BI "x11perf -display " display " -v1.3 -rop GXcopy -all >> " datafile 
.PP
.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(1), x11perfcomp(1)