DL_DISCONNECT_REQ(7dlpi) DL_DISCONNECT_REQ(7dlpi)
NAME
DL_DISCONNECT_REQ - Message Type
SYNOPSIS
/*
* The message consists of one M_PROTO message
* block containing the structure shown below.
*/
typedef struct {
ulong dl_primitive;
ulong dl_reason;
ulong dl_correlation;
} dl_disconnect_req_t;
DESCRIPTION
Requests the DLS provider to disconnect an active data link
connection or one that was in the process of activation,
either outgoing or incoming, as a result of an earlier
DL_CONNECT_IND or DL_CONNECT_REQ. If an incoming
DL_CONNECT_IND is being refused, the correlation number
associated with that connect indication must be supplied. The
message indicates the reason for the disconnect.
Parameters
dl_primitive
conveys DL_DISCONNECT_REQ.
dl_reason conveys the reason for the disconnect.
Reasons for Disconnect
DL_DISC_NORMAL_CONDITION
normal release of a data link connection
DL_DISC_ABNORMAL_CONDITION
abnormal release of a data link
connection
DL_CONREJ_PERMANENT_COND
a permanent condition caused the
rejection of a connect request
DL_CONREJ_TRANSIENT_COND
a transient condition caused the
rejection of a connect request
Copyright 1994 Novell, Inc. Page 1
DL_DISCONNECT_REQ(7dlpi) DL_DISCONNECT_REQ(7dlpi)
DL_DISC_UNSPECIFIED reason unspecified
dl_correlation
if non-zero, conveys the correlation number that
was contained in the DL_CONNECT_IND being
rejected. This value permits the DLS provider to
associate the primitive with the proper
DL_CONNECT_IND when rejecting an incoming
connection. If the disconnect request is
releasing a connection that is already
established, or is aborting a previously sent
DL_CONNECT_REQ, the value of dl_correlation should
be zero.
State
The message is valid in any of the states: DL_DATAXFER,
DL_INCON_PENDING, DL_OUTCON_PENDING, DL_PROV_RESET_PENDING,
DL_USER_RESET_PENDING.
New State
The resulting state is one of the disconnect pending states.
Response
If the disconnect is successful, DL_OK_ACK is sent to the DLS
user resulting in state DL_IDLE.
If the request fails, message DL_ERROR_ACK is returned, and
the resulting state is unchanged.
Reasons for Failure
DL_BADCORR The correlation number specified in this primitive
did not correspond to a pending connect
indication.
DL_OUTSTATE The primitive was issued from an invalid state.
DL_SYSERR A system error has occurred and the UNIX system
error is indicated in the DL_ERROR_ACK.
Mode
Connection-mode.
REFERENCES
the section ``Connection Establishment'' of the book STREAMS
Modules and Drivers
Copyright 1994 Novell, Inc. Page 2
DL_DISCONNECT_REQ(7dlpi) DL_DISCONNECT_REQ(7dlpi)
the section ``Allowable Sequence of DLPI Primitives'' of the
book STREAMS Modules and Drivers
Copyright 1994 Novell, Inc. Page 3