T_OPTMGMT_ACK(D7tpi)
T_OPTMGMT_ACK --
Option Management Acknowledgment
Synopsis
This message consists of a M_PCPROTO message block
formatted as follows:
struct T_optmgmt_ack {
long PRIM_type; /* always T_OPTMGMT_ACK */
long OPT_length; /* options length - */
long OPT_offset; /* options offset */
long MGMT_flags; /* flags */
}
Description
This indicates to the transport user that the options management request has
completed.
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_PCPROTO
block where the options begin.
The proper alignment of the options is not guaranteed.
MGMT_flags should be the same as those specified in the
T_OPTMGMT_REQ
primitive with any additional flags as specified below.
Rules
The following rules apply to the
T_OPTMGMT_ACK
primitive.
-
If the value of MGMT_flags
in the
T_OPTMGMT_REQ
primitive is T_DEFAULT,
the provider should return the default provider options without changing
the existing options associated with the stream.
-
If the value of MGMT_flags in the T_OPTMGMT_REQ primitive
is
T_CHECK,
the provider should return the options as specified in the
T_OPTMGMT_REQ
primitive along with the additional flags
T_SUCCESS or T_FAILURE
which indicate to the user whether the specified options are supportable by the
provider.
The provider should not change any existing options associated with the stream.
-
If the value of MGMT_flags in the T_OPTMGMT_REQ primitive
is
T_NEGOTIATE ,
the provider should set and negotiate the option as specified by
the following rules:
-
If the OPT_length field of the T_OPTMGMT_REQ primitive is
0,
then the transport provider is to set and return the default options
associated with the stream in the
T_OPTMGMT_ACK
primitive.
-
If options are specified in the
T_OPTMGMT_REQ
primitive, then the
transport provider should negotiate those options, set the negotiated options and return the
negotiated options in the
T_OPTMGMT_ACK
primitive.
It is the user's responsibility to check the negotiated options returned
in the
T_OPTMGMT_ACK
primitive and take appropriate action.
Errors
If the above rules result in an error condition, the transport provider
must issue a
T_ERROR_ACK
primitive to the transport user specifying
the error as defined in the description of the
T_OPTMGMT_REQ
primitive.
Modes
Both connection-mode and connectionless-mode.
Originator
Transport provider.
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