DL_SUBS_UNBIND_REQ Primitive

AIX Version 4.3 Communications Technical Reference, Volume 1

DL_SUBS_UNBIND_REQ Primitive

Purpose

Requests that the data link service (DLS) provider unbind the data link service access point (DLSAP) that was bound by a previous DL_SUBS_BIND_REQ primitive from this stream.

Structure

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

typedef struct 
{
   ulong dl_primitive;
   ulong dl_subs_sap_length;
   ulong dl_subs_sap_offset;
} dl_subs_unbind_req_t;

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

Description

The DL_SUBS_UNBIND_REQ primitive requests that the DLS provider unbind the DLSAP that was bound by a previous DL_SUBS_BIND_REQ primitive from this stream.

Parameters

dl_primitive	Specifies the DL_SUBS_UNBIND_REQ primitive.
dl_subs_sap_length	Specifies the length of the specified DLSAP.
dl_subs_sap_offset	Indicates where the DLSAP begins. The value of this parameter is the offset from the beginning of the M_PROTO message block.

States

Valid	The primitive is valid in the DL_IDLE state.
New	The resulting state is DL_SUBS_UNBIND_PND.

Acknowledgments

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

Error Codes

DL_BADADDR	Indicates the DLSAP address information is invalid or is in an incorrect format.
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_OK_ACK primitive, DL_ERROR_ACK primitive, DL_SUBS_BIND_REQ primitive.