This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

nic_get_syspage_mac()

Retrieve a stored MAC address

Synopsis:

int nic_get_syspage_mac ( char *mac)

Arguments:

mac

A pointer to the Media Access Control (MAC) address stored in the system page.

Description:

The nic_get_syspage_mac() function retrieves, during system startup, a MAC address that was stored in the system page. If a driver is unable to determine the MAC address that was manufacturer-assigned to the interface (e.g. by reading it from an SROM), it should use this function instead.

If this function fails, you'll need to specify a MAC address on the command line, otherwise, the driver should send an error message to the system logger and the instantiation of the interface should fail.

Returns:

0 if a MAC address was successfully retrieved from the syspage; -1 on failure.

Classification: