opensolaris man page for dlpi_get_physaddr

dlpi_get_physaddr(3DLPI)			  Data Link Provider Interface Library Functions			  dlpi_get_physaddr(3DLPI)

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(5) 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(5)

SunOS 5.11							    22 Aug 2007 					  dlpi_get_physaddr(3DLPI)