DLPI Programmer's Guide

Chapter 2 61
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.