DLPI Primitives

Local Management Primitives

Parameters

dl_primitive

DL_HP_MULTICAST_LIST_REQ

State

The message is valid in any state in which there is not a local acknowledgment pending with the exception of DL_UNATTACH.

New State

The resulting state is unchanged.

Response

If the multicast request is successful, a

DL_HP_MULTICAST_LIST_ACK is sent to the DLS user. If the requests fails, DL_ERROR_ACK is returned and the resulting state is unchanged.

Reasons for Failure

DL_OUTSTATE

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_HP_MULTICAST_LIST_ACK

Reports the successful completion of a DL_HP_MULTICAST_LIST_REQ primitive. A complete list of the multicast addresses for a specific LAN interface are returned after the control message header.

Format

The message consists one M_PROTO message block containing the structure shown below.

typedef struct {

 

ulong

dl_primitive;

ulong

dl_offset;

ulong

dl_length;

ulong

dl_count;

} dl_hp_multicast_list_ack_t;

Parameters

84

Chapter 2