pids_try_charge(9)

💅 pids_try_charge — a kernel API manual page, bestie edition 🎀

okay so real talk, we're in the pids_try_charge(9) page from the Kernel API Manual, and honestly? she's doing the most and we stan. let's get into it ✨

---

✨ NAME ✨

pids_try_charge — the girlie who hierarchically tries to charge the pid count. yes bestie, hierarchically. it's giving "i asked my mom, and my mom asked her mom." 🧚

---

🌸 SYNOPSIS 🌸

int pids_try_charge (struct pids_cgroup *pids , int num , struct
pids_cgroup **fail );

look at her. three little args and a whole lot of attitude. 💅

---

🦋 ARGUMENTS 🦋

• pids — the pid cgroup state, aka the main character we're doing all this for 👑
• num — the number of pids to charge, like, how many little guys we're trying to fit in here 🍓
• fail — storage of the pid cgroup that's causing the fail 😭 so when it goes wrong, we know who to blame and it's not even shady, it's just data

---

🔥 DESCRIPTION 🔥

okay so here's the vibe: this function follows the set limit. respectfully. no cap. 🫶

she will fail if the charge would cause the new value to exceed the hierarchical limit — and yes that word is doing heavy lifting, because the limit isn't just your own cgroup's business, it's the whole family tree's. the ancestor vibe check is real. 👑

• returns 0 if the charge succeeded — slay, ate, periodt ✨
• otherwise returns -EAGAIN — not a vibe, but she's honest about it 💀

ngl the -EAGAIN is lowkey iconic of her. she's not saying "no forever," she's saying "not like this, not right now." 🙈

---

🌈 SEE ALSO 🌈

• Kernel file ./kernel/cgroup/pids.c — the source material, the holy text, the origin story 📖
• pids_cancel(9) — the undoing queen
• pids_uncharge(9) — gives the pids back, we love a generous icon
• pids_charge(9) — commits to the charge, no take-backs

---

and that's the whole page babes 🎀 this came out of ./kernel/cgroup, October 2026, and it's literally all here — every flag, every return value, every last crumb. you're so welcome. mwah 💖💅🦋