dlpi_promiscoff(3dlpi) [opensolaris man page]
dlpi_promiscon(3DLPI) Data Link Provider Interface Library Functions dlpi_promiscon(3DLPI) NAME
dlpi_promiscon, dlpi_promiscoff - enable or disable DLPI promiscuous mode SYNOPSIS
cc [ flag... ] file... -ldlpi [ library... ] #include <libdlpi.h> int dlpi_promiscon(dlpi_handle_t dh, uint_t level); int dlpi_promiscoff(dlpi_handle_t dh, uint_t level); DESCRIPTION
The dlpi_promiscon() function enables promiscuous mode on a DLPI link instance associated with DLPI handle dh, at the specified level. After enabling promiscuous mode, the caller will be able to receive all messages destined for the DLPI link instance at the specified level. This operation can be performed in any DLPI state of a handle. The dlpi_promiscoff() function disables promiscuous mode on a DLPI link instance associated with DLPI handle dh, at the specified level. This operation can be performed in any DLPI state of a handle in which promiscuous mode is enabled at the specified level. The level modes are: DL_PROMISC_PHYS Promiscuous mode at the physical level DL_PROMISC_SAP Promiscuous mode at the SAP level DL_PROMISC_MULTI Promiscuous mode for all multicast addresses 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_EINVAL Invalid argument DLPI_ETIMEDOUT DLPI operation timed out 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 22 Aug 2007 dlpi_promiscon(3DLPI)
Check Out this Related Man Page
dlpi_open(3DLPI) Data Link Provider Interface Library Functions dlpi_open(3DLPI) NAME
dlpi_open - open DLPI link SYNOPSIS
cc [ flag ... ] file ... -ldlpi [ library ... ] #include <libdlpi.h> int dlpi_open(const char *linkname, dlpi_handle_t *dhp, uint_t flags); DESCRIPTION
The dlpi_open() function creates an open instance of the DLPI Version 2 link named by linkname and associates it with a dynamically-allo- cated dlpi_handle_t, which is returned to the caller in dhp upon success. The DLPI handle is left in the DL_UNBOUND DLPI state after a suc- cessful open of the DLPI link. The DLPI handles can only be used by one thread at a time, but multiple handles can be used by multiple threads. This function can open both DL_STYLE1 and DL_STYLE2 DLPI links. By default (if DLPI_DEVIPNET is not set in flags), the dlpi_open() function scans the /dev/net and /dev directories for DLPI links, in order. Within each scanned directory, dlpi_open() first looks for a matching DL_STYLE1 link, then for a matching DL_STYLE2 link. If provider is considered the linkname with its trailing digits removed, a matching DL_STYLE1 link has a filename of linkname, and a matching DL_STYLE2 link has a filename of provider. If a DL_STYLE2 link is opened, dlpi_open() automatically performs the necessary DLPI operations to place the DLPI link instance and the associated DLPI handle in the DL_UNBOUND state. See dlpi(7P) for the definition of linkname. If DLPI_DEVIPNET is set in flags, dlpi_open() opens the file linkname in /dev/ipnet as a DL_STYLE1 DLPI device and does not look in any other directories. The value of flags is constructed by a bitwise-inclusive-OR of the flags listed below, defined in <libdlpi.h>. DLPI_DEVIPNET Specify that the named DLPI device is an IP observability device (see ipnet(7D)), and dl_open() will open the device from the /dev/ipnet/ directory. DLPI_IPNETINFO This flag is applicable only when opening IP Observability devices (with DLPI_DEVIPNET or by opening the /dev/lo0 device). This flag causes the ipnet driver to prepend an ipnet header to each received IP packet. See ipnet(7D) for the contents of this header. DLPI_NATIVE Enable DLPI native mode (see DLIOCNATIVE in dlpi(7P)) on a DLPI link instance. Native mode persists until the DLPI handle is closed by dlpi_close(3DLPI). DLPI_PASSIVE Enable DLPI passive mode (see DL_PASSIVE_REQ in dlpi(7P)) on a DLPI link instance. Passive mode persists until the DLPI handle is closed by dlpi_close(3DLPI). DLPI_RAW Enable DLPI raw mode (see DLIOCRAW in dlpi(7P)) on a DLPI link instance. Raw mode persists until the DLPI handle is closed by dlpi_close(3DLPI). Each DLPI handle has an associated timeout value that is used as a timeout interval for certain libdlpi operations. The default timeout value ensures that DLPI_ETIMEDOUT is returned from a libdlpi operation only in the event that the DLPI link becomes unresponsive. The time- out value can be changed with dlpi_set_timeout(3DLPI), although this should seldom be necessary. 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 listed in the following section is returned. ERRORS
The dlpi_open() function will fail if: DLPI_EBADLINK Bad DLPI link DLPI_EIPNETINFONOTSUP The DLPI_IPNETINFO flag was set but the device opened does not support the DLIOCIPNETINFO ioctl. DLPI_ELINKNAMEINVAL Invalid DLPI linkname DLPI_ENOLINK DLPI link does not exist DLPI_ERAWNOTSUP DLPI raw mode not supported DLPI_ETIMEDOUT DLPI operation timed out DLPI_FAILURE DLPI operation failed ATTRIBUTES
See attributes(5) for description of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Committed | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ SEE ALSO
dlpi_close(3DLPI), dlpi_set_timeout(3DLPI), libdlpi(3LIB), attributes(5), dlpi(7P), ipnet(7D) SunOS 5.11 17 Nov 2008 dlpi_open(3DLPI)