pidfd_create(9)

✨ NAME ✨

pidfd_create — Create a new pid file descriptor. 💅

Okay so this is the pidfd_create(9) page from the Kernel API Manual, and we’re gonna get you comfy with it, bestie. 🫶

---

📜 SYNOPSIS 📜

int pidfd_create (struct pid *pid , unsigned int flags );

---

🧾 ARGUMENTS 🧾

• pid — the struct pid that the pidfd will reference 💖
• flags — flags to pass ✨

---

💫 DESCRIPTION 💫

This creates a new pid file descriptor with the O_CLOEXEC flag set. Slay. ✨

Note, that this function can only be called after the fd table has been unshared to avoid leaking the pidfd to the new process. 👀 Like, read that twice. It matters.

🚨 This symbol should not be explicitly exported to loadable modules. Periodt. 💅

---

🎁 RETURN 🎁

On success, a cloexec pidfd is returned. 🎀 On error, a negative errno number will be returned. 😭

---

👀 SEE ALSO 👀

• Kernel file ./kernel/pid.c 🧚
• pidfd_get_task(9) 🦋
• sys_pidfd_open(9) 🌸
• sys_pidfd_getfd(9) 🌈

---

That’s the whole page, bestie: source/version ./kernel, dated October 2026 — mwah 💋