opensolaris man page for dlpi_bind

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

NAME
       dlpi_bind - bind DLPI handle

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

       int dlpi_bind(dlpi_handle_t dh, uint_t sap, uint_t *boundsap);

DESCRIPTION
       The dlpi_bind() function attempts to bind the DLPI handle dh to the SAP sap. The handle must be in the DL_UNBOUND DLPI state and will tran-
       sition to the DL_IDLE DLPI state upon success. Some DLPI MAC types can bind to a different SAP than the SAP requested, in which case bound-
       sap  returns  the actual bound SAP. If boundsap is set to NULL, dlpi_bind() fails if the bound SAP does not match the requested SAP. If the
       caller does not care which SAP is chosen, DLPI_ANY_SAP can be specified for sap. This is primarily useful in conjunction with  dlpi_promis-
       con() and DL_PROMISC_SAP to receive traffic from all SAPs. If DLPI_ANY_SAP is specified, any transmitted messages must explicitly specify a
       SAP using dlpi_send(3DLPI).

       Upon success, the caller can use dlpi_recv(3DLPI) to receive data matching the bound SAP that is sent to the DLPI link associated with  dh.
       In  addition,  the  caller  can	use  dlpi_send(3DLPI) to send data over the bound SAP address associated with DLPI handle dh. The physical
       address of the bound handle can be retrieved with dlpi_info(3DLPI).

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_ETIMEDOUT	   DLPI operation timed out

       DLPI_EUNAVAILSAP    Unavailable DLPI SAP

ATTRIBUTES
       See attributes(5) for description of the following attributes:

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

SEE ALSO
       dlpi_info(3DLPI), dlpi_recv(3DLPI), dlpi_send(3DLPI), dlpi_unbind(3DLPI), libdlpi(3LIB), attributes(5)

SunOS 5.11							    22 Aug 2007 						  dlpi_bind(3DLPI)