hwi_find_bus()

Find the offset of the section in the system page for a bus

Synopsis:

#include <drvr/hwinfo.h>

unsigned hwi_find_bus( const char *bus_name,
                       unsigned unit );

Arguments:

bus_name
The name of the bus.
unit
The unit number.

Library:

libdrvr

Use the -l drvr option to qcc to link against this library.

Description:

If the unit instance of bus_name has been added to the hwinfo section of the syspage, hwi_find_bus() returns its offset. This function ensures that the bus_name found is in fact a bus.

This function is basically a wrapper for hwi_find_item() that allows for a specific item instance to be returned. It differs from hwi_find_item() in that it resolves (all) synonym names (aliases) to a real bus.

Note that although we used the name “bus” to be consistent with previous nomenclature, from a topology perscpective, we actually mean any interconnect to which a device is connected.

Returns:

The hwinfo section offset, or HWI_NULL_OFF if the device instance doesn't exist.

Classification:

QNX Neutrino

Safety:
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes

See also:

hwi_find(), hwi_find_device(), hwi_find_devicebus(), hwi_find_num_units(), hwi_find_unit(), hwi_tag_find(), hwiattr_get(), hwiattr_get_*(), hwitag_find_busattr(), hwitag_find_clkfreq(), hwitag_find_errata(), hwitag_find_ivec(), hwitag_find_nicaddr(), hwitag_find_phyaddr()