t_unbind()

NAME

t_unbind - synchronise transport library

SYNOPSIS

#include <xti.h>

int t_unbind(
	int fd)

DESCRIPTION

The t_unbind(3) function has only one parameter.

Parameters	Before call	After call
fd	x	/

The t_unbind(3) function disables the transport endpoint specified by fd which was previously bound by t_bind(3). 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(3) can be enabled by a subsequent call to t_bind(3).

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.