PFIND(9)

✨ PFIND(9) ✨

okay so this is a page from the Kernel Developer's Manual (yes, the kernel one, we're in the big leagues bestie 💅) and it's all about pfind and zpfind — the little duo that helps you locate a process by number. iykyk 🌸

---

🎀 NAME 🎀

pfind, zpfind — locate a process by number

---

🦋 SYNOPSIS 🦋

#include <sys/param.h>
#include <sys/proc.h>

struct proc *
pfind(pid_t pid);

struct proc *
zpfind(pid_t pid);

like, just include those two headers and you're literally ready to go ✨

---

💖 DESCRIPTION 💖

so pfind() takes a pid as its argument, and it returns a pointer to the proc structure whose PID is specified in the argument — but only if that pid is on the allproc list. no allproc, no pointer. that's the vibe check 🫶

then there's zpfind(), which also takes a pid as its argument. if zpfind() finds a process whose PID is equal to that of the argument and it's a zombie process — meaning it must reside on the zombproc list — then zpfind() returns a pointer to that proc structure. zombies stay on the zombproc list, that's just how it is 🧟‍♀️

and listen: both pfind() and zpfind() lock the proc structure that is returned, using PROC_LOCK(p). so the thing you get back comes pre-locked, no cap 🔥

---

👑 RETURN VALUES 👑

• pfind() and zpfind() return a pointer to a proc structure on success 💖
• and NULL on failure 😭

that's it, that's the whole return story, periodt.

---

🌈 SEE ALSO 🌈

• pgfind(9)

(the sibling page, go say hi ✨)

---

💜 AUTHORS 💜

This manual page was written by Evan Sarmiento <kaworu@sektor7.ath.cx>. iconic behavior fr fr 👑

---

quick reminder bestie: these return a locked proc — don't forget you're holding that lock, mkay? 🎀

---

and that's the whole page!! 🌟 this Debian edition dropped on July 11, 2001 (a vintage baddie 💅) — mwah, go read pgfind(9) next, ily 🫶💖