DLPI Primitives

Local Management Primitives

DL_ATTACH_REQ

Requests the DLS provider to associate a physical point of attachment (PPA) with a stream.

The message consists of one M_PROTO message block, which contains the following structure.

Format

typedef struct {

 

ulong

dl_primitive;

ulong

dl_ppa;

} dl_attach_req_t;

 

Parameters

 

dl_primitive

DL_ATTACH_REQ

dl_ppa

identifier of the physical point of attachment to be associated with the stream.

State

The message is valid in state DL_UNATTACHED.

New State

The resulting state is DL_ATTACH_PENDING.

Response

If the attach request is successful, DL_OK_ACK is sent to the DLS user resulting in state DL_UNBOUND.

If the request fails, DL_ERROR_ACK is returned and the resulting state is unchanged.

Reasons for Failure

DL_BADPPA

The specified PPA is invalid.

DL_ACCESS

The DLS user did not have proper permission to use the requested PPA.

Chapter 2

61