opensolaris man page for dlpi_promiscon

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)