hwitag_find_nicaddr()

Updated: April 19, 2023

Get the NIC address of a device

Synopsis:

#include <drvr/hwinfo.h>

int hwitag_find_nicaddr( unsigned hwi_off,
                         unsigned *nicaddr_idx,
                         uint8_t *nicaddr );

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().
nicaddr_idx
NULL, or a pointer to a location that holds the index of the NIC address that you want to find; see below.
nicaddr
NULL, or a pointer to a location where the function can store the NIC address.

Library:

libdrvr

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

Description:

You can use hwitag_find_nicaddr() to find one or more NIC (MAC) addresses associated with the device at hwi_off in the hwinfo section of the syspage. If the specified NIC address exists and hwi_off isn't NULL, hwitag_find_nicaddr() stores the retrieved address in the location that nicaddr points to.

Some devices contain multiple NIC addresses. You can retrieve all of them by using the nicaddr_idx parameter as follows:

Returns:

0 on success (whether or not hwi_off is NULL) or -1 on error.

Classification:

QNX Neutrino

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