TFIND(9)

🦋 TFIND(9) — Kernel Developer’s Manual, but make it bestie-core 🦋

okay so this is the tfind(9) page from the Kernel Developer’s Manual, and we’re about to make thread/process/process-group lookups make sense. no cap. 💅

---

🌸 NAME 🌸

tfind, prfind, pgfind — find thread, process and process group by number, bestie. 🎀

---

✨ SYNOPSIS ✨

#include <sys/types.h>
#include <sys/signal.h>
#include <sys/proc.h>

struct proc *
tfind(pid_t tid);

struct process *
prfind(pid_t pid);

struct pgrp *
pgfind(pid_t pgid);

---

💖 DESCRIPTION 💖

okay so these three functions are your little lookup besties: tfind(), prfind(), and pgfind() retrieve thread, process and process group structures from thread, process and process group IDs, respectively. 🫶

so like: tfind() is giving thread-structure-by-tid, prfind() is giving process-structure-by-pid, and pgfind() is giving process-group-structure-by-pgid. iconic mapping, fr fr. 🌈

and if the requested ID can’t be found? these functions return NULL. that’s the vibe check result: not found, bestie. 💀

---

🔥 CODE REFERENCES 🔥

those functions are implemented in the file sys/kern/kern_proc.c. go peek if you want the lore. 👑

---

mwah 💋 — source/version: Debian; date: June 13, 2025. bye bestie 🫶✨