cpumask_random(9)

📦 version 7.3.1, in nixpkgs unstable

🌸 NAME 🌸

okay so bestie, welcome to the cpumask_random(9) page in the Kernel API Manual 💖 — this little icon does exactly one thing and does it slay: it gets you a random cpu in *src. that's the whole gig. no cap. ✨

🎀 SYNOPSIS 🎀

unsigned int cpumask_random (const struct cpumask *src );

🦋 ARGUMENTS 🦋

  • src — a cpumask pointer 🫶 that's it, that's the argument. hand it a cpumask and it will vibe-check it for you.

🔥 RETURN 🔥

it gives you back a random set bit, or >= nr_cpu_ids if src is empty 💀

lowkey important: if src is empty you do not get a real cpu id back, you get something >= nr_cpu_ids. so if you were expecting an actual cpu, that's your sign to go check your mask, bestie 🙈

👑 SEE ALSO 👑

the kernel file ./include/linux/cpumask.h and its whole friend group, fr fr — every single one of these is on the invite list:

and that's the whole page, bestie — go pick a random cpu and slay 💅✨

xoxo, straight from ./include/linux, dated October 2026 🎀🦋💖

📦 where this page comes from