Xwayland(1)

1XWAYLAND(1)                 General Commands Manual                XWAYLAND(1)
2
3
4

NAME

6       Xwayland - an X server for running X clients under Wayland.
7

SYNOPSIS

9       Xwayland [option ...]
10

DESCRIPTION

12       Xwayland  is  an  X server and a Wayland client. It plays the role of a
13       proxy between legacy X clients which do not support the Wayland  proto‐
14       cols and the Wayland server.
15
16       Usually,  Xwayland  is  spawned automatically by the Wayland server and
17       runs rootless so that X clients integrate seamlessly with the  rest  of
18       the  Wayland desktop. It is however possible for a user to launch Xway‐
19       land non-rootless, mainly for testing purposes.
20
21       Like all of the X servers, Xwayland accepts the  command  line  options
22       described  in the Xserver(7) manual page.  The following additional ar‐
23       guments are supported as well.
24
25       -decorate
26               Add decorations to the Xwayland root window when running  root‐
27               ful.
28
29               This  option  has no effect when Xwayland is built without lib‐
30               decor support (optional).
31
32               This option is not compatible with rootless mode (-rootless).
33
34       -eglstream
35               Use EGLStream backend for NVidia GPUs. If Xwayland was compiled
36               with  EGLStream  support, this option will instruct Xwayland to
37               try that backend first, then fallback to  the  GBM  backend  if
38               EGLStream  is not supported by the Wayland server. Without this
39               option, Xwayland tries the GBM backend first, and  fallback  to
40               EGLStream if GBM is not usable.
41
42       -enable-ei-portal
43               Enable support for the XDG portal for input emulation.
44
45               A Wayland compositor running nested should not use that command
46               line option with Xwayland.
47
48               This option has no effect if the compositor doesn't support the
49               relevant XDG portal or if Xwayland was not compiled with EI and
50               OEFFIS support.
51
52       -fullscreen
53               Set the Xwayland window fullscreen when running rootful.
54
55               This option is not compatible with rootless mode (-rootless).
56
57       -geometry WxH
58               Sets the geometry of the Xwayland window to  WxH  when  running
59               rootful.
60
61               This option is not compatible with rootless mode (-rootless).
62
63       -host-grab
64               Disable  host  keyboard  shorcuts  and confine the pointer when
65               running rootful.
66
67               This feature relies on the protocol for inhibiting the composi‐
68               tor  keyboard shortcuts and on the protocol for pointer locking
69               and confinement and may have no effect if the Wayland  composi‐
70               tor in use does not support these protocols.
71
72               Use  the keys [CTRL]+[SHIFT] simultaneously to release the key‐
73               board and pointer devices.
74
75               This option is not compatible with rootless mode (-rootless).
76
77       -initfd fd
78               Add the given fd as a listen socket  for  initialization  of  X
79               clients.   This  options  is aimed at Wayland servers which run
80               Xwayland on-demand, to be able  to  spawn  specific  X  clients
81               which  need to complete before other regular X clients can con‐
82               nect to Xwayland, like xrdb.
83
84       -listen fd
85               deprecated, use -listenfd instead.
86
87       -listenfd fd
88               Add given fd as a listen socket. This option  is  used  by  the
89               Wayland server to pass Xwayland the socket where X clients con‐
90               nect.
91
92       -noTouchPointerEmulation
93               Disable touch pointer emulation. This allows the  Wayland  com‐
94               positor  to  implement  its own pointer emulation mechanism for
95               X11 clients that don't support touch input.
96
97       -force-xrandr-emulation
98               Force additional non-native modes to be exposed when viewporter
99               is not supported by the Wayland compositor.
100
101       -rootless
102               Run  Xwayland  rootless, so that X clients integrate seamlessly
103               with Wayland clients in a Wayland desktop.  That  requires  the
104               Wayland server to be an X window manager as well.
105
106       -shm    Force  the  shared  memory backend instead of glamor (if avail‐
107               able) for passing buffers to the Wayland server.
108
109       -verbose [n]
110               Sets the verbosity level for information printed on stderr.  If
111               the  n value isn't supplied, each occurrence of this option in‐
112               crements the verbosity level.  When the n  value  is  supplied,
113               the  verbosity  level  is  set to that value.  The default ver‐
114               bosity level is 0.
115
116       -version
117               Show the server version and exit.
118
119       -wm fd  This option is used by the Wayland server to pass Xwayland  the
120               socket  where  the X window manager client connects, when Xway‐
121               land is running with -rootless.
122

ENVIRONMENT

124       WAYLAND_DISPLAY
125               the name of the display of the Wayland server.
126
127       XWAYLAND_NO_GLAMOR
128               disable glamor and DRI3 support in Xwayland, for  testing  pur‐
129               poses.
130

NAME

SYNOPSIS

DESCRIPTION

ENVIRONMENT

SEE ALSO