[ Previous | Next | Contents | Glossary | Home | Search ]
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.


[ Previous | Next | Contents | Glossary | Home | Search ]