HP-UX Reference (11i v2 07/12) - 3 Library Functions N-Z (vol 7)

t
t_optmgmt(3) t_optmgmt(3)
The flags field of req must specify one of the following actions:
T_NEGOTIATE This action enables the transport user to negotiate option values.
The user specifies the options of interest and their values in the buffer specified by
req->opt.buf and req->opt.len. The negotiated option values are returned in the buffer
pointed to by ret->opt.buf. The status field of each returned option is set to indicate
the result of the negotiation. The status is one of the following:
T_SUCCESS if the proposed value was negotiated.
T_PARTSUCCESS if a degraded value was negotiated.
T_FAILURE if the negotiation failed according to the negotiation rules.
T_NOTSUPPORT if the transport provider does not support this option or ille-
gally requests negotiation of a privileged option.
T_READONLY if modification of a read-only option was requested.
If the status is T_SUCCESS, T_FAILURE
, T_NOTSUPPORT or T_READONLY, the
returned option value is the same as the one requested on input.
The overall result of the negotiation is returned in ret->flags.
This field contains the worst single result, whereby the rating is done according to the
order of
T_NOTSUPPORT , T_READONLY, T_FAILURE, T_PARTSUCCESS
,
T_SUCCESS. The value T_NOTSUPPORT is the worst result and T_SUCCESS is
the best.
For each level, the option T_ALLOPT can be requested on input. No value is given
with this option; only the t_opthdr part is specified. This input requests to nego-
tiate all supported options of this level to their default values. The result is returned
option by option in ret->opt.buf. (Note that depending on the state of the transport
endpoint, not all requests to negotiate the default may be successful.)
T_CHECK This action enables the user to verify whether the options specified in req are sup-
ported by the transport provider.
If an option is specified with no option value (it consists only of a
t_opthdr struc-
ture), the option is returned with its status field set to
T_SUCCESS if it is supported,
T_NOTSUPPORT if it is not or needs additional user privileges, and T_READONLY if
it is read-only (in the current state). No option value is returned.
If an option is specified with an option value, the status field of the returned option
has the same value, as if the user had tried to negotiate this value with
T_NEGOTIATE . If the status is T_SUCCESS, T_FAILURE , T_NOTSUPPORT ,or
T_READONLY , the returned option value is the same as the one requested on input.
The overall result of the option checks is returned in ret->flags. This field contains
the worst single result of the option checks, whereby the rating is the same as for
T_NEGOTIATE .
Note that no negotiation takes place. All currently effective option values remain
unchanged.
T_DEFAULT This action enables the transport user to retrieve the default option values. The user
specifies the option of interest in req->opt.buf. The option values are irrelevant and
will be ignored; it is sufficient to specify the t_opthdr part of an option only. The
default values are then returned in ret->opt.buf.
The status field returned is one of the following:
T_NOTSUPPORT if the protocol level does not support this option or if the tran-
sport user illegally requested a privileged option.
T_READONLY if the option is read-only.
T_SUCCESS in all other cases.
The overall result of the request is returned in ret->flags. This field contains the
worst single result, whereby the rating is the same as for T_NEGOTIATE .
512 Hewlett-Packard Company − 2 − HP-UX 11i Version 2: December 2007 Update