T_DISCON_REQ(D7tpi)
T_DISCON_REQ --
Disconnect Request
Synopsis
This message consists of one M_PROTO message block
followed by one or more M_DATA message blocks
if there is any user data specified by the transport user.
The format of the M_PROTO message block is as follows:
struct T_discon_req {
long PRIM_type; /* always T_DISCON_REQ */
long SEQ_number; /* sequence number */
}
Description
This primitive requests that the transport provider
deny a request for connection, or disconnect an existing connection.
Parameters
PRIM_type-
identifies the primitive type.
SEQ_number-
identifies the outstanding connect indication
that is to by denied.
If the disconnect request is disconnecting an
already existing connection, then the
value of
SEQ_number
will be ignored.
Rules
This primitive requires
the transport provider to generate the following
acknowledgment on receipt of the primitive, and the transport user
must
wait for the acknowledgment before issuing any other primitives:
Successful-
Correct acknowledgment of the primitive
is indicated via the
T_OK_ACK
primitive described in
Non-fatal errors-
These errors will be indicated via the
T_ERROR_ACK
primitive
described in
Errors
The allowable errors are as follows:
TOUTSTATE-
The primitive would place the transport interface out of state.
TBADDATA-
The amount of user data specified was invalid.
TBADSEQ-
The sequence number specified in the primitive was incorrect or invalid.
TSYSERR-
A system error has occurred and the UNIX system error is indicated in the
primitive.
TNOTSUPPORT-
This primitive is not supported by the transport provider.
Modes
Only connection-mode.
Originator
Transport user.
Notices
Hardware constraints
None
Applicability
N/A
Backward compatibility
UnixWare-specific TPI Message Formats
Forward compatibility
N/A
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005