OSF

NAME

t_unbind − Disables a transport endpoint

LIBRARY

XTI Library (libtli.a)

SYNOPSIS

#include <xti.h>

int t_unbind(

int fd) ;

PARAMETERS

The t_bind() function can only be called in the T_IDLE transport provider state. The following table summarizes the relevance of input parameter data before and after t_bind() is called:

Notes to Table:

yThis is a meaningful parameter.
nThis is not a meaningful parameter.

fd Specifies a file descriptor returned by the t_open() function that identifies an active, previously bound local transport endpoint.

DESCRIPTION

The t_unbind() XTI service function is used in connection-oriented and connectionless modes to disable the transport endpoint, specified by the file descriptor that was previously bound by a t_bind() call. When t_bind() completes, no further data destined for this transport endpoint or events are accepted by the transport provider.

RETURN VALUE

Upon successful completion, a value of 0 (zero) is returned. Otherwise, a value of -1 is returned and t_errno is set to indicate the error. 

ERRORS

If the t_unbind() function fails, t_errno is set to one of the following values:

[TBADF]
File descriptor fd is not a valid transport endpoint. 

[TOUTSTATE]
This function was issued in the wrong sequence.

[TLOOK]
An asynchronous event occurred at the transport endpoint specified by the fd parameter. 

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

RELATED INFORMATION

Functions: t_bind(3)