DL_PROMISCON_REQ(7dlpi) DL_PROMISCON_REQ(7dlpi)
NAME
DL_PROMISCON_REQ - Message Type
SYNOPSIS
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;
DESCRIPTION
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.
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.
Copyright 1994 Novell, Inc. Page 1
DL_PROMISCON_REQ(7dlpi) DL_PROMISCON_REQ(7dlpi)
Response
If enabling of promiscuous mode is successful, a DL_OK_ACK is
returned. Otherwise, a DL_ERROR_ACK is returned.
Reasons for Failure
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_NOTSUPPORTED
Primitive is known but not supported by the DLS
Provider
DL_UNSUPPORTED
Requested service is not supplied by the
provider.
Category
Local Management.
Copyright 1994 Novell, Inc. Page 2