.\" 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 "SYD\-RUN" "1" "2026\-09\-01"
.PP
.SH NAME
.PP
\fBsyd\-run\fR \- Run a program inside a container with the given process ID
.PP
.SH SYNOPSIS
.PP
\fBsyd\-run\fR \fI[\-hvacimnptuU]\fR \fIpid\fR \fI{command [arg.\&.\&.\&]}\fR
.PP
.SH DESCRIPTION
.PP
The \fIsyd\-run\fR(1) utility runs a program inside a \fIsyd\fR(1) container with
the given process ID.\& This requires the use of system calls \fIsetns\fR(2),
and \fIpidfd_open\fR(2) which require Linux\-5.\&8 or newer.\& Entering
\fIpid_namespaces\fR(7) and \fItime_namespaces\fR(7) is a privileged operation,
whereas entering \fIcgroup_namespaces\fR(7), \fIipc_namespaces\fR(7),
\fImount_namespaces\fR(7), \fInetwork_namespaces\fR(7), and \fIuts_namespaces\fR(7)
is unprivileged when combined with \fIuser_namespaces\fR(7) provided that
unprivileged \fIuser_namespaces\fR(7) support is enabled in the Linux
kernel.\&
.PP
.SH OPTIONS
.PP
.TS
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx.
T{
\fB\-h\fR
T}	T{
Display help.\&
T}
T{
\fB\-v\fR
T}	T{
Be verbose.\& Print informational messages on standard error.\&
T}
T{
\fB\-a\fR
T}	T{
Auto\-detect namespaces to enter.\& PID and Time namespaces are excluded.\& This is the default.\&
T}
T{
\fB\-c\fR
T}	T{
Enter into CGroup namespace.\&
T}
T{
\fB\-i\fR
T}	T{
Enter into IPC namespace.\&
T}
T{
\fB\-m\fR
T}	T{
Enter into mount namespace.\&
T}
T{
\fB\-n\fR
T}	T{
Enter into network namespace.\&
T}
T{
\fB\-p\fR
T}	T{
Enter into PID namespace.\&
T}
T{
\fB\-t\fR
T}	T{
Enter into time namespace.\&
T}
T{
\fB\-u\fR
T}	T{
Enter into UTS namespace.\&
T}
T{
\fB\-U\fR
T}	T{
Enter into user namespace.\&
T}
.TE
.sp 1
.SH EXIT STATUS
.PP
On clean exit, \fIsyd\-run\fR(1) exits with the same code as the child
process.\& On unclean termination, exit code is set to 128 plus signal
number.\& In case executing the child process fails \fIsyd\-run\fR(1) exits
with the \fIerrno\fR(3) number.\&
.PP
.SH SEE ALSO
.PP
\fIsyd\fR(1), \fIsyd\fR(2), \fIsyd\fR(5), \fIsetns\fR(2), \fIpidfd_open\fR(2)
.PP
\fBsyd\fR homepage: https://sydbox.\&exherbo.\&org/
.PP
.SH AUTHORS
.PP
Maintained by Ali Polatel.\& Up\-to\-date sources can be found at
https://gitlab.\&exherbo.\&org/sydbox/sydbox.\&git and on Radicle at
rad:z38HCnbmcDegA2BMxuPaPRPMdp6wF.\& Bugs/patches can be submitted to
https://gitlab.\&exherbo.\&org/groups/sydbox/\-/issues.\& Discuss in #sydbox on Libera
Chat or in #sydbox:mailstation.\&de on Matrix.\&