hwlocality_advanced_io(3) Library Functions Manual hwlocality_advanced_io(3)
NAME
hwlocality_advanced_io - Finding I/O objects
SYNOPSIS
Functions
hwloc_obj_t hwloc_get_non_io_ancestor_obj (hwloc_topology_t topology,
hwloc_obj_t ioobj)
hwloc_obj_t hwloc_get_next_pcidev (hwloc_topology_t topology,
hwloc_obj_t prev)
hwloc_obj_t hwloc_get_pcidev_by_busid (hwloc_topology_t topology,
unsigned domain, unsigned bus, unsigned dev, unsigned func)
hwloc_obj_t hwloc_get_pcidev_by_busidstring (hwloc_topology_t topology,
const char *busid)
hwloc_obj_t hwloc_get_next_osdev (hwloc_topology_t topology,
hwloc_obj_t prev)
hwloc_obj_t hwloc_get_next_bridge (hwloc_topology_t topology,
hwloc_obj_t prev)
int hwloc_bridge_covers_pcibus (hwloc_obj_t bridge, unsigned domain,
unsigned bus)
Detailed Description
Function Documentation
int hwloc_bridge_covers_pcibus (hwloc_obj_t bridge, unsigned domain,
unsigned bus) [inline]
hwloc_obj_t hwloc_get_next_bridge (hwloc_topology_t topology, hwloc_obj_t
prev) [inline]
Get the next bridge in the system.
Returns
the first bridge if prev is NULL.
the next bridge if prev is not NULL.
NULL if there is no next bridge.
hwloc_obj_t hwloc_get_next_osdev (hwloc_topology_t topology, hwloc_obj_t
prev) [inline]
Get the next OS device in the system.
Returns
the first OS device if prev is NULL.
the next OS device if prev is not NULL.
NULL if there is no next OS device.
hwloc_obj_t hwloc_get_next_pcidev (hwloc_topology_t topology, hwloc_obj_t
prev) [inline]
Get the next PCI device in the system.
Returns
the first PCI device if prev is NULL.
the next PCI device if prev is not NULL.
NULL if there is no next PCI device.
hwloc_obj_t hwloc_get_non_io_ancestor_obj (hwloc_topology_t topology,
hwloc_obj_t ioobj) [inline]
Get the first non-I/O ancestor object. Given the I/O object ioobj, find
the smallest non-I/O ancestor object. This object (normal or memory)
may then be used for binding because it has non-NULL CPU and node sets
and because its locality is the same as ioobj.
Returns
a non-I/O object.
Note
This function cannot return NULL.
The resulting object is usually a normal object but it could also
be a memory object (e.g. NUMA node) in future platforms if I/O
objects ever get attached to memory instead of CPUs.
hwloc_obj_t hwloc_get_pcidev_by_busid (hwloc_topology_t topology, unsigned
domain, unsigned bus, unsigned dev, unsigned func) [inline]
Find the PCI device object matching the PCI bus id given domain, bus
device and function PCI bus id.
Returns
a matching PCI device object if any, NULL otherwise.
hwloc_obj_t hwloc_get_pcidev_by_busidstring (hwloc_topology_t topology,
const char * busid) [inline]
Find the PCI device object matching the PCI bus id given as a string
xxxx:yy:zz.t or yy:zz.t.
Returns
a matching PCI device object if any, NULL otherwise.
Author
Generated automatically by Doxygen for Hardware Locality (hwloc) from
the source code.
Hardware Locality (hwloc) Version 2.12.0 hwlocality_advanced_io(3)
hwloc 2.12.0 - Generated Thu May 8 14:21:09 CDT 2025