hwi_find_tag()

Updated: April 19, 2023

Find a tag in the hwinfo structure

Synopsis:

#include <hw/sysinfo.h>

unsigned hwi_find_tag( unsigned start, 
                       int curr_item, 
                       const char * tagname );

Arguments:

start
Where to start to search for the given item.

For the initial call, set this argument to HWI_NULL_OFF. If the item found isn't the one that you want, pass the return value from the first call to hwi_find_tag() as the start parameter of the next call. This makes the search pick up where it left off. You can repeat this process as many times as required (the return value from the second call going into the start parameter of the third, etc).

curr_item
If this argument is nonzero, the search stops at the end of the current item (i.e., the one that start points to). If curr_item is zero, the search continues until the end of the section.
tagname
The name of tag to search for.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The hwi_find_tag() function finds the tag named tagname.

Returns:

The offset of the tag, or HWI_NULL_OFF if the tag wasn't found.

Classification:

QNX Neutrino

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