T_OPTMGMT_REQ(7tpi) T_OPTMGMT_REQ(7tpi)
NAME
T_OPTMGMT_REQ - Options Management
SYNOPSIS
This message consists of a M_PROTO message block formatted as
follows:
struct T_optmgmt_req {
long PRIM_type; /* always T_OPTMGMT_REQ */
long OPT_length; /* options length */
long OPT_offset; /* options offset */
long MGMT_flags; /* flags */
}
DESCRIPTION
This primitive allows the transport user to manage the options
associated with the stream. The format of the message is one
M_PROTO message block.
Parameters
PRIM_type
indicates the primitive type.
OPT_length
is the length of the protocol options associated with
the primitive
OPT_offset
is the offset from the beginning of the M_PROTO block
where the options begin.
MGMT_flags
are the flags which define the request made by the
transport user. The allowable flags are:
T_NEGOTIATE
Negotiate and set the options with the transport
provider.
T_CHECK
Check the validity of the specified options.
T_DEFAULT
Return the default options.
Copyright 1994 Novell, Inc. Page 1
T_OPTMGMT_REQ(7tpi) T_OPTMGMT_REQ(7tpi)
The proper alignment of the options is not guaranteed. The
options are however, aligned the same as it was received from
the transport user.
Rules
For the rules governing the requests made by this primitive
see the T_OPTMGMT_ACK primitive.
This primitive requires the transport provider to generate one
of the following acknowledgments on receipt of the primitive
and that the transport user wait for the acknowledgment before
issuing any other primitives:
Successful
Acknowledgment of the primitive via the T_OPTMGMT_ACK.
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
Errors
The allowable errors are as follows:
TACCES
This indicates that the user did not have proper
permissions for the use of the requested options.
TOUTSTATE
The primitive would place the transport interface out of
state.
TBADOPT
This indicates that the options as specified were in an
incorrect format, or they contained invalid information.
TBADFLAG
This indicates that the flags as specified were
incorrect or invalid.
TSYSERR
A system error has occurred and the UNIX system error is
indicated in the primitive.
Copyright 1994 Novell, Inc. Page 2
T_OPTMGMT_REQ(7tpi) T_OPTMGMT_REQ(7tpi)
TNOTSUPPORT
This primitive is not supported by the transport
provider.
Modes
Both connection-mode and connectionless-mode.
Originator
Transport user.
Copyright 1994 Novell, Inc. Page 3