Manual Pages for UNIX Operating System command usage for man dlpi_bind

Data Link Provider Interface Library Functions   dlpi_bind(3DLPI)



NAME
     dlpi_bind - bind DLPI handle

SYNOPSIS
     cc [ flag ... ] file ... -ldlpi [ library ... ]
     #include 

     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 transition 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  con-
     junction 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 
     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




SunOS 5.11          Last change: 22 Aug 2007                    1






Data Link Provider Interface Library Functions   dlpi_bind(3DLPI)



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



     ____________________________________________________________
    |       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          Last change: 22 Aug 2007                    2