hwitag_find_busattr()

Updated: April 19, 2023

Find a bus attribute tag associated with a bus

Synopsis:

#include <drvr/hwinfo.h>

int hwitag_find_busattr( unsigned hwi_off,
                         unsigned *busattr_idx,
                         struct hwi_busattr *busattr );

Arguments:

hwi_off
The offset into the hwinfo section of the system page for the device, which you can get by calling hwi_find_device().
busattr_idx
The index of the bus attribute; see below.
busattr
A pointer to a struct hwi_busattr where the function can store the attribute.

Library:

libdrvr

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

Description:

You can use hwitag_find_busattr() to find one or more bus attribute tags associated with the bus at hwi_off in the hwinfo section of the system page.

If the specified bus attribute tag exists and busattr isn't NULL, the retrieved bus attributes are placed in *busattr.

Some buses contain multiple sets of attributes. You can retrieve all of them by using the busattr_idx parameter as follows:

Returns:

0 on success (independent of whether busattr is NULL), or -1 on error.

Classification:

QNX Neutrino

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