dlpi_bind(3DLPI)Data Link Provider Interface Library Functionsdlpi_bind(3DLPI)NAMEdlpi_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 transi‐
tion 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 boundsap
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_promiscon() 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 ALSOdlpi_info(3DLPI), dlpi_recv(3DLPI), dlpi_send(3DLPI),
dlpi_unbind(3DLPI), libdlpi(3LIB), attributes(5)SunOS 5.11 22 Aug 2007 dlpi_bind(3DLPI)