diff options
author | Kenny Levinsen <kl@kl.wtf> | 2021-04-15 23:45:49 +0200 |
---|---|---|
committer | Pekka Paalanen <pq@iki.fi> | 2021-04-27 13:48:24 +0000 |
commit | 16f249db8a439977e8bd2be9b75ce219f37e5c0a (patch) | |
tree | 82c8ce0683f9c369dacfde533c7bdaf1b017de61 | |
parent | 2995f77bd099b2aca072ec1d92cfa28ce79289d1 (diff) | |
download | weston-16f249db8a439977e8bd2be9b75ce219f37e5c0a.tar.gz |
docs: Describe libseat for weston launch
Signed-off-by: Kenny Levinsen <kl@kl.wtf>
-rw-r--r-- | doc/sphinx/toc/running-weston.rst | 24 |
1 files changed, 16 insertions, 8 deletions
diff --git a/doc/sphinx/toc/running-weston.rst b/doc/sphinx/toc/running-weston.rst index c8a24301..08255ce8 100644 --- a/doc/sphinx/toc/running-weston.rst +++ b/doc/sphinx/toc/running-weston.rst @@ -85,14 +85,22 @@ multiple seats. By default Weston will use the default seat named ``seat0``, but there's an option to specify which seat Weston must use by passing ``--seat`` argument. -You can start Weston from a VT, assuming that there's a `logind -<https://www.freedesktop.org/wiki/Software/systemd/logind/>`_ instance running -on the machine. If that's not available, you can use the ``weston-launch`` -application that can handle VT switching. - -Another way of launching Weston is via ssh or a serial terminal but is -currently a pain to do. One way is to run everything as root and issue -``weston --tty 2`` while TTY 2 is active for example. +You can start Weston from a VT assuming that there's a seat manager supported by +`libseat <https://sr.ht/~kennylevinsen/seatd>`_ running, such as ``seatd`` or +`logind <https://www.freedesktop.org/wiki/Software/systemd/logind/>`_. The +backend to be used by ``libseat`` can optionally be selected with +``$LIBSEAT_BACKEND``. If ``libseat`` and ``seatd`` are both installed, but +``seatd`` is not already running, it can be started with ``sudo -- seatd -g +video``. If no seat manager supported by ``libseat`` is available, you can use +the ``weston-launch`` application that can handle VT switching. + +Another way of launching Weston is via ssh or a serial terminal. The simplest +option here is to use the ``libseat`` launcher with ``seatd``. The process for +setting that up is identical to the one described above, where one just need to +ensure that ``seatd`` is running with the appropriate arguments, after which one +can just run ``weston``. Alternatively and as a last resort, one can run Weston +as root, specifying the tty to use on the command line: If TTY 2 is active, one +would run ``weston --tty 2`` as root. Running Weston on a different seat on a stand-alone back-end ------------------------------------------------------------ |