1
2XWFB-RUN(1)                 General Commands Manual                XWFB-RUN(1)
3
4
5

NAME

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

SYNOPSIS

10       xwfb-run [option ...] -- COMMAND
11

DESCRIPTION

13       xwfb-run is intended as a replacement utility for xvfb-run, using root‐
14       ful Xwayland running fullscreen on a  headless  compositor  instead  of
15       Xvfb.
16

OPTIONS

18       -a AUTO_SERVERNUM, --auto-servernum AUTO_SERVERNUM
19               Unused, kept for backward compatibility only.
20
21       -c COMPOSITOR, --compositor COMPOSITOR
22               Use the compositor class implementation.
23
24       -d AUTO_DISPLAY, --auto-display AUTO_DISPLAY
25               Unused, kept for backward compatibility only.
26
27       -e ERROR_FILE, --error-file ERROR_FILE
28               File used to store xauth and X server errors.
29
30       -f AUTH_FILE, --auth-file AUTH_FILE
31               File used to store auth cookie.
32
33       -n SERVER_NUM, --server-num SERVER_NUM
34                Xserver number to use.
35
36       -l, --listen-tcp
37               Enable TCP port listening in the X server.
38
39       -p XAUTH_PROTO, --xauth-proto XAUTH_PROTO
40               Xauthority protocol name to use.
41
42       -s SERVER_ARGS, --server-args SERVER_ARGS
43               Arguments  to  pass  to the X server. Xserver arguments must be
44               escaped with two backslash characters, e.g. -s \\-ac.
45
46       -w WAIT, --wait WAIT
47               Delay in seconds to wait for the X server to start before  run‐
48               ning COMMAND.
49
50       -z COMPOSITOR_ARGS, --compositor-args COMPOSITOR_ARGS
51               Arguments to pass to the Wayland compositor. Arguments intended
52               to the Wayland compositor must be escaped  with  two  backslash
53               characters, e.g. -z \\--renderer -z gl.
54

FILES

56       wlheadless.conf
57
58       Sets the default compositor to use.
59
60       The  file  is  searched  in  wlheadless directory relative to the paths
61       specified in  the  standard  environment  variables  XDG_DATA_HOME  and
62       XDG_DATA_DIRS.
63
64       [DEFAULT]
65           Compositor = weston
66

SEE ALSO

68       wlheadless-run(1), xwayland-run(1), Xwayland(1), Xvfb(1)
69
70
71
72
73                                                                   XWFB-RUN(1)
Impressum