1 .TH WESTON 1 "2012-11-27" "Weston __version__"
3 weston \- the reference Wayland server
7 .\" ***************************************************************
10 is the reference implementation of a Wayland server. A Wayland server is a
11 display server, a window manager, and a compositor all in one. Weston has
12 several backends as loadable modules: it can run on Linux KMS (kernel
13 modesetting via DRM), as an X client, or inside another Wayland server
16 Weston supports fundamentally different graphical user interface paradigms via
17 shell plugins. Two plugins are provided: the desktop shell, and the tablet
20 When weston is started as the first windowing system (i.e. not under X nor
21 under another Wayland server), it should be done with the command
23 to set up proper privileged access to devices.
25 Weston also supports X clients via
26 .BR XWayland ", see below."
28 .\" ***************************************************************
32 The DRM backend uses Linux KMS for output and evdev devices for input.
33 It supports multiple monitors in a unified desktop with DPMS. See
38 The Wayland backend runs on another Wayland server, a different Weston
39 instance, for example. Weston shows up as a single desktop window on
43 The X11 backend runs on an X server. Each Weston output becomes an
44 X window. This is a cheap way to test multi-monitor support of a
45 Wayland shell, desktop, or applications.
47 .\" ***************************************************************
51 Desktop shell is like a modern X desktop environment, concentrating
52 on traditional keyboard and mouse user interfaces and the familiar
53 desktop-like window management. Desktop shell consists of the
56 and the special client
57 .B weston-desktop-shell
58 which provides the wallpaper, panel, and screen locking dialog.
61 Tablet shell is a graphical user interface aimed for tablet-like
62 devices, where usually the only input method is a touch screen.
63 It does not support freely floating windows or many other desktop
64 features, but intends to provide a natural interface on tablets.
65 Tablet shell consists of the shell plugin
67 and the special client
68 .B weston-tablet-shell
69 which provides the basic user interface.
71 .\" ***************************************************************
73 XWayland requires a special X.org server to be installed. This X server will
74 connect to a Wayland server as a Wayland client, and X clients will connect to
75 the X server. XWayland provides backwards compatibility to X applications in a
78 XWayland is activated by instructing
79 .BR weston " to load " xwayland.so " module, see " EXAMPLES .
80 Weston starts listening on a new X display socket, and exports it in the
83 When the first X client connects, Weston launches a special X server as a
84 Wayland client to handle the X client and all future X clients.
86 It has also its own X window manager where cursor themes and sizes can be
90 .BR XCURSOR_SIZE " environment variables. See " ENVIRONMENT .
92 .\" ***************************************************************
95 .SS Weston core options:
97 \fB\-\^B\fR\fIbackend.so\fR, \fB\-\-backend\fR=\fIbackend.so\fR
100 instead of the default backend. The file is searched for in
101 .IR "__weston_modules_dir__" ,
102 or you can pass an absolute path. The default backend is
103 .I __weston_native_backend__
104 unless the environment suggests otherwise, see
105 .IR DISPLAY " and " WAYLAND_DISPLAY .
108 Print the program version.
110 .BR \-\^h ", " \-\-help
111 Print a summary of command line options, and quit.
113 \fB\-\^i\fR\fIN\fR, \fB\-\-idle\-time\fR=\fIN\fR
114 Set the idle timeout to
116 seconds. The default timeout is 300 seconds. When there has not been any
117 user input for the idle timeout, Weston enters an inactive mode. The
118 screen fades to black, and depending on the shell in use, a screensaver
119 may activate, monitors may switch off, and the shell may lock the session.
120 A value of 0 effectively disables the timeout.
122 \fB\-\-log\fR=\fIfile.log\fR
123 Append log messages to the file
125 instead of writing them to stderr.
127 \fB\-\-modules\fR=\fImodule1.so,module2.so\fR
128 Load the comma-separated list of modules. Only used by the test
129 suite. The file is searched for in
130 .IR "__weston_modules_dir__" ,
131 or you can pass an absolute path.
133 \fB\-\^S\fR\fIname\fR, \fB\-\-socket\fR=\fIname\fR
134 Weston will listen in the Wayland socket called
138 with this value in the environment for all child processes to allow them to
139 connect to the right server automatically.
140 .SS DRM backend options:
144 .SS Wayland backend options:
146 \fB\-\-display\fR=\fIdisplay\fR
147 Name of the Wayland display to connect to, see also
152 Create a single fullscreen output
154 \fB\-\-output\-count\fR=\fIN\fR
157 Wayland windows to emulate the same number of outputs.
159 \fB\-\-width\fR=\fIW\fR, \fB\-\-height\fR=\fIH\fR
160 Make all outputs have a size of
163 .B \-\-scale\fR=\fIN\fR
164 Give all outputs a scale factor of
168 Use the pixman renderer. By default, weston will try to use EGL and
169 GLES2 for rendering and will fall back to the pixman-based renderer for
170 software compositing if EGL cannot be used. Passing this option will force
171 weston to use the pixman renderer.
173 .SS X11 backend options:
178 Do not provide any input devices. Used for testing input-less Weston.
180 \fB\-\-output\-count\fR=\fIN\fR
183 X windows to emulate the same number of outputs.
185 \fB\-\-width\fR=\fIW\fR, \fB\-\-height\fR=\fIH\fR
186 Make the default size of each X window
189 .B \-\-scale\fR=\fIN\fR
190 Give all outputs a scale factor of
194 Use the pixman renderer. By default weston will try to use EGL and
195 GLES2 for rendering. Passing this option will make weston use the
196 pixman library for software compsiting.
198 .\" ***************************************************************
201 If the environment variable is set, the configuration file is read
202 from the respective path, or the current directory if neither is set.
204 .BI $XDG_CONFIG_HOME /weston.ini
206 .BI $HOME /.config/weston.ini
211 .\" ***************************************************************
220 is not set, the default backend becomes
224 If set to any value, causes libwayland to print the live protocol
228 The name of the display (socket) of an already running Wayland server, without
229 the path. The directory path is always taken from
230 .BR XDG_RUNTIME_DIR .
233 is not set, the socket name is "wayland-0".
237 is already set, the default backend becomes
238 .IR wayland-backend.so .
239 This allows launching Weston as a nested server.
242 For Wayland clients, holds the file descriptor of an open local socket
246 Set the list of paths to look for cursors in. It changes both
247 libwayland-cursor and libXcursor, so it affects both Wayland and X11 based
253 This variable can be set for choosing an specific size of cursor. Affect
254 Wayland and X11 clients. See
259 If set, specifies the directory where to look for
263 The directory for Weston's socket and lock files.
264 Wayland clients will automatically use this.
266 .\" ***************************************************************
268 Weston has a segmentation fault handler, that attempts to restore
269 the virtual console or ungrab X before raising
272 .BR weston " under " gdb (1)
273 from an X11 terminal or a different virtual terminal, and tell gdb
275 handle SIGSEGV nostop
277 This will allow weston to switch back to gdb on crash and then
278 gdb will catch the crash with SIGTRAP.
280 .\" ***************************************************************
282 Bugs should be reported to the freedesktop.org bugzilla at
283 https://bugs.freedesktop.org with product "Wayland" and
286 .\" ***************************************************************
288 http://wayland.freedesktop.org/
290 .\" ***************************************************************
292 .IP "Launch Weston with the DRM backend on a VT"
294 .IP "Launch Weston with the DRM backend and XWayland support"
295 weston-launch -- --modules=xwayland.so
296 .IP "Launch Weston (wayland-1) nested in another Weston instance (wayland-0)"
297 WAYLAND_DISPLAY=wayland-0 weston -Swayland-1
298 .IP "From an X terminal, launch Weston with the x11 backend"
301 .\" ***************************************************************
304 .\".BR weston-launch (1),
305 .\".BR weston.ini (5)