hwlocality_rsmi(3)

💖 hwlocality_rsmi(3) 💖

okay bestie, welcome to the Library Functions Manual page for hwlocality_rsmi(3) — this is the one about playing nice with the ROCm SMI Management Library. it's giving interoperability, lowkey iconic, and we're gonna read it together. 🫶

---

🎀 NAME 🎀

hwlocality_rsmi — Interoperability with the ROCm SMI Management Library ✨

🌸 SYNOPSIS 🌸

💅 Functions 💅

int hwloc_rsmi_get_device_cpuset (hwloc_topology_t topology, uint32_t dv_ind, hwloc_cpuset_t set)
hwloc_obj_t hwloc_rsmi_get_device_osdev_by_index (hwloc_topology_t topology, uint32_t dv_ind)
hwloc_obj_t hwloc_rsmi_get_device_osdev (hwloc_topology_t topology, uint32_t dv_ind)

🦋 Detailed Description 🦋

This interface is literally a whole set of ways to retrieve topology information about devices managed by the ROCm SMI Management Library. That's the vibe. 💖

🔥 Function Documentation 🔥

🧠 int hwloc_rsmi_get_device_cpuset (hwloc_topology_t topology, uint32_t dv_ind, hwloc_cpuset_t set) [inline] 🧠

okay so this one gets the CPU set of logical processors that are physically close to the AMD GPU device whose index is dv_ind. It stores in set the CPU-set describing the locality of the AMD GPU device whose index is dv_ind. 🎀

topology and the device dv_ind must match the local machine, periodt. I/O devices detection and the ROCm SMI component are not needed in the topology. 💅

The function only returns the locality of the device. If you need more information about the device, bestie, OS objects should be used instead — see hwloc_rsmi_get_device_osdev() and hwloc_rsmi_get_device_osdev_by_index(). 🦋

This function is currently only implemented in a meaningful way for Linux; other systems will simply get the cpuset of the entire topology. No cap.

💖 Returns 💖

• 0 on success. ✅
• -1 on error, for instance if device information could not be found. 😭

🧠 hwloc_obj_t hwloc_rsmi_get_device_osdev (hwloc_topology_t topology, uint32_t dv_ind) [inline] 🧠

This one gets the hwloc OS device object corresponding to the AMD GPU device, whose index is dv_ind. ✨

🫶 Returns 🫶

• The hwloc OS device object that describes the given AMD GPU, whose index is dv_ind. 👑
• NULL if none could be found. 💀

topology and the device dv_ind must match the local machine. I/O devices detection and the ROCm SMI component must be enabled in the topology. If they're not, the locality of the object may still be found using hwloc_rsmi_get_device_cpuset(). iykyk.

Note — the corresponding hwloc PCI device may be found by looking at the result parent pointer (unless PCI devices are filtered out). 🎀

🧠 hwloc_obj_t hwloc_rsmi_get_device_osdev_by_index (hwloc_topology_t topology, uint32_t dv_ind) [inline] 🧠

Get the hwloc OS device object corresponding to the AMD GPU device whose index is dv_ind. Simple as that, bestie. 🌸

🍓 Returns 🍓

• The hwloc OS device object describing the AMD GPU device whose index is dv_ind. 🔥
• NULL if none could be found. 😭

The topology topology does not necessarily have to match the current machine. For instance, the topology may be an XML import of a remote host. I/O devices detection and the ROCm SMI component must be enabled in the topology. 🦋

Note — the corresponding PCI device object can be obtained by looking at the OS device parent object (unless PCI devices are filtered out). 💅

✨ Author ✨

Generated automatically by Doxygen for Hardware Locality (hwloc) from the source code. 🤖✨

---

okay that's the whole page, bestie. this came from Hardware Locality (hwloc), Version 2.15.0, and it's the hwlocality_rsmi(3) page — love u, bye 🫶💅