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

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

STANDARDS CONFORMANCE

t_unbind(): SVID2, XPG3, XPG4