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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

501

502

503

504

505

506

507

508

509

510

t_optmgmt(3) t_optmgmt(3)

XTI_SNDLOWAT This option is used to set a low-water mark in the send buffer. The option value

gives the minimal number of bytes that must have accumulated in the send buffer

before they are sent.

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

negotiated 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 infor-

mation 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 infor-

mation.

[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.