.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "seatd-launch" "1" "2024-10-30"
.PP
.SH NAME
.PP
seatd-launch - Start a process with its own seatd instance
.PP
.SH SYNOPSIS
.PP
\fBseatd-launch\fR [options] [--] command
.PP
.SH OPTIONS
.PP
\fB-l <loglevel>\fR
.RS 4
Log-level to pass to seatd.\& See \fBseatd\fR(1) for information about
available log-levels.\&
.PP
.RE
\fB-h\fR
.RS 4
Show help message and quit.\&
.PP
.RE
\fB-v\fR
.RS 4
Show the version number and quit.\&
.PP
.RE
.SH DESCRIPTION
.PP
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.\&
.PP
seatd requires root privileges to perform its tasks.\& This can be achieved
through SUID of seatd-launch 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.\& You
should only run seatd-launch as root if you intend for the specified command to
run as root as well.\&
.PP
seatd-launch serves a similar purpose to the libseat "builtin" backend, but is
superior to it for two reasons:
.PD 0
.IP 1. 4
The specified command never runs as root
.IP 2. 4
The standard seatd executable and libseat backend is used
.PD
.PP
.SH EXIT STATUS
.PP
seatd-launch exits with the status of its child.\& When the child terminates on
a signal \fIN\fR, seatd-launch exits with the status 128 + \fIN\fR.\&
.PP
If seatd-launch fails because of another error, it exits with a non-zero
status.\&
.PP
.SH SEE ALSO
.PP
The libseat library, \fB<libseat.\&h>\fR, \fBseatd\fR(1)
.PP
.SH AUTHORS
.PP
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.\&