DLPI Programmer's Guide

84 Chapter 2
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