t_unbind.3 (2010 09)

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.

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

Fork Safety

t_unbind is not fork-safe.

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.

PAGE 1
t_unbind(3) t_unbind(3) NAME t_unbind() - disable a transport endpoint SYNOPSIS #include /* or */ #include /* for X/OPEN Transport Interface - XTI */ /* for Transport Layer Interface - TLI */ int t_unbind (fd); int fd; DESCRIPTION The t_unbind() function disables the transport endpoint specified by fd which was previously bound by t_bind(). On completion of this call, no further data or events destined for this transport endpoint will be accepted by the transport provider.
PAGE 2
(Notes) A (Notes) tA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010