for_each_numa_hop_mask(9)

💖 for_each_numa_hop_mask(9) 💖

okay so bestie, this is the for_each_numa_hop_mask(9) page from the Kernel API Manual ✨ and it's literally about hopping through NUMA distances, so let's get into it 🦋

---

🎀 NAME 🎀

for_each_numa_hop_mask — iterate over cpumasks of increasing NUMA distance from a given node. 🌀

---

✨ SYNOPSIS ✨

for_each_numa_hop_mask (mask , node );

---

💅 ARGUMENTS 💅

• mask — the iteration variable. 🫶
• node — the NUMA node to start the search from. 🌸

---

🔥 DESCRIPTION 🔥

Okay so before you even think about running this, bestie: it requires rcu_lock to be held 🔒 — like, that is not optional, the vibe check fails otherwise.

It yields cpu_online_mask for node == NUMA_NO_NODE 👑.

---

👀 SEE ALSO 👀

• Kernel file ./include/linux/topology.h — yes, peep that file 🌈
• for_each_node_numadist(9) — also on the see-also radar ⭐

---

cute lil sign-off: this page's source/version is ./include/linux, the date is October 2026, and the page itself is for_each_numa_hop_mask(9) — mwah 💋🎀