NAME¶

miral-shell - Mir Display Server shell

SYNOPSIS¶

miral-shell [options]

DESCRIPTION¶

miral-shell launches a Mir Display Server shell, offering both traditional and tiling window management.

The Mir shell 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.

--cursor-theme <cursor-theme>

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

--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-manager {floating,tiling}

Window management strategy (default: floating).

--window-management-trace

Log trace messages.

--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).

--keymap <keymap> (=us)

A keymap identifier. Format: <layout>[+<variant>[+<options>]], e,g, "gb", "cz+qwerty" or "de++compose:caps" (default: us).

--shell-wallpaper-font <fullpath-to-font>

Font file to use for wallpaper (default: /usr/share/fonts/truetype/freefont/FreeSansBold.ttf).

-h [ --help ]

Show help text and exit.

SEE ALSO¶

mir-kiosk(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.