t_unbind Subroutine for X/Open Transport Interface

AIX Version 4.3 Communications Technical Reference, Volume 2

t_unbind Subroutine for X/Open Transport Interface

Purpose

Disable a transport endpoint.

Library

X/Open Transport Interface Library (libxti.a)

Syntax

#include <xti.h>

int t_unbind (fd)
int fd;

Description

The t_unbind subroutine disables the transport endpoint which was previously bound by t_bind. On completion of this call, no further data or events destined for this transport endpoint are accepted by the transport provider. An endpoint which is disabled by using the t_unbind subroutine can be enabled by a subsequent call to the t_unbind subroutine.

Parameter

fd	Specifies the transport endpoint.

Valid States

T_IDLE

Return Values

0	Successful completion.
-1	t_errno is set to indicate an error.

Errors

On failure, t_errno is set to one of the following:

TBADF	The specified file descriptor does not refer to a transport endpoint.
TOUTSTATE	The subroutine 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 subroutine.
TPROTO	This error indicates that a communication problem has been detected between the X/Open Transport Interface and the transport provider for which there is no other suitable X/Open Transport Interface (t_errno).

Related Information

The t_bind subroutine.