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

SEE ALSO

       wlheadless-run(1), xwayland-run(1), Xwayland(1), Xvfb(1)

                                                                                                     XWFB-RUN(1)