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 |