summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Xmark.man69
1 files changed, 69 insertions, 0 deletions
diff --git a/Xmark.man b/Xmark.man
new file mode 100644
index 0000000..f9b5113
--- /dev/null
+++ b/Xmark.man
@@ -0,0 +1,69 @@
+.\" This manpage was written by Richard Braakman and is licensed under the
+.\" XFree86 license.
+.\" $XFree86: xc/programs/x11perf/Xmark.man,v 1.3 2001/01/27 18:21:07 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)