Manual Pages for UNIX Operating System command usage for man dlpi_promiscoff

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 

     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 
     or  an  error  value  listed  in  the  following  section is
     returned.

ERRORS




SunOS 5.11          Last change: 22 Aug 2007                    1






Data Link Provider Interface Library Functions
                                            dlpi_promiscon(3DLPI)



     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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


SEE ALSO
     libdlpi(3LIB), attributes(5)

























SunOS 5.11          Last change: 22 Aug 2007                    2






Data Link Provider Interface Library Functions
                                            dlpi_promiscon(3DLPI)






















































SunOS 5.11          Last change: 22 Aug 2007                    3