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

t_optmgmt(3) t_optmgmt(3)

This request is not an absolute requirement. The implementation may place upper and

lower limits on the option value. Requests that fall short of the lower limit are nego-

tiated to the lower limit.

Legal values are all positive numbers.

Thread-Safeness

The t_optmgmt() function is safe to be called by multithreaded applications, and it is thread-safe for

both POSIX Threads and DCE User Threads. It has a cancellation point. It is neither async-cancel safe

nor async-signal safe. Finally, it is not fork-safe.

Valid States

All - apart from T_UNINIT

RETURN VALUE

Upon successful completion, a value of 0 is returned. Otherwise, a value of −1 is returned, and

t_errno

is set to indicate the error.

TLI supports any transport provider which is compliant with TPI (Transport Provider Interface). Users can

access TLI versions of the t_* routines by linking with /usr/lib/libnsl_s.a

. For more information

on TLI, see the TLI section of STREAMS/UX for HP 9000 Reference Manual.

ERRORS

On failure,

t_errno is set to the following:

[TBADF] The speciﬁed identiﬁer does not refer to a transport endpoint.

[TOUTSTATE] The function was issued in the wrong sequence.

[TACCES] The user does not have the permission to negotiate the speciﬁed options.

[TBADOPT] The speciﬁed protocol options were in an incorrect format or contained illegal informa-

tion.

[TBADFLAG] An invalid ﬂag was speciﬁed.

[TBUFOVFLW] The number of bytes allowed for an incoming argument (maxlen) is greater than 0 and

not sufﬁcient to store the value of that argument. The information to be returned in

ret will be discarded.

[TSYSERR] A system error has occurred during execution of this function.

[TPROTO] (XTI only) This error indicates that a communication problem has been detected

between XTI and the transport provider for which there is no existing XTI

t_errno.

[TNOTSUPPORT] (XTI only) This action is not supported by the underlying transport provider.