1dlpi_promiscon(3DDLaPtIa)Link Provider Interface Library Functdilopnis_promiscon(3DLPI)
2
3
4

NAME

6       dlpi_promiscon,  dlpi_promiscoff  -  enable or disable DLPI promiscuous
7       mode
8

SYNOPSIS

10       cc [ flag... ] file... -ldlpi [ library... ]
11       #include <libdlpi.h>
12
13       int dlpi_promiscon(dlpi_handle_t dh, uint_t level);
14
15
16       int dlpi_promiscoff(dlpi_handle_t dh, uint_t level);
17
18

DESCRIPTION

20       The dlpi_promiscon() function enables promiscuous mode on a  DLPI  link
21       instance  associated with DLPI handle dh, at the specified level. After
22       enabling promiscuous mode, the caller will be able to receive all  mes‐
23       sages  destined for the DLPI link instance at the specified level. This
24       operation can be performed in any DLPI state of a handle.
25
26
27       The dlpi_promiscoff() function disables promiscuous mode on a DLPI link
28       instance  associated  with DLPI handle dh, at the specified level. This
29       operation can be performed in any DLPI state of a handle in which  pro‐
30       miscuous mode is enabled at the specified level.
31
32
33       The level modes are:
34
35       DL_PROMISC_PHYS     Promiscuous mode at the physical level
36
37
38       DL_PROMISC_SAP      Promiscuous mode at the SAP level
39
40
41       DL_PROMISC_MULTI    Promiscuous mode for all multicast addresses
42
43

RETURN VALUES

45       Upon  success,  DLPI_SUCCESS  is   returned.  If DL_SYSERR is returned,
46       errno contains the specific UNIX system error value. Otherwise, a  DLPI
47       error  value  defined  in  <sys/dlpi.h> or an error value listed in the
48       following section is returned.
49

ERRORS

51       DLPI_EBADMSG      Bad DLPI message
52
53
54       DLPI_EINHANDLE    Invalid DLPI handle
55
56
57       DLPI_EINVAL       Invalid argument
58
59
60       DLPI_ETIMEDOUT    DLPI operation timed out
61
62

ATTRIBUTES

64       See attributes(5) for description of the following attributes:
65
66
67
68
69       ┌─────────────────────────────┬─────────────────────────────┐
70       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
71       ├─────────────────────────────┼─────────────────────────────┤
72       │Interface Stability          │Committed                    │
73       ├─────────────────────────────┼─────────────────────────────┤
74       │MT-Level                     │Safe                         │
75       └─────────────────────────────┴─────────────────────────────┘
76

SEE ALSO

78       libdlpi(3LIB), attributes(5)
79
80
81
82SunOS 5.11                        22 Aug 2007            dlpi_promiscon(3DLPI)
Impressum