From e7343ca96f3a59a4e5c846000d37b72f440afd44 Mon Sep 17 00:00:00 2001 From: Kenny Levinsen Date: Wed, 8 Sep 2021 20:41:48 +0200 Subject: man: Add simple seatd-launch(1) page --- man/seatd-launch.1.scd | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ meson.build | 2 +- 2 files changed, 50 insertions(+), 1 deletion(-) create mode 100644 man/seatd-launch.1.scd diff --git a/man/seatd-launch.1.scd b/man/seatd-launch.1.scd new file mode 100644 index 0000000..7994692 --- /dev/null +++ b/man/seatd-launch.1.scd @@ -0,0 +1,49 @@ +seatd-launch(1) + +# NAME + +seatd-launch - Start a process with its own seatd instance + +# SYNOPSIS + +*seatd-launch* [options] [--] command + +# OPTIONS + +*-h* + Show help message and quit. + +*-s * + Where to create the seatd socket. Defaults to a unique file path. + +*-v* + Show the version number and quit. + +# DESCRIPTION + +seatd-launch starts a seatd instance with a dedicated socket path, waits for it +to be ready, and starts the specified command with SEATD_SOCK set +appropriately. Once the specified command terminates, the seatd instance is +also terminated. + +seatd requires root privileges to perform its tasks. This can be achieved +through SUID of seatd-launch, *sudo(8)*/*doas(1)*, or by running seatd-launch +as root. seatd-launch will drop privileges from the effective user to the real +user before running the specified command. If the real user is root, this is +simply a noop - only run directly as root if you intend for the specified +command to run as root as well. + +seatd-launch serves a similar purpose to the libseat "builtin" backend, but is +superior to it for two reasons: +. The specified command never runs as root +. The standard seatd executable and libseat backend is used + +# SEE ALSO + +The libseat library, **, *seatd(1)* + +# AUTHORS + +Maintained by Kenny Levinsen , who is assisted by other +open-source contributors. For more information about seatd development, see +https://sr.ht/~kennylevinsen/seatd. diff --git a/meson.build b/meson.build index 17324ec..6b2ca2f 100644 --- a/meson.build +++ b/meson.build @@ -247,7 +247,7 @@ if scdoc.found() scdoc_prog = find_program(scdoc.get_variable(pkgconfig: 'scdoc'), native: true) mandir = get_option('mandir') - foreach src : ['seatd.1.scd'] + foreach src : ['seatd.1.scd', 'seatd-launch.1.scd'] topic = src.split('.')[0] section = src.split('.')[1] output = '@0@.@1@'.format(topic, section) -- cgit v1.2.3