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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

551

552

553

554

555

556

557

558

559

560

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

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 information

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.