hwlocality\_advanced\_io(3) Library Functions Manual hwlocality\_advanced\_io(3)

# [NAME](#NAME)

hwlocality\_advanced\_io - Finding I/O objects

# [SYNOPSIS](#SYNOPSIS)

## [Functions](#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](#Detailed_Description)

# [Function Documentation](#Function_Documentation)

## [int hwloc\_bridge\_covers\_pcibus (**hwloc\_obj\_t** bridge, unsigned domain, unsigned bus) \[inline\]](#int_hwloc_bridge_covers_pcibus_%28)

## **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](#Author)

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

Version 2.15.0 Hardware Locality (hwloc)

---

Document: hwloc_get_next_osdev(3) from hwloc-cuda-12.8 2.15.0-r0 (Chainguard OS)
Source: https://github.com/open-mpi/hwloc