of the specified command.
.TP
0
.B x\-run
only uses this exit status if the
.B \-h\fR,\fB \-\-help
option is given.
In all other situations, this may be interpreted as success of the specified
command.
.TP
2
No command to run was specified.
.TP
3
The
.B xauth
command is not available.
.TP
4
The temporary directory that was going to be used already exists; since
.B x\-run
produces a uniquely named directory, this may indicate an attempt by another
process on the system to exploit a temporary file race condition.
.TP
5
A problem was encountered while cleaning up the temporary directory.
.TP
6
A problem was encountered while using
.BR getopt (1)
to parse the command\-line arguments.
.SH EXAMPLES
.TP
.B x\-run \-\-auto\-servernum \-\-server\-num=1 xlogo
runs the
.BR xlogo (1x)
demonstration client inside the
.B Xvfb
X server on the first available server number greater than or equal to 1.
.TP
.B x\-run \-\-server\-args=\-screen 0 1024x768x24 ico \-faces
runs the
.BR ico (1x)
demonstration client (and passes it the
.B \-faces
argument) inside the
.B Xvfb
X server, configured with a root window of 1024 by 768 pixels and a color
depth of 24 bits.
.PP
Note that the demo X clients used in the above examples will not exit on
their own, so they will have to be killed before
.B x\-run
will exit.
.SH BUGS
See
.URL http://bugs.debian.org/xvfb; the Debian Bug Tracking System .
If you wish to report a bug in
.BR xvfb\-run ,
please see
.I /usr/share/doc/debian/bug\-reporting.txt
or the
.BR reportbug (1)
command.
.SH AUTHOR
.B x\-run
is a modified version of
.B xvfb\-run
found in the Debian Operating system.
Reinhard Tartler renamed the script and added the
.I -x
Switch.
.B xvfb\-run
was written by Branden Robinson and Jeff Licquia with sponsorship from
Progeny Linux Systems.
.SH SEE ALSO
.BR Xvfb (1x),
.BR xauth (1x)
.\ vim:set et tw=80:
--- xvfb-run.1 2007-09-26 11:23:16.384451000 +0200
+++ x-run.1 2007-09-26 11:22:18.333818000 +0200
@@ -1,5 +1,3 @@
-.\ $Id: xvfb-run.1 2138 2005-01-17 23:40:27Z branden $
-.\
.\ Copyright 1998-2004 Branden Robinson [EMAIL PROTECTED].
.\
.\ This is free software; you may redistribute it and/or modify
@@ -25,24 +23,24 @@
\\$2 \(laURL: \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
-.TH xvfb\-run 1 2004\-11\-12 Debian Project
+.TH x\-run 1 2004\-11\-12 Debian Project
.SH NAME
-xvfb\-run \- run specified X client or command in a virtual X server environment
+x\-run \- run specified X client or command in a virtual X server environment
.SH SYNOPSIS
-.B xvfb\-run
+.B x\-run
[
.I options
]
.I command
.SH DESCRIPTION
-.B xvfb\-run
+.B x\-run
is a wrapper for the
.BR Xvfb (1x)
command which simplifies the task of running commands (typically an X
client, or a script containing a list of clients to be run) within a virtual
X server environment.
.PP
-.B xvfb\-run
+.B x\-run
sets up an X authority file (or uses an existing user\-specified one),
writes a cookie to it (see
.BR xauth (1x))
@@ -66,11 +64,11 @@
server is killed (using the process ID stored earlier), the X authority
cookie removed, and the authority file deleted (if the user did not specify
one to use).
-.B xvfb\-run
+.B x\-run
then exits with the exit status of
.IR command .
.PP
-.B xvfb\-run
+.B x\-run
requires the
.B xauth
command to function.
@@ -94,9 +92,9 @@
Store X authentication data in
.IR file .
By default, a temporary directory called
-.IR xvfb\-run. PID
+.IR x\-run. PID
(where PID is the process ID of
-.B xvfb\-run
+.B x\-run
itself) is created in the directory specified by the environment variable
.B TMPDIR
(or
@@ -139,18 +137,18 @@
Be careful to quote any whitespace characters that may occur within
.I arguments
to prevent them from regarded as separators for
-.BR xvfb\-run 's
+.BR x\-run 's
own arguments.
Also, note that specification of \(oq\-nolisten tcp\(cq in
.I arguments
may override the function of
-.BR xvfb\-run 's
+.BR x\-run 's
own
.B \-l\fR,\fB \-\-listen\-tcp
option, and that specification of the server number (e.g., \(oq:1\(cq) may
be ignored because of the way the X server parses its argument list.
Use the
-.B xvfb\-run
+.B x\-run
option
.BI \-n\ servernumber \fR,\fB\ \-\-server\-num= servernumber
to achieve the latter function.
@@ -163,6 +161,13 @@
.B Xvfb
before attempting to start the specified command.
The default is 3.
+.TP
+.BI \-x\ xserver \fR,\fB\ \-\-xserver= xserver
+Use the alternative Xserver
+.I xserver
+instead of
+.B xvfb,
+which is used by default.
.SH ENVIRONMENT
.TP
.B COLUMNS
@@ -175,7 +180,7 @@
.TP
.B TMPDIR
specifies the directory in which to place
-.BR xvfb\-run 's
+.BR x\-run 's
temporary directory for storage of the X authority file; only used if the
.B \-f
or
@@ -206,14 +211,14 @@
.B \-\-error\-file
options are specifed; see above.
.SH EXIT STATUS
-.B xvfb\-run
+.B x\-run
uses its exit status as well as output to standard error to communicate
diagnostics.
The exit status of \(oq1\(cq is not used, and should be interpreted as failure
