DLPI Primitives

Local Management Primitives

dl_addr_length

length of the physical address.

dl_addr_offset

offset form the beginning of the M_PROTO message block where the multicast address begins.

State

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 disable 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 in an incorrect format.

DL_NOTENAB

Address specified is not enabled.

DL_OUTSTATE

Primitive was issued from an invalid state.

DL_NOTSUPPORTED

Primitive is known, but not supported by the DLS Provider.

DL_PROMISCON_REQ

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.

Chapter 2

73