aboutsummaryrefslogtreecommitdiff
path: root/man/seatd-launch.1.scd
diff options
context:
space:
mode:
Diffstat (limited to 'man/seatd-launch.1.scd')
-rw-r--r--man/seatd-launch.1.scd49
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.