.\" Generated by scdoc 1.11.5
.\" 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" "2026\-08\-29"
.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/\(tikennylevinsen/seatd.\&