Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dlpi_fd(3dlpi) [opensolaris man page]

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

NAME
dlpi_fd - get DLPI file descriptor SYNOPSIS
cc [ flag ... ] file ... -ldlpi [ library ... ] #include <libdlpi.h> int dlpi_fd(dlpi_handle_t dh); DESCRIPTION
The dlpi_fd() function returns the integer file descriptor that can be used to directly operate on the open DLPI stream associated with the DLPI handle dh. This file descriptor can be used to perform non-DLPI operations that do not alter the state of the DLPI stream, such as waiting for an event using poll(2), or pushing and configuring additional STREAMS modules, such as pfmod(7M). If DLPI operations are directly performed on the file descriptor, or a STREAMS module is pushed that alters the message-passing interface such that DLPI opera- tions can no longer be issued, future operations on dh might not behave as documented. The returned file descriptor is managed by libdlpi(3LIB) and the descriptor must not be closed. RETURN VALUES
The function returns the integer file descriptor associated with the DLPI handle dh. If dh is invalid, -1 is returned. ATTRIBUTES
See attributes(5) for description of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Committed | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ SEE ALSO
poll(2), libdlpi(3LIB), attributes(5), dlpi(7P), pfmod(7M) SunOS 5.11 15 Jun 2007 dlpi_fd(3DLPI)

Check Out this Related 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)
Man Page