2012-11-27 18:54:08 +04:00
|
|
|
.TH WESTON-DRM 7 "2012-11-27" "Weston __version__"
|
|
|
|
.SH NAME
|
|
|
|
weston-drm \- the DRM backend for Weston
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B weston-launch
|
|
|
|
.LP
|
|
|
|
.B weston --backend=drm-backend.so
|
|
|
|
.
|
|
|
|
.\" ***************************************************************
|
|
|
|
.SH DESCRIPTION
|
|
|
|
The DRM backend is the native Weston backend for systems that support
|
|
|
|
the Linux kernel DRM, kernel mode setting (KMS), and evdev input devices.
|
|
|
|
It is the recommended backend for desktop PCs, and aims to provide
|
|
|
|
the full Wayland experience with the "every frame is perfect" concept.
|
|
|
|
It also relies on the Mesa GBM interface.
|
|
|
|
|
|
|
|
With the DRM backend,
|
|
|
|
.B weston
|
|
|
|
runs without any underlying windowing system. The backend uses the
|
|
|
|
Linux KMS API to detect connected monitors. Monitor hot-plugging is
|
|
|
|
supported. Input devices are found automatically by
|
|
|
|
.BR udev (7).
|
|
|
|
Compositing happens mainly in GL\ ES\ 2, initialized through EGL. It
|
|
|
|
is also possible to take advantage of hardware cursors and overlays,
|
|
|
|
when they exist and are functional. Full-screen surfaces will be
|
|
|
|
scanned out directly without compositing, when possible.
|
|
|
|
Hardware accelerated clients are supported via EGL.
|
|
|
|
|
|
|
|
The backend chooses the DRM graphics device first based on seat id.
|
|
|
|
If seat identifiers are not set, it looks for the graphics device
|
|
|
|
that was used in boot. If that is not found, it finally chooses
|
|
|
|
the first DRM device returned by
|
|
|
|
.BR udev (7).
|
|
|
|
Combining multiple graphics devices are not supported yet.
|
|
|
|
|
|
|
|
The DRM backend relies on
|
|
|
|
.B weston-launch
|
|
|
|
for managing input device access and DRM master status, so that
|
|
|
|
.B weston
|
|
|
|
can be run without root privileges. On switching away from the
|
|
|
|
virtual terminal (VT) hosting Weston, all input devices are closed and
|
|
|
|
the DRM master capability is dropped, so that other servers,
|
|
|
|
including
|
|
|
|
.BR Xorg (1),
|
|
|
|
can run on other VTs. On switching back to Weston's VT, input devices
|
|
|
|
and DRM master are re-acquired through the parent process
|
|
|
|
.BR weston-launch .
|
|
|
|
.
|
|
|
|
.\" ***************************************************************
|
|
|
|
.SH CONFIGURATION
|
|
|
|
.
|
|
|
|
The DRM backend uses the following entries from
|
|
|
|
.BR weston.ini .
|
|
|
|
.SS Section output
|
|
|
|
.TP
|
|
|
|
\fBname\fR=\fIconnector\fR
|
|
|
|
The KMS connector name identifying the output, for instance
|
|
|
|
.IR LVDS1 .
|
|
|
|
.TP
|
|
|
|
\fBmode\fR=\fImode\fR
|
|
|
|
Specify the video mode for the output. The argument
|
|
|
|
.I mode
|
|
|
|
can be one of the words
|
|
|
|
.BR off " to turn the output off, "
|
|
|
|
.BR preferred " to use the monitor's preferred video mode, or "
|
|
|
|
.BR current " to use the current video mode and avoid a mode switch."
|
|
|
|
It can also be a resolution as
|
|
|
|
\fIwidth\fBx\fIheight\fR, or a detailed mode line as below.
|
|
|
|
.TP
|
|
|
|
\fBmode\fR=\fIdotclock hdisp hsyncstart hsyncend htotal \
|
|
|
|
vdisp vsyncstart vsyncend vtotal hflag vflag\fR
|
|
|
|
Use the given detailed mode line as the video mode for this output.
|
|
|
|
The definition is the same as in
|
|
|
|
.BR xorg.conf "(5), and " cvt (1)
|
|
|
|
can generate detailed mode lines.
|
|
|
|
.TP
|
|
|
|
\fBtransform\fR=\fItransform\fR
|
|
|
|
Transform for the output, which can be rotated in 90-degree steps
|
|
|
|
and possibly flipped. Possible values are
|
|
|
|
.BR normal ", " 90 ", " 180 ", " 270 ", "
|
|
|
|
.BR flipped ", " flipped-90 ", " flipped-180 ", and " flipped-270 .
|
2018-04-23 12:44:59 +03:00
|
|
|
.TP
|
|
|
|
\fBpixman-shadow\fR=\fIboolean\fR
|
|
|
|
If using the Pixman-renderer, use shadow framebuffers. Defaults to
|
|
|
|
.BR true .
|
2017-11-03 10:56:05 +03:00
|
|
|
.TP
|
|
|
|
\fBsame-as\fR=\fIname\fR
|
|
|
|
Make this output (connector) a clone of another. The argument
|
|
|
|
.IR name " is the "
|
|
|
|
.BR name " value of another output section. The
|
|
|
|
referred to output section must exist. When this key is present in an
|
|
|
|
output section, all other keys have no effect on the configuration.
|
|
|
|
|
|
|
|
NOTE: cms-colord plugin does not work correctly with this option. The plugin
|
|
|
|
chooses an arbitrary monitor to load the color profile for, but the
|
|
|
|
profile is applied equally to all cloned monitors regardless of their
|
|
|
|
properties.
|
2018-05-23 14:34:36 +03:00
|
|
|
.TP
|
|
|
|
\fBforce-on\fR=\fItrue\fR
|
|
|
|
Force the output to be enabled even if the connector is disconnected.
|
|
|
|
Defaults to false. Note that
|
|
|
|
.BR mode=off " will override " force-on=true .
|
|
|
|
When a connector is disconnected, there is no EDID information to provide
|
|
|
|
a list of video modes. Therefore a forced output should also have a
|
|
|
|
detailed mode line specified.
|
2012-11-27 18:54:08 +04:00
|
|
|
.
|
|
|
|
.\" ***************************************************************
|
|
|
|
.SH OPTIONS
|
|
|
|
.
|
|
|
|
When the DRM backend is loaded,
|
|
|
|
.B weston
|
|
|
|
will understand the following additional command line options.
|
|
|
|
.TP
|
|
|
|
.B \-\-current\-mode
|
|
|
|
By default, use the current video mode of all outputs, instead of
|
|
|
|
switching to the monitor preferred mode.
|
|
|
|
.TP
|
2017-03-28 18:14:37 +03:00
|
|
|
\fB\-\-drm\-device\fR=\fIcardN\fR
|
|
|
|
Use the DRM device
|
|
|
|
.I cardN
|
|
|
|
instead of the default heuristics based on seat assignments and boot VGA
|
|
|
|
status. For example, use
|
|
|
|
.BR card0 .
|
|
|
|
.TP
|
2012-11-27 18:54:08 +04:00
|
|
|
\fB\-\-seat\fR=\fIseatid\fR
|
|
|
|
Use graphics and input devices designated for seat
|
|
|
|
.I seatid
|
2018-06-29 15:17:46 +03:00
|
|
|
instead of the seat defined in the environment variable
|
|
|
|
.BR XDG_SEAT ". If neither is specifed, seat0 will be assumed."
|
2012-11-27 18:54:08 +04:00
|
|
|
.TP
|
|
|
|
\fB\-\-tty\fR=\fIx\fR
|
|
|
|
Launch Weston on tty
|
|
|
|
.I x
|
|
|
|
instead of using the current tty.
|
|
|
|
.
|
|
|
|
.\" ***************************************************************
|
|
|
|
.SH ENVIRONMENT
|
|
|
|
.
|
|
|
|
.TP
|
2018-02-05 17:20:51 +03:00
|
|
|
.B WESTON_LIBINPUT_LOG_PRIORITY
|
|
|
|
The minimum libinput verbosity level to be printed to Weston's log.
|
|
|
|
Valid values are
|
|
|
|
.BR debug ", " info ", and " error ". Default is " info .
|
|
|
|
.TP
|
2012-11-27 18:54:08 +04:00
|
|
|
.B WESTON_TTY_FD
|
|
|
|
The file descriptor (integer) of the opened tty where
|
|
|
|
.B weston
|
|
|
|
will run. Set by
|
|
|
|
.BR weston-launch .
|
|
|
|
.TP
|
|
|
|
.B WESTON_LAUNCHER_SOCK
|
|
|
|
The file descriptor (integer) where
|
|
|
|
.B weston-launch
|
|
|
|
is listening. Automatically set by
|
|
|
|
.BR weston-launch .
|
2018-06-29 15:17:46 +03:00
|
|
|
.TP
|
|
|
|
.B XDG_SEAT
|
|
|
|
The seat Weston will start on, unless overridden on the command line.
|
2012-11-27 18:54:08 +04:00
|
|
|
.
|
|
|
|
.\" ***************************************************************
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR weston (1)
|
|
|
|
.\".BR weston-launch (1),
|
|
|
|
.\".BR weston.ini (5)
|