T_DISCON_REQ(7tpi) T_DISCON_REQ(7tpi)
NAME
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 the section
``Transport Service Interface Sequence of Primitives''
of the book STREAMS Modules and Drivers.
Non-fatal errors
These errors will be indicated via the T_ERROR_ACK
primitive described in the section ``Overview of Error
Handling Capabilities'' of the book STREAMS Modules and
Drivers.
Copyright 1994 Novell, Inc. Page 1
T_DISCON_REQ(7tpi) T_DISCON_REQ(7tpi)
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.
Copyright 1994 Novell, Inc. Page 2