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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

511

512

513

514

515

516

517

518

519

520

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