.\" Generated by scdoc 1.11.2
.\" 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" "2023-07-23"
.P
.SH NAME
.P
seatd-launch - Start a process with its own seatd instance
.P
.SH SYNOPSIS
.P
\fBseatd-launch\fR [options] [--] command
.P
.SH OPTIONS
.P
\fB-l <loglevel>\fR
.RS 4
Log-level to pass to seatd.\& See \fBseatd\fR(1) for information about
available log-levels.\&
.P
.RE
\fB-h\fR
.RS 4
Show help message and quit.\&
.P
.RE
\fB-v\fR
.RS 4
Show the version number and quit.\&
.P
.RE
.SH DESCRIPTION
.P
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.\&
.P
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.\&
.P
seatd-launch serves a similar purpose to the libseat "builtin" backend, but is
superior to it for two reasons:
.RS 4
.ie n \{\
\h'-04'1.\h'+03'\c
.\}
.el \{\
.IP 1. 4
.\}
The specified command never runs as root
.RE
.RS 4
.ie n \{\
\h'-04'2.\h'+03'\c
.\}
.el \{\
.IP 2. 4
.\}
The standard seatd executable and libseat backend is used

.RE
.P
.SH EXIT STATUS
.P
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.\&
.P
If seatd-launch fails because of another error, it exits with a non-zero
status.\&
.P
.SH SEE ALSO
.P
The libseat library, \fB<libseat.\&h>\fR, \fBseatd\fR(1)
.P
.SH AUTHORS
.P
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.\&