NAME

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

SYNOPSIS

       Xwayland [option ...]

DESCRIPTION

       Xwayland is an X server and a Wayland client. It plays the role of a proxy between legacy X clients which
       do not support the Wayland protocols and the Wayland server.

       Usually,  Xwayland  is  spawned  automatically  by the Wayland server and runs rootless so that X clients
       integrate seamlessly with the rest of the Wayland desktop. It is however possible for a  user  to  launch
       Xwayland non-rootless, mainly for testing purposes.

       Like  all  of the X servers, Xwayland accepts the command line options described in the Xserver(7) manual
       page.  The following additional arguments are supported as well.

       -decorate
               Add decorations to the Xwayland root window when running rootful.

               This option has no effect when Xwayland is built without libdecor support (optional).

               This option is not compatible with rootless mode (-rootless).

       -eglstream
               Use EGLStream backend for NVidia GPUs. If Xwayland was  compiled  with  EGLStream  support,  this
               option  will  instruct  Xwayland  to  try that backend first, then fallback to the GBM backend if
               EGLStream is not supported by the Wayland server. Without this option,  Xwayland  tries  the  GBM
               backend first, and fallback to EGLStream if GBM is not usable.

       -enable-ei-portal
               Enable support for the XDG portal for input emulation.

               A Wayland compositor running nested should not use that command line option with Xwayland.

               This  option  has  no  effect  if  the  compositor  doesn't support the relevant XDG portal or if
               Xwayland was not compiled with EI and OEFFIS support.

       -fullscreen
               Set the Xwayland window fullscreen when running rootful.

               This option is not compatible with rootless mode (-rootless).

       -geometry WxH
               Sets the geometry of the Xwayland window to WxH when running rootful.

               This option is not compatible with rootless mode (-rootless).

       -host-grab
               Disable host keyboard shorcuts and confine the pointer when running rootful.

               This feature relies on the protocol for inhibiting the compositor keyboard shortcuts and  on  the
               protocol  for pointer locking and confinement and may have no effect if the Wayland compositor in
               use does not support these protocols.

               Use the keys [CTRL]+[SHIFT] simultaneously to release the keyboard and pointer devices.

               This option is not compatible with rootless mode (-rootless).

       -initfd fd
               Add the given fd as a listen socket for initialization of X clients.  This options  is  aimed  at
               Wayland  servers  which run Xwayland on-demand, to be able to spawn specific X clients which need
               to complete before other regular X clients can connect to Xwayland, like xrdb.

       -listen fd
               deprecated, use -listenfd instead.

       -listenfd fd
               Add given fd as a listen socket. This option is used by the Wayland server to pass  Xwayland  the
               socket where X clients connect.

       -noTouchPointerEmulation
               Disable  touch pointer emulation. This allows the Wayland compositor to implement its own pointer
               emulation mechanism for X11 clients that don't support touch input.

       -force-xrandr-emulation
               Force additional non-native modes to be exposed when viewporter is not supported by  the  Wayland
               compositor.

       -rootless
               Run  Xwayland  rootless, so that X clients integrate seamlessly with Wayland clients in a Wayland
               desktop. That requires the Wayland server to be an X window manager as well.

       -shm    Force the shared memory backend instead of glamor (if  available)  for  passing  buffers  to  the
               Wayland server.

       -verbose [n]
               Sets  the verbosity level for information printed on stderr.  If the n value isn't supplied, each
               occurrence of this option increments the verbosity level.  When the  n  value  is  supplied,  the
               verbosity level is set to that value.  The default verbosity level is 0.

       -version
               Show the server version and exit.

       -wm fd  This  option is used by the Wayland server to pass Xwayland the socket where the X window manager
               client connects, when Xwayland is running with -rootless.

ENVIRONMENT

       WAYLAND_DISPLAY
               the name of the display of the Wayland server.

       XWAYLAND_NO_GLAMOR
               disable glamor and DRI3 support in Xwayland, for testing purposes.

SEE ALSO

       General information: X(7)

X Version 11                                   xorg-server 23.2.6                                    XWAYLAND(1)