freebsd-ports/sysutils/seatd/files/pkg-message.in
Jan Beich 0958855771 sysutils/seatd: document common usage
In wlroots affects WLR_BACKENDS=drm,libinput (default on console).
Weston also supports libseat but hasn't been tested.

PR:		258664
Submitted by:	Evgeniy Khramtsov <evgeniy@khramtsov.org> (based on)
2021-09-24 17:22:01 +00:00

47 lines
1.5 KiB
Text

[
{ 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
}
]