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

72

Chapter 2