DLPI Programmer's Guide

72 Chapter 2
DLPI Primitives
Local Management Primitives
This message is valid in any state in which a local acknowledgment is
not pending with the exception of DL_UNATTACH.
New State
The resulting state is unchanged.
Response
If the enable request is successful, a DL_OK_ACK is sent to the DLS
user. If the request fails, DL_ERROR_ACK is returned and the resulting
state is unchanged.
Reasons for Failure
DL_BADADDR
Address information was invalid or was in an incorrect format.
DL_TOOMANY
Too many multicast address enable attempts. Limit exceeded.
DL_OUTSTATE
Primitive was issued from an invalid state.
DL_NOTSUPPORTED
Primitive is known, but not supported by the DLS Provider.
DL_DISABMULTI_REQ
Requests the DLS Provider to disable specific multicast addresses on a
per Stream basis.
Format
The message consists of one M_PROTO message block, which contains
the following structure:
typedef struct {
ulong dl_primitive;
ulong dl_addr_length;
ulong dl_addr_offset;
} dl_disabmulti_req_t;
Parameters
dl_primitive
DL_DISABMULTI_REQ