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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

511

512

513

514

515

516

517

518

519

520

t_unbind(3) t_unbind(3)

NAME

t_unbind() - disable a transport endpoint

SYNOPSIS

#include <xti.h> /* for X/OPEN Transport Interface - XTI */

/* or */

#include <tiuser.h> /* for Transport Layer Interface - TLI */

int t_unbind (fd);

int fd;

DESCRIPTION

The t_unbind() function disables the transport endpoint speciﬁed by fd which was previously bound

t_bind(). On completion of this call, no further data or events destined for this transport endpoint

will be accepted by the transport provider.

Thread-Safeness

The

t_unbind() 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.

Note

Users can access XTI versions of the

t_* routines by linking with /usr/lib/libxti.a

. For more

information on XTI, see HP-UX/9000 XTI Programmer’s Guide.

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 the STREAMS/UX for HP 9000 Reference Manual.

Valid States

T_IDLE

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

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.

[TLOOK] An asynchronous event has occurred on this transport endpoint.

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