SYD-RUN(1)

💅 SYD-RUN(1) — the group-chat guide 💅

okay so this is a page from the General Commands Manual bestie, section 1, and it's called syd-run. pull up a chair 🎀

---

✨ NAME ✨

syd-run — run a program inside a container with the given process ID 🫶

---

🌸 SYNOPSIS 🌸

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

like, that's the whole shape of it. a bunch of lil flags, a pid, and then your command with whatever arg... you feel like throwing at it 💖

---

🦋 DESCRIPTION 🦋

so the syd-run(1) utility runs a program inside a syd(1) container with the process ID you hand it. iconic behaviour, no cap 👑

this whole thing requires the use of the system calls setns(2) and pidfd_open(2), which — heads up — need Linux-5.8 or newer ⭐

now here's the vibe check on privileges, because this part matters:

• entering pid_namespaces(7) and time_namespaces(7) is a privileged operation 🔥
• entering cgroup_namespaces(7), ipc_namespaces(7), mount_namespaces(7), network_namespaces(7), and uts_namespaces(7) is unprivileged when combined with user_namespaces(7) — provided that unprivileged user_namespaces(7) support is enabled in the Linux kernel 🧚

so yeah, some namespaces are gatekept and some are just vibes, but the unprivileged ones come with a condition attached. read the fine print bestie 💀

---

💜 OPTIONS 💜

• -h — Display help. the classic "girl help" but make it a flag 🙈
• -v — Be verbose. Print informational messages on standard error. she's chatty and she's telling you everything on stderr 💅
• -a — Auto-detect namespaces to enter. PID and Time namespaces are excluded. This is the default. so it picks for you, minus PID and Time ✨
• -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 🔥

• clean exit — syd-run(1) exits with the same code as the child process. matching energy, literally 🫶
• unclean termination — exit code is set to 128 plus the signal number 😭
• if executing the child process fails — syd-run(1) exits with the errno(3) number 💀

---

🌟 SEE ALSO 🌟

syd(1), syd(2), syd(5), setns(2), pidfd_open(2)

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 💬

---

okay that's the whole page, you ate that 🎀 this was the General Commands Manual version dated 2026-09-01, page SYD-RUN(1) — go forth and containerise, bestie 💅✨