You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
233 lines
7.0 KiB
233 lines
7.0 KiB
.TH WESTON 1 "2012-08-29" "Weston __version__"
|
|
.SH NAME
|
|
weston \- the reference Wayland server
|
|
.SH SYNOPSIS
|
|
.B weston
|
|
.
|
|
.\" ***************************************************************
|
|
.SH DESCRIPTION
|
|
.B weston
|
|
is the reference implementation of a Wayland server. A Wayland server is a
|
|
display server, a window manager, and a compositor all in one. Weston has
|
|
several backends as loadable modules: it can run on Linux KMS (kernel
|
|
modesetting via DRM), as an X client, or inside another Wayland server
|
|
instance.
|
|
|
|
Weston supports fundamentally different graphical user interface paradigms via
|
|
shell plugins. Two plugins are provided: the desktop shell, and the tablet
|
|
shell.
|
|
|
|
When weston is started as the first windowing system (i.e. not under X nor
|
|
under another Wayland server), it should be done with the command
|
|
.B weston-launch
|
|
to set up proper privileged access to devices.
|
|
|
|
Weston also supports X clients by XWayland. XWayland requires a special
|
|
X.org server to be installed. This X server will connect to a Wayland
|
|
server as a Wayland client, and X clients will connect to the X server.
|
|
XWayland provides backwards compatibility to X applications in a Wayland
|
|
stack.
|
|
.
|
|
.\" ***************************************************************
|
|
.SH BACKENDS
|
|
.TP
|
|
.I drm-backend.so
|
|
The DRM backend uses Linux KMS for output and evdev devices for input.
|
|
It supports multiple monitors in a unified desktop with DPMS.
|
|
.TP
|
|
.I wayland-backend.so
|
|
The Wayland backend runs on another Wayland server, a different Weston
|
|
instance, for example. Weston shows up as a single desktop window on
|
|
the parent server.
|
|
.TP
|
|
.I x11-backend.so
|
|
The X11 backend runs on an X server. Each Weston output becomes an
|
|
X window. This is a cheap way to test multi-monitor support of a
|
|
Wayland shell, desktop, or applications.
|
|
.
|
|
.\" ***************************************************************
|
|
.SH SHELLS
|
|
.TP
|
|
Desktop shell
|
|
Desktop shell is like a modern X desktop environment, concentrating
|
|
on traditional keyboard and mouse user interfaces and the familiar
|
|
desktop-like window management. Desktop shell consists of the
|
|
shell plugin
|
|
.I desktop-shell.so
|
|
and the special client
|
|
.B weston-desktop-shell
|
|
which provides the wallpaper, panel, and screen locking dialog.
|
|
.TP
|
|
Tablet shell
|
|
Tablet shell is a graphical user interface aimed for tablet-like
|
|
devices, where usually the only input method is a touch screen.
|
|
It does not support freely floating windows or many other desktop
|
|
features, but intends to provide a natural interface on tablets.
|
|
Tablet shell consists of the shell plugin
|
|
.I tablet-shell.so
|
|
and the special client
|
|
.B weston-tablet-shell
|
|
which provides the basic user interface.
|
|
.
|
|
.\" ***************************************************************
|
|
.SH OPTIONS
|
|
.
|
|
.SS Weston core options:
|
|
.TP
|
|
\fB\-\^B\fR\fIbackend.so\fR, \fB\-\-backend\fR=\fIbackend.so\fR
|
|
Load
|
|
.I backend.so
|
|
instead of the default backend. The file is searched for in
|
|
.IR "__weston_modules_dir__" ,
|
|
or you can pass an absolute path. The default backend is
|
|
.I drm-backend.so
|
|
unless the environment suggests otherwise, see
|
|
.IR DISPLAY " and " WAYLAND_DISPLAY .
|
|
.TP
|
|
.BR \-\^h ", " \-\-help
|
|
Print the program version and a summary of command line options, and quit.
|
|
.TP
|
|
\fB\-\^i\fR\fIN\fR, \fB\-\-idle\-time\fR=\fIN\fR
|
|
Set the idle timeout to
|
|
.I N
|
|
seconds. The default timeout is 300 seconds. When there has not been any
|
|
user input for the idle timeout, Weston enters an inactive mode. The
|
|
screen fades to black, and depending on the shell in use, a screensaver
|
|
may activate, monitors may switch off, and the shell may lock the session.
|
|
.TP
|
|
\fB\-\-log\fR=\fIfile.log\fR
|
|
Append log messages to the file
|
|
.I file.log
|
|
instead of writing them to stderr.
|
|
.TP
|
|
\fB\-\-module\fR=\fImodule.so\fR
|
|
Load a generic plugin module \fImodule.so\fR. Only used by the test
|
|
suite. The file is searched for in
|
|
.IR "__weston_modules_dir__" ,
|
|
or you can pass an absolute path.
|
|
.TP
|
|
\fB\-\^S\fR\fIname\fR, \fB\-\-socket\fR=\fIname\fR
|
|
Weston will listen in the Wayland socket called
|
|
.IR name .
|
|
Weston will export
|
|
.B WAYLAND_DISPLAY
|
|
with this value in the environment for all child processes to allow them to
|
|
connect to the right server automatically.
|
|
.TP
|
|
.B \-\-xserver
|
|
Activate XWayland. Weston starts listening on a new X display socket, and
|
|
exports it in the environment variable
|
|
.BR DISPLAY .
|
|
When the first X client connects, Weston launches a special X server as a
|
|
Wayland client to handle the X client and all future X clients.
|
|
.
|
|
.SS DRM backend options:
|
|
.TP
|
|
\fB\-\-connector\fR=\fIconnectorid\fR
|
|
.TP
|
|
.B \-\-current\-mode
|
|
.TP
|
|
\fB\-\-seat\fR=\fIseatid\fR
|
|
.TP
|
|
\fB\-\-tty\fR=\fItty\fR
|
|
.
|
|
.SS Wayland backend options:
|
|
.TP
|
|
\fB\-\-display\fR=\fIdisplay\fR
|
|
Name of the Wayland display to connect to, see also
|
|
.I WAYLAND_DISPLAY
|
|
of the environment.
|
|
.TP
|
|
\fB\-\-width\fR=\fIW\fR, \fB\-\-height\fR=\fIH\fR
|
|
Make the desktop size
|
|
.IR W x H " pixels."
|
|
.
|
|
.SS X11 backend options:
|
|
.TP
|
|
.B \-\-fullscreen
|
|
.TP
|
|
.B \-\-no\-input
|
|
Do not provide any input devices. Used for testing input-less Weston.
|
|
.TP
|
|
\fB\-\-output\-count\fR=\fIN\fR
|
|
Create
|
|
.I N
|
|
X windows to emulate the same number of outputs.
|
|
.TP
|
|
\fB\-\-width\fR=\fIW\fR, \fB\-\-height\fR=\fIH\fR
|
|
Make the default size of each X window
|
|
.IR W x H " pixels."
|
|
.
|
|
.\" ***************************************************************
|
|
.SH FILES
|
|
.
|
|
.\" ***************************************************************
|
|
.SH ENVIRONMENT
|
|
.
|
|
.TP
|
|
.B DISPLAY
|
|
The X display. If
|
|
.B DISPLAY
|
|
is set, and
|
|
.B WAYLAND_DISPLAY
|
|
is not set, the default backend becomes
|
|
.IR x11-backend.so .
|
|
.TP
|
|
.B WAYLAND_DEBUG
|
|
If set to any value, causes libwayland to print the live protocol
|
|
to stderr.
|
|
.TP
|
|
.B WAYLAND_DISPLAY
|
|
The name of the display (socket) of an already running Wayland server, without
|
|
the path. The directory path is always taken from
|
|
.BR XDG_RUNTIME_DIR .
|
|
If
|
|
.B WAYLAND_DISPLAY
|
|
is not set, the socket name is "wayland-0".
|
|
|
|
If
|
|
.B WAYLAND_DISPLAY
|
|
is already set, the default backend becomes
|
|
.IR wayland-backend.so .
|
|
This allows launching Weston as a nested server.
|
|
.TP
|
|
.B WAYLAND_SOCKET
|
|
.TP
|
|
.B WESTON_TTY_FD
|
|
.TP
|
|
.B WESTON_LAUNCHER_SOCK
|
|
.TP
|
|
.B XCURSOR_SIZE
|
|
.TP
|
|
.B XDG_CONFIG_HOME
|
|
.TP
|
|
.B XDG_RUNTIME_DIR
|
|
The directory for Weston's socket and lock files.
|
|
Wayland clients will automatically use this.
|
|
.
|
|
.\" ***************************************************************
|
|
.SH DIAGNOSTICS
|
|
.
|
|
.\" ***************************************************************
|
|
.SH BUGS
|
|
Bugs should be reported to the freedesktop.org bugzilla at
|
|
https://bugs.freedesktop.org with product "Wayland" and
|
|
component "weston".
|
|
.
|
|
.\" ***************************************************************
|
|
.SH WWW
|
|
http://wayland.freedesktop.org/
|
|
.
|
|
.\" ***************************************************************
|
|
.SH EXAMPLES
|
|
.IP "Launch Weston with the DRM backend, directly on a VT"
|
|
weston-launch
|
|
.IP "Launch Weston (wayland-1) nested in another Weston instance (wayland-0)"
|
|
WAYLAND_DISPLAY=wayland-0 weston -Swayland-1
|
|
.IP "From an X terminal, launch Weston with the x11 backend"
|
|
weston
|
|
.
|
|
.\" ***************************************************************
|
|
.\".SH "SEE ALSO"
|
|
.\".BR weston-launch (1),
|
|
.\".BR weston.ini (5)
|
|
|