NAME

xvfb-run - run specified X client or command in a virtual X server environment

SYNOPSIS

xvfb-run [ options ] command

DESCRIPTION

xvfb-run is a wrapper for the 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.

xvfb-run sets up an X authority file (or uses an existing user-specified one), writes a cookie to it (see xauth(1x)) and then starts the Xvfb X server as a background process. The process ID of Xvfb is stored for later use. The specified command is then run using the X display corresponding to the Xvfb server just started and the X authority file created earlier.

When the command exits, its status is saved, the Xvfb 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). xvfb-run then exits with the exit status of command.

xvfb-run requires the xauth command to function.

OPTIONS

-a, --auto-servernum

Try to get a free server number, starting at 99, or the argument to --server-num.

-e file, --error-file=file

Redirect output from xauth and Xvfb in file. The default is no redirection.

-f file, --auth-file=file

Store X authentication data in file. By default, the mktemp(1) command is used to create a temporary directory in the directory specified by the environment variable TMPDIR (or /tmp if that variable is null or unset), and the Xauthority file in that temporary directory will be used to store X authentication data.

-h, --help

Display a usage message and exit.

-n servernumber, --server-num=servernumber

Use servernumber as the server number (but see the -a, --auto-servernum option above). The default is 99.

-l, --listen-tcp

Enable TCP port listening in the X server. For security reasons (to avoid denial-of-service attacks or exploits), TCP port listening is disabled by default.

-p protocolname, --xauth-protocol=protocolname

Use protocolname as the X authority protocol to use. The default is ‘.’, which xauth interprets as its own default protocol, which is MIT-MAGIC-COOKIE-1.

-s arguments, --server-args=arguments

Pass arguments to the Xvfb server. Be careful to quote any whitespace characters that may occur within arguments to prevent them from regarded as separators for xvfb-run's own arguments. Also, note that specification of ‘-nolisten tcp’ in arguments may override the function of xvfb-run's own -l, --listen-tcp option, and that specification of the server number (e.g., ‘:1’) may be ignored because of the way the X server parses its argument list. Use the xvfb-run option -n servernumber, --server-num=servernumber to achieve the latter function. The default is ‘-screen 0 1280x1024x24’.

ENVIRONMENT

TMPDIR

specifies the directory in which to place xvfb-run's temporary directory for storage of the X authority file; only used if the -f or --auth-file options are not specified.

OUTPUT FILES

Unless the -f or --auth-file options are specified, a temporary directory and file within it are created (and deleted) to store the X authority cookies used by the Xvfb server and client(s) run under it. See tempfile(1). If -f or --auth-file are used, then the specified X authority file is only written to, not created or deleted (though xauth creates an authority file itself if told to use use that does not already exist).

An error file with a user-specified name is also created if the -e or --error-file options are specifed; see above.

EXAMPLES

xvfb-run --auto-servernum --server-num=1 xlogo

runs the xlogo(1x) demonstration client inside the Xvfb X server on the first available server number greater than or equal to 1.

xvfb-run --server-args="-screen 0 1024x768x24" ico -faces

runs the ico(1x) demonstration client (and passes it the -faces argument) inside the Xvfb X server, configured with a root window of 1024 by 768 pixels and a color depth of 24 bits.

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 xvfb-run will exit.

BUGS

See the ALT Bug Tracking System ⟨URL: http://bugzilla.altlinux.org/ ⟩.

AUTHOR

xvfb-run was written by Branden Robinson and Jeff Licquia with sponsorship from Progeny Linux Systems.

SEE ALSO

Xvfb(1), xauth(1)