pxm_to_online_node(9)

💅 pxm_to_online_node(9) — like, the Kernel API Manual girlies ✨

okay so bestie, welcome to pxm_to_online_node(9), straight out of the Kernel API Manual and honestly? she's lowkey a lifesaver 🫶

---

✨ NAME ✨

pxm_to_online_node — the function that maps a proximity ID to an online node, no cap 🔥

---

🌸 SYNOPSIS 🌸

int pxm_to_online_node (int pxm );

---

🎀 ARGUMENTS 🎀

• pxm — an ACPI proximity ID. that's it, that's the whole vibe 💅

---

🦋 DESCRIPTION 🦋

so this one is basically pxm_to_node's more emotionally available sibling 💖 — super similar, but she always returns an online node. like, she will not leave you on read with an offline one, periodt.

when the node mapped from a given proximity ID is offline, she goes and looks up the node distance table and hands you back the nearest online node instead. icon behaviour, honestly 👑

ACPI device drivers that get called after NUMA initialization has completed in the kernel can call this interface to obtain their device NUMA topology from ACPI tables. and the best part? those drivers do not have to deal with offline nodes at all 😭🙏 such a relief.

ngl though, a node can be offline — this happens when the SRAT memory entry does not exist, or when NUMA is disabled, ex. "numa=off" on x86. just so you know what's up 💀

---

🌈 SEE ALSO 🌈

• Kernel file ./include/linux/acpi.h
• acpi_get_cpu_uid(9)
• struct acpi_probe_entry(9)

---

and that's the whole page, bestie 🍓 this cutie lives in ./include/linux, dated October 2026, and she goes by pxm_to_online_node(9) — mwah 💜🧚‍♀️✨