---
name: "syd-run"
section: "1"
platform: "linux"
package: "syd"
version: "3.59.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/syd-run"
---

# syd-run(1)

Run a program inside a container with the given process ID

## NAME

**syd-run** - Run a program inside a container with the given process ID

## SYNOPSIS

**syd-run** *\[-hvacimnptuU\]* *pid* *{command \[arg...\]}*

## DESCRIPTION

The [*syd-run*(1)](/syd-run/1.md) utility runs a program inside a [*syd*(1)](/syd/1.md) container with the given process ID. This requires the use of system calls [*setns*(2)](/setns/2.md), and [*pidfd\_open*(2)](/pidfd_open/2.md) which require Linux-5.8 or newer. Entering [*pid\_namespaces*(7)](/pid_namespaces/7.md) and [*time\_namespaces*(7)](/time_namespaces/7.md) is a privileged operation, whereas entering [*cgroup\_namespaces*(7)](/cgroup_namespaces/7.md), [*ipc\_namespaces*(7)](/ipc_namespaces/7.md), [*mount\_namespaces*(7)](/mount_namespaces/7.md), [*network\_namespaces*(7)](/network_namespaces/7.md), and [*uts\_namespaces*(7)](/uts_namespaces/7.md) is unprivileged when combined with [*user\_namespaces*(7)](/user_namespaces/7.md) provided that unprivileged [*user\_namespaces*(7)](/user_namespaces/7.md) support is enabled in the Linux kernel.

## OPTIONS

| | |
| --- | --- |
| **-h** | Display help. |
| **-v** | Be verbose. Print informational messages on standard error. |
| **-a** | Auto-detect namespaces to enter. PID and Time namespaces are excluded. This is the default. |
| **-c** | Enter into CGroup namespace. |
| **-i** | Enter into IPC namespace. |
| **-m** | Enter into mount namespace. |
| **-n** | Enter into network namespace. |
| **-p** | Enter into PID namespace. |
| **-t** | Enter into time namespace. |
| **-u** | Enter into UTS namespace. |
| **-U** | Enter into user namespace. |

## EXIT STATUS

On clean exit, [*syd-run*(1)](/syd-run/1.md) 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 [*syd-run*(1)](/syd-run/1.md) exits with the [*errno*(3)](/errno/3.md) number.

## SEE ALSO

[*syd*(1)](/syd/1.md), [*syd*(2)](/syd/2.md), [*syd*(5)](/syd/5.md), [*setns*(2)](/setns/2.md), [*pidfd\_open*(2)](/pidfd_open/2.md)

**syd** homepage: https://sydbox.exherbo.org/

## AUTHORS

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.