Content-type: text/html Man page of t_unbind

t_unbind

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

t_unbind - Disables a transport endpoint.  

LIBRARY

XTI Library (libxti.a)  

SYNOPSIS

#include <xti.h>

int t_unbind(
   int fd) ;  

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

t_unbind:       XPG4-UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags.  

PARAMETERS

The following table summarizes the relevance of input parameter data before and after t_bind() is called:
ParameterBefore CallAfter Call

fdyn

Notes to Table: This is a meaningful parameter. This is not a meaningful parameter. Specifies a file descriptor returned by the t_open() function that identifies an active, previously bound local transport endpoint.  

VALID STATES

The t_bind() function can be called only in the T_IDLE transport provider state.  

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

RETURN VALUES

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: File descriptor fd is not a valid transport endpoint. This function was issued in the wrong sequence. An asynchronous event occurred at the transport endpoint specified by the fd parameter. A system error occurred during execution of this function. This error indicates that a communication problem has been detected between XTI and the transport provider for which there is no other suitable XTI(t_errno).  

RELATED INFORMATION

Functions: t_bind(3) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
VALID STATES
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:05 GMT, October 02, 2010