cpumask_first_zero(9)

📦 version 7.3.1, in nixpkgs unstable

💅 cpumask_first_zero(9) ✨

okay so this is a page from the Kernel API Manual (that's the manual name, bestie, it's in the header, don't @ me) and it's about finding the first free cpu in a cpumask. that's it. that's the whole vibe. 🎀

🌸 NAME 🌸

cpumask_first_zero — get the first unset cpu in a cpumask

like, the first cpu that isn't checked off. the empty seat in the group chat, if you will. 👑

✨ SYNOPSIS ✨

unsigned int cpumask_first_zero (const struct cpumask *srcp );

literally one job, one call, one unsigned int coming back at u. 💖

🦋 ARGUMENTS 🦋

  • srcp — the cpumask pointer. that's the mask u are snooping through, bestie. hand it over and it does the searching for u. no cap.

🌈 RETURN 🌈

  • returns >= nr_cpu_ids if all cpus are set.

so like… if every single cpu is already taken, u get back a number that's >= nr_cpu_ids, which is the polite C way of being like "girl there is literally nothing left, go home". 😭 no free seats. sold out. 💀

🫶 SEE ALSO 🫶

it's giving family reunion — every single relative showed up and u have to say hi to all of them. here's the whole guest list, from the kernel file ./include/linux/cpumask.h:

i know. it's a lot. drink some water. 💜

mwah 💋 that's the whole page — sourced from ./include/linux, dated October 2026, and yes u read that right, the future. main character energy fr fr. go find ur first zero, bestie. 🧚‍♀️⭐

📦 where this page comes from