[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Communications Technical Reference, Volume 1

DL_DETACH_REQ Primitive

Purpose

Requests that the data link service (DLS) style 2 provider detach a physical point of attachment (PPA) from a stream.

Structure

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

typedef struct 
{
   ulong dl_primitive;
} dl_detach_req_t;

This structure is defined in /usr/include/sys/dlpi.h.

Description

For style 2 DLS providers, the DL_DETACH_REQ primitive requests the DLS provider detach a PPA from a stream.

Parameters

dl_primitive Specifies the DL_DETACH_REQ primitive.

States

Valid The primitive is valid in the DL_UNBOUND state.
New The resulting state is DL_DETACH_PENDING.

Acknowledgments

Successful The DL_OK_ACK primitive is sent to the DLS user. The resulting state is DL_UNATTACHED.
Unsuccessful The DL_ERROR_ACK primitive is returned, and the resulting state is unchanged.

Error Codes

DL_OUTSTATE Indicates the primitive was issued from an invalid state.
DL_SYSERR Indicates a system error occurred. The system error is indicated in the DL_ERROR_ACK primitive.

Implementation Specifics

This primitive is part of Base Operating System (BOS) Runtime.

Related Information

The DL_ERROR_ACK primitive, DL_OK_ACK primitive.


[ Previous | Next | Contents | Glossary | Home | Search ]