numa_nearest_node(9)

💫 numa_nearest_node(9) 💫

okay bestie, welcome to the Kernel API Manual — this one's numa_nearest_node(9) and it's lowkey one of the cutest little helpers in the mm department, iykyk 🎀

---

✨ NAME ✨

numa_nearest_node — find nearest node by state 🦋

✨ SYNOPSIS ✨

int numa_nearest_node (int node , unsigned int state );

✨ ARGUMENTS ✨

• node — the node id you're starting the search from, like your starting point on the map 📍
• state — the state you're filtering the search by, aka the vibe check every node has to pass ✅

✨ DESCRIPTION ✨

So here's the tea ☕ — this bad boy does a lookup of the closest node by distance if nid is not in state. That's it, that's the whole plot. It's giving "I want the nearest node, but only one that matches my state, and if my starting node doesn't match, go find the next best thing." No cap 💅

✨ RETURN ✨

It returns this node if it's in state — slay, immediate win, no travel required 👑 — otherwise it hands you back the closest node by distance. Either way you get a node, so honestly? We love a reliable king 🫶

✨ SEE ALSO ✨

okay these are the besties in the same friend group, all hanging out in the kernel file ./mm/mempolicy.c 🌸

• nearest_node_nodemask(9)
• folio_can_map_prot_numa(9)
• alloc_pages_mpol(9)
• vma_alloc_folio(9)
• alloc_pages(9)
• mpol_misplaced(9)
• mpol_shared_policy_init(9)
• mpol_parse_str(9)
• mpol_to_str(9)

---

ngl if you made it this far you're officially a node-finding icon 💀✨ go read the source, it's right there in ./mm 🧚

kisses, this page lives in ./mm, October 2026 edition, and it's numa_nearest_node(9) forever and always, periodt 💖🌈⭐