Section 1 · User commands

xwfb-run.1

Package: xwayland-run

XWFB-RUN

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
SEE ALSO

NAME

xwfb-run − Run X11 clients on a dedicated Xwayland server headless.

SYNOPSIS

xwfb-run [option …] — COMMAND

DESCRIPTION

xwfb-run is intended as a replacement utility for xvfb-run, using rootful Xwayland running fullscreen on a headless compositor instead of Xvfb.

OPTIONS

−a AUTO_SERVERNUM, —auto-servernum AUTO_SERVERNUM

Unused, kept for backward compatibility only.

−c COMPOSITOR, —compositor COMPOSITOR

Use the compositor class implementation.

−d AUTO_DISPLAY, —auto-display AUTO_DISPLAY

Unused, kept for backward compatibility only.

−e ERROR_FILE, —error-file ERROR_FILE

File used to store xauth and X server errors.

−f AUTH_FILE, —auth-file AUTH_FILE

File used to store auth cookie.

−n SERVER_NUM, —server-num SERVER_NUM

Xserver number to use.

−l, —listen-tcp

Enable TCP port listening in the X server.

−p XAUTH_PROTO, —xauth-proto XAUTH_PROTO

Xauthority protocol name to use.

−s SERVER_ARGS, —server-args SERVER_ARGS

Arguments to pass to the X server. Xserver arguments must be escaped with two backslash characters, e.g. -s \\-ac.

−w WAIT, —wait WAIT

Delay in seconds to wait for the X server to start before running COMMAND.

−z COMPOSITOR_ARGS, —compositor-args COMPOSITOR_ARGS

Arguments to pass to the Wayland compositor. Arguments intended to the Wayland compositor must be escaped with two backslash characters, e.g. -z \\—renderer -z gl.

FILES

wlheadless.conf

Sets the default compositor to use.

The file is searched in wlheadless directory relative to the paths specified in the standard environment variables XDG_DATA_HOME and XDG_DATA_DIRS.

[DEFAULT]
Compositor = weston