DLPI Primitives

Local Management Primitives

Format

The message consists of one M_PROTO message block, which contains the following structure.

typedef struct

{

ulong

dl_primitive;

ulong

dl_level;

}dl_promiscon_req_t;

Parameters

dl_primitive

DL_PROMISCON_REQ

dl_level

indicates promiscuous mode at the physical or SAP level.

DL_PROMISC_PHYS

Before or after the STREAM has been bound, the DLPI user receives all traffic on the wire regardless of protocol or physical address.

DL_PROMISC_SAP

Before or after the STREAM has been bound, the DLPI user receives all traffic destined for this interface (physical addresses, broadcast addresses or bound multicast addresses) that matches any protocol enabled on that interface.

DL_PROMISC_MULTI

Before or after the STREAM has been bound, the DLPI user receives all multicast packets on the wire regardless of the protocol it is destined for.

State

The message is valid in any state when there is no pending acknowledgment.

New State

The resulting state is unchanged.

Response

If enabling of promiscuous mode is successful, a DL_OK_ACK is returned. Otherwise, a DL_ERROR_ACK is returned.

74

Chapter 2