diff options
Diffstat (limited to 'man/seatd-launch.1.scd')
| -rw-r--r-- | man/seatd-launch.1.scd | 49 |
1 files changed, 49 insertions, 0 deletions
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 <path>* + 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, *<libseat.h>*, *seatd(1)* + +# AUTHORS + +Maintained by Kenny Levinsen <contact@kl.wtf>, who is assisted by other +open-source contributors. For more information about seatd development, see +https://sr.ht/~kennylevinsen/seatd. |