DLPI_GET_PHYSADDR(3DLPI) Data Link Provider Interface Library Functions

NAME

dlpi_get_physaddr - get physical address using DLPI

SYNOPSIS

cc [ flag... ] file... -ldlpi [ library... ]
#include <libdlpi.h>

int dlpi_get_physaddr(dlpi_handle_t dh, uint_t type,
void *addrp,size_t *addrlenp);

DESCRIPTION

The dlpi_get_physaddr() function gets a physical address from the
DLPI link instance associated with DLPI handle dh. The retrieved
address depends upon type, which can be:

DL_FACT_PHYS_ADDR
Factory physical address


DL_CURR_PHYS_ADDR
Current physical address


The operation can be performed in any DLPI state of dh.


The caller must ensure that addrp is at least DLPI_PHYSADDR_MAX bytes
in size and addrlenp must contain the length of addrp. Upon success,
addrp contains the specified physical address, and addrlenp contains
the physical address length. If a physical address is not available,
addrp is not filled in and addrlenp is set to zero.

RETURN VALUES

Upon success, DLPI_SUCCESS is returned. If DL_SYSERR is returned,
errno contains the specific UNIX system error value. Otherwise, a
DLPI error value defined in <sys/dlpi.h> or an error value listed in
the following section is returned.

ERRORS

DLPI_EBADMSG
Bad DLPI message


DLPI_EINHANDLE
Invalid DLPI handle


DLPI_EINVAL
Invalid argument


DLPI_ETIMEDOUT
DLPI operation timed out

ATTRIBUTES

See attributes(7) for description of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+

SEE ALSO

dlpi_set_physaddr(3DLPI), libdlpi(3LIB), attributes(7)

August 22, 2007 DLPI_GET_PHYSADDR(3DLPI)