cpumask_any_housekeeping(9)

💅 cpumask_any_housekeeping(9) — like, the Kernel API Manual page bestie 🎀

okay so. picture this: you've got a big ol' pile of CPUs and you need to pick one. but not just any one — you're being a little picky about it. that's this function. welcome to the group chat ✨

---

🦋 NAME

cpumask_any_housekeeping — choose any CPU in @mask, preferring the ones that aren't marked nohz_full 🫶

---

🌸 SYNOPSIS

unsigned int cpumask_any_housekeeping (const struct cpumask *mask , int
exclude_cpu );

---

🍓 ARGUMENTS

• mask — the mask you're picking a CPU from. your little CPU buffet 💖
• exclude_cpu — the CPU you're avoiding. not invited to the party, sorry babe 🙈

---

💜 DESCRIPTION

so it returns a CPU from mask, right? but not exclude_cpu. that one's out. blocked. blocked and reported 🚫

if there are housekeeping CPUs that don't use nohz_full, those are the preferred ones — they get picked first, main character energy and all 👑

pass RESCTRL_PICK_ANY_CPU if you literally do not care and want to avoid excluding any CPUs at all. zero exclusions. free the CPUs. slay 🌈

💀 lowkey important warning: when a CPU is excluded, it returns >= nr_cpu_ids if no CPUs are available. so like... check that, bestie. don't just assume you got a real CPU back. that's the vibe check you cannot skip.

---

🔥 SEE ALSO

kernel file ./fs/resctrl/internal.h — and the whole friend group:

• struct mon_evt(9)
• struct mon_data(9)
• struct rmid_read(9)
• enum rdtgrp_mode(9)
• struct mongroup(9)
• struct rdtgroup(9)
• struct rftype(9)
• struct mbm_state(9)

go read them, iykyk 😌

---

and that's the page!! mwah 💋 this lil cutie lives at ./fs/resctrl, dated October 2026, and it's cpumask_any_housekeeping(9) forever and ever — periodt. 🧚💖