T_OPTMGMT_ACK(7tpi) T_OPTMGMT_ACK(7tpi)
NAME
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
Copyright 1994 Novell, Inc. Page 1
T_OPTMGMT_ACK(7tpi) T_OPTMGMT_ACK(7tpi)
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.
Copyright 1994 Novell, Inc. Page 2