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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

441

442

443

444

445

446

447

448

449

450

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/nan.3m

________________________________________________________________

___ ___

t_optmgmt(3) t_optmgmt(3)

The ﬂags ﬁeld of req must specify one of the following actions:

T_NEGOTIATE This action enables the transport user to negotiate option values.

The user speciﬁes the options of interest and their values in the buffer speciﬁed 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 ﬁeld 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 illegally

requests negotiation of a privileged option.

T_READONLY if modiﬁcation 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->ﬂags.

This ﬁeld 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 speciﬁed. This input requests to negotiate 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 speciﬁed in req are supported

by the transport provider.

If an option is speciﬁed with no option value (it consists only of a

t_opthdr

structure),

the option is returned with its status ﬁeld 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 speciﬁed with an option value, the status ﬁeld 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->ﬂags. This ﬁeld 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

speciﬁes the option of interest in req->opt.buf. The option values are irrelevant and will

be ignored; it is sufﬁcient to specify the

t_opthdr part of an option only. The default

values are then returned in ret->opt.buf.

The status ﬁeld returned is one of the following:

T_NOTSUPPORT if the protocol level does not support this option or if the transport

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->ﬂags. This ﬁeld contains the worst

single result, whereby the rating is the same as for T_NEGOTIATE.

Section 3−−938 − 2 − HP-UX Release 11i: December 2000

___