aboutsummaryrefslogtreecommitdiff
path: root/sysutils/seatd/files/pkg-message.in
blob: ce9f84223c62507bbd7ed3900d5a52efd4ebff45 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
[
{ type: install
  message: <<EOM
libseat is used to get DRM master and input devices for non-root users.
On Wayland this is only necessary when starting a compositor under KMS
console (e.g., /dev/ttyv0 backed by /dev/dri/card0). Nested sessions like
"Wayland on X11" or "Wayland on Wayland" don't need extra configuration.

By default libseat tries to find the first working backend. To override
set LIBSEAT_BACKEND via environ(7). Available backends and try order:

* "seatd" - seatd-launch(1) or seatd rc.d(8) service
%%BASU%%* "consolekit2" - ck-launch-session(1) or pam_ck_connector(8)

"seatd" backend requires membership in "video" group to be allowed to
use setuid bit in seatd-launch(1) or connect to seatd(1) socket.

  # pw groupmod video -m <user>
  $ exit # log out to refresh group permissions

For example, to start a wlroots-based compositor replace "sway" with
your compositor (e.g., "hikari", "wayfire", "labwc", "river") then run

  $ seatd-launch sway

Alternatively, configure and run seatd(1) as system service

  # sysrc seatd_enable=YES
  # service seatd start
  $ sway

%%BASU%%To use ConsoleKit2 run
%%BASU%%
%%BASU%%  # pkg install consolekit2 basu
%%BASU%%  # sysrc -x seatd_enable
%%BASU%%  # service seatd stop
%%BASU%%  # sysrc dbus_enable=YES
%%BASU%%  # service dbus start
%%BASU%%  $ ck-launch-session sway
%%BASU%%
%%BASU%%where "ck-launch-session" can be dropped after
%%BASU%%
%%BASU%%  # echo "session optional pam_ck_connector.so" >>/etc/pam.d/system
%%BASU%%  $ exit # log out to re-trigger PAM
EOM
}
]