NEWPID(1)

💅 newpid — the manual page, but make it cute

okay bestie, welcome to the newpid manual page (section 1 of the manual, iykyk) — she's small, she's powerful, she's gonna put your little command in a whole new PID namespace. let's get into it 🫶

---

✨ NAME ✨

newpid — launch a command in a new PID namespace 💖

---

🌸 SYNOPSIS 🌸

newpid [-inNu] command

that's it. that's the whole vibe. one command, a lil stack of flags, and a command that gets to live in a brand new world. periodt. ✨

---

🦋 DESCRIPTION 🦋

okay so here's the tea: newpid uses the clone(CLONE_NEWPID) syscall to launch a command in a new PID namespace. that means your command gets to be PID 1 in its own lil universe, main character energy fr fr 👑

and because nobody wants a /proc that's lying to them, the /proc filesystem gets remounted too — so the new process IDs are also visible there. no cap, the numbers actually match now. slay. 💅

---

🎀 OPTIONS 🎀

• -i — use CLONE_NEWIPC to run in a new IPC namespace. separate interprocess-communication world, just for you 🍓
• -n — use CLONE_NEWNET to run in a new network namespace. your own network, your own rules 🌈
• -N newpidname — use CLONE_NEWNET to run in a new network namespace, and join an existing network namespace. the name must start with newpid — that's not a suggestion bestie, that's the rule 😭
• -u — use CLONE_NEWUTS to run in a new UTS namespace. hostname go brrr, but separately ✨

---

🔥 EXAMPLE 🔥

watch her work, she's literally so iconic:

$ newpid ps aux
USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
myon         1  0.0  0.0   4080    84 pts/3    S+   12:15   0:00 newpid ps aux
myon         2  0.0  0.0  19984  1316 pts/3    R+   12:15   0:00 ps aux

see how newpid ps aux is PID 1?? that's the whole point, that's the moment, that's the plot twist 🫶

and here's the network namespace one:

$ ./newpid -n ip link
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN mode DEFAULT group default
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00

just a lil lonely lo in there. no outside world. peaceful honestly 🧚

---

👑 SEE ALSO 👑

go read these next, bestie, they're the extended universe:

• clone(2)
• unshare(1)

---

💜 AUTHOR 💜

written by Christoph Berg <myon@debian.org> — thank you for your service king 🫡

---

okay and that's a wrap on NEWPID(1) — source/version NEWPID(1), dated 2026-01-26. go namespace something, you got this 💖✨🎀🦋🌸💅