Provided by: mir-test-tools_2.14.1-6_amd64 bug

NAME

       mir_demo_server - Mir Display Server Demo

SYNOPSIS

       mir_demo_server [options]

DESCRIPTION

       Launch a Mir server demo session.

       The Mir demo server startup can be tweaked by:

       Command-line options:
              e.g. "--host-socket=/tmp/mir_socket".

       Environment variables:
              Capitalise  the  long form of the command line option, prefix it with "MIR_SERVER_"
              and put "_" in place of "-". E.g.  "MIR_SERVER_HOST_SOCKET=/tmp/mir_socket".

       Config file entries:
              Use  the  long  form  command  line  options  in  the  configuration   file.   E.g.
              "--host-socket=/tmp/mir_socket".

       The  config  file  (mir/mir_demo_server.config)  is  located  via  the  XDG Base Directory
       Specification. ($XDG_CONFIG_HOME or $HOME/.config followed by $XDG_CONFIG_DIRS).

OPTIONS

       --host-socket <socket-filename>
              Host socket filename.

       -f [ --file ] <filename>
              Socket       filename        (default:        $XDG_RUNTIME_DIR/mir_socket        or
              /tmp/<UID_NUMBER>-runtime-dir/mir_socket).

       --no-file
              Do not provide a socket filename for client connections.

       --arw-file
              Set socket file permissions to globally read-writeable (equivalent to chmod a=rw).

       -p [ --prompt-file ]
              Provide a "..._trusted" filename for prompt helper connections.

       --platform-graphics-lib <platform_library>
              Library to use for platform graphics support (default: autodetect).

       --platform-input-lib <input_library>
              Library to use for platform input support (default: input-stub.so).

       --platform-path arg (=/usr/lib/x86_64-linux-gnu/mir/server-platform)
              Directory    to    look   for   platform   libraries   (default:   /usr/lib/<multi-
              arch>/mir/server-platform).

       -i [ --enable-input ] {0,1}
              Enable input (default: 1, meaning: enabled).

       --compositor-report {log,lttng,off} (=off)
              Compositor reporting, either of log, lttng or off (default: off).

       --connector-report {log,lttng,off}
              How to handle the Connector report, either of log, lttng or off (default: off).

       --display-report {log,lttng,off}
              How to handle the Display report, either of log, lttng or off (default: off).

       --input-report {log,lttng,off}
              How to handle to Input report, either of log, lttng or off (default: off).

       --legacy-input-report {log,off}
              How to handle the Legacy Input report, either of log or off (default: off).

       --seat-report {log,off}
              How to handle to Seat report, either of log or off (default: off).

       --session-mediator-report {log,lttng,off}
              How to handle the SessionMediator report, either of log,  lttng  or  off  (default:
              off).

       --msg-processor-report {log,lttng,off}
              How  to  handle  the MessageProcessor report, either of log, lttng or off (default:
              off).

       --scene-report {log,lttng,off}
              How to handle the scene report, either of log, lttng or off (default: off).

       --shared-library-prober-report {log,lttng,off}
              How to handle the SharedLibraryProber report, either of log, lttng or off (default:
              log).

       --shell-report {log,off}
              How to handle the Shell report, either of log or off (default: off).

       --composite-delay <msecs>
              Compositor  frame  delay  in  milliseconds  (how  long  to wait for new frames from
              clients before compositing). Higher values result in lower latency but risk causing
              frame skipping. A negative value means decide automatically (default: 0).

       --name <name>
              When nested, the name Mir uses when registering with the host.

       --nested-passthrough {0,1}
              When  nested,  attempt  to pass a client's graphics content directly to the host to
              avoid a composition pass (default: 1).

       --offscreen
              Render to offscreen buffers instead of the real outputs.

       --enable-touchspots
              Display visualization of touchspots (e.g. for screencasting).

       --cursor {auto,null,software}
              Cursor (mouse pointer) to use (default: auto).

       --enable-key-repeat {0,1}
              Enable server generated key repeat (default: 1).

       --on-fatal-error-except
              On "fatal error" conditions (e.g. drivers behaving in  unexpected  ways)  throw  an
              exception (instead of a core dump).

       --debug
              Enable  extra  development debugging. This is only interesting for people doing Mir
              server or client development.

       --enable-mirclient
              Enable deprecated mirclient socket (for running old clients)

       --console-provider arg (=auto)
              Console device handling how Mir handles console-related tasks (device handling,  VT
              switching, etc.) Possible values given:

              logind - use logind vt: use the Linux VT subsystem. Requires root privileges.

              none  -  support no console-related tasks. Useful for nested platforms which do not
              need raw device access and which don't have a VT concept

              auto - detect the appropriate provider.

       --vt {0,1}
              VT to run on or 0 to use current (default: 0).

              Usage of this option requires --console-provider=vt

       --bypass {0,1}
              [platform-specific]  utilize  the  bypass  optimization  for  fullscreen   surfaces
              (default: 1).

       --x11-output <sizes>
              [mir-on-X specific] Colon separated list of WIDTHxHEIGHT sizes for "output" windows
              (default: 1280x1024).

       --wayland-host <socket-name>
              Socket name for host compositor.

       --startup-apps <list-of-applications>
              Colon separated list of startup applications.

       --env-hacks <env-vars>
              Colon separated list of environment variable settings.

       --display-config {clone,sidebyside,single,static=<filename>}
              Display configuration, either of clone, sidebyside,  single,  or  static=<filename>
              (default: sidebyside).

       --translucent {on,off}
              Select a display mode with alpha (default: off).

       --log-host-lifecycle
              Write lifecycle events from host to log.

       --glog Use google::GLog for logging.

       --glog-stderrthreshold <level>
              Copy  log  messages  at  or  above  this  level  to  stderr in addition to logfiles
              (default: 2).

              The numbers of severity levels INFO, WARNING, ERROR, and FATAL are 0, 1, 2, and  3,
              respectively.

       --glog-minloglevel arg (=0)
              Log  messages at or above this level. The numbers of severity levels INFO, WARNING,
              ERROR, and FATAL are 0, 1, 2, and 3, respectively (default: 0).

       --glog-log-dir <directory-path>
              Log files are written into this directory.

       --x11-display-experimental <x11-display-number>
              DISPLAY socket to use for experimental X11 support (default: none).

       --xwayland-path <fullpath-to-Xwayland>
              Path to Xwayland executable (default: /usr/bin/Xwayland).

       --wayland-extensions <wayland-extensions-list>
              Colon separated list of wayland extensions to enable (enabled by default:

              wl_shellxdg_wm_base

              zwlr_layer_shell_v1

              zxdg_output_manager_v1

              zxdg_shell_v6

              ).

       --window-management-trace
              Log trace messages.

       --custom-compositor {adorning,default}
              Select an alternative compositor (default: default)

       --background-color {purple,blue,grey,black}
              Fill the background of the adorning compositor with  a  color,  either  of  purple,
              blue, grey, or black (default: black.)

       --disable-while-typing {0,1}
              Disable touchpad while typing on keyboard configuration (default: 0).

       --mouse-acceleration {none,adaptive}
              Select acceleration profile for mice and trackballs (default: adaptive).

       --mouse-cursor-acceleration-bias <accel>
              Constant factor (+1) to velocity or bias to the acceleration curve within the range
              [-1.0, 1.0] for mice (default: 0).

       --mouse-scroll-speed-scale <speed-scale>
              Scales mice scroll events, use negative values for natural scrolling (default: 1).

       --touchpad-cursor-acceleration-bias <accel>
              Constant factor (+1) to velocity or bias to the acceleration curve within the range
              [-1.0, 1.0] for touchpads (default: 0).

       --touchpad-scroll-speed-scale <speed-scale>
              Scales  touchpad scroll events, use negative values for natural scrolling (default:
              -1).

       --touchpad-scroll-mode <mode>
              Select scroll mode for touchpads, with <mode> being either of  two-finger  or  edge
              (default: two-finger).

       --touchpad-click-mode {area,finger-count}
              Select click mode for touchpads (default: finger-count).

       --timeout <secs>
              Seconds to run before exiting.

       --cursor-theme <cursor-theme>
              Colon separated cursor theme list (e.g. "DMZ-Black", default: DMZ-White).

       --print-input-events
              List input events on std::cout.

       --screen-rotation
              Rotate screen on Ctrl-Alt-<Arrow>.

       --test-client <executable>
              Client executable.

       --test-timeout <secs>
              Seconds to run before sending SIGTERM to client (default: 10).

       -h [ --help ]
              Show this help text and exit.

SEE ALSO

       miral-shell(1)

AUTHOR

       The Mir Display Server has been written by the Mir Server Team at Canonical Ltd.

       This  man  page has been written for the Debian project by Mike Gabriel <mike.gabriel@das-
       netzwerkteam.de> and may be re-used by others.