NAME

DL_PROMISCON_REQ (dl_promiscon_req_t) - this primitive requests the DLS Provider to enable promiscuous mode on a per Stream basis, either at the physical level or at the SAP level.

The DL Provider will route all received messages on the media to the DLS User until either a DL_DETACH_REQ or a DL_PROMISCOFF_REQ is received or the Stream is closed.

SYNOPSIS

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

typedef struct {
    t_uscalar_t  dl_primitive;
    t_uscalar_t  dl_level;
} dl_promiscon_req_t;

PARAMETERS

dl_primitive

conveys DL_PROMISCON_REQ

dl_level

indicates promiscuous mode at the physical or SAP level:

DL_PROMISC_PHYS

indicates promiscuous mode at the physical level

DL_PROMISC_SAP

indicates promiscuous mode at the SAP level

DL_PROMISC_MULTI

indicates promiscuous mode for all multicast addresses.

STATE

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

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.

ERRORS

DL_NOTSUPPORTED

Primitive is known but not supported by the DLS Provider

DL_OUTSTATE

The primitive was issued from an invalid state

DL_SYSERR

A System error has occurred and the UNIX System error is indicated in the DL_ERROR_ACK.

DL_UNSUPPORTED

Requested service is not supplied by the provider.