Visit The New, Modern Unix Linux Community

Linux and UNIX Man Pages

Test Your Knowledge in Computers #101
Difficulty: Easy
Linux is fundamentally a UNIX clone written from scratch by Linus Torvalds with the help of many coders across the globe.
True or False?
Linux & Unix Commands - Search Man Pages

dlpi_bind(3dlpi) [opensolaris man page]

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)

Check Out this Related Man Page

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

NAME
dlpi_set_timeout - set DLPI handle timeout interval SYNOPSIS
cc [ flag ... ] file ... -ldlpi [ library ... ] #include <libdlpi.h> int dlpi_set_timeout(dlpi_handle_t dh, int sec); DESCRIPTION
The dlpi_set_timeout() function sets the timeout interval to sec seconds on DLPI handle dh. This timeout is used by libdlpi(3LIB) functions that require explicit acknowledgment from the associated DLPI link, and bounds the number of seconds that a function will wait for an acknowledgment before returning DLPI_ETIMEDOUT. Except for dlpi_recv(3DLPI), which has a timeout argument, any function that is documented to return DLPI_ETIMEDOUT can take up to the timeout interval to complete. Callers that do not require an upper bound on timeouts are strongly encouraged to never call dlpi_set_timeout(), and allow libdlpi to use its default timeout value. The default timeout value is intended to ensure that DLPI_ETIMEDOUT will only be returned if the DLPI link has truly become unresponsive. The default timeout value is intended to ensure that DLPI_ETIMEDOUT will be returned only if the DLPI link has truly become unresponsive. Callers that do require an explicit upper bound can specify that value at any time by calling dlpi_set_timeout(). However, note that val- ues less than 5 seconds may trigger spurious failures on certain DLPI links and systems under high load, and thus are discouraged. Attempts to set the timeout value to less than 1 second will fail. If sec is set to DLPI_DEF_TIMEOUT, the default timeout value is restored. RETURN VALUES
Upon success, DLPI_SUCCESS is returned. Otherwise, a DLPI error value is returned. ERRORS
DLPI_EINHANDLE Invalid DLPI handle ATTRIBUTES
See attributes(5) for description of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Committed | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ SEE ALSO
libdlpi(3LIB), attributes(5) SunOS 5.11 21 Aug 2007 dlpi_set_timeout(3DLPI)

Featured Tech Videos