Previous section.

Technical Standard: Networking Services (XNS), Issue 5.2 Draft 2.0
Copyright © 1999 The Open Group

NAME

t_unbind - disable a transport endpoint

SYNOPSIS


#include <xti.h>

int t_unbind(int fd);


DESCRIPTION






Parameters Before call After call

fd x /


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. An endpoint which is disabled by using t_unbind() can be enabled by a subsequent call to t_bind().

VALID STATES

T_IDLE

ERRORS

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

[TBADF]
The specified file descriptor does not refer to a transport endpoint.

[TLOOK]
An asynchronous event has occurred on this transport endpoint.

[TOUTSTATE]
The communications endpoint referenced by fd is not in one of the states in which a call to this function is valid.

[TPROTO]
This error indicates that a communication problem has been detected between XTI and the transport provider for which there is no other suitable XTI error (t_errno).

[TSYSERR]
A system error has occurred during execution of this function.

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.

SEE ALSO

t_bind().

CHANGE HISTORY

Issue 4

The SYNOPSIS section is placed in the form of a standard C function prototype.

Contents Next section Index