t_unbind(3)							   t_unbind(3)

NAME
       t_unbind - Disable a transport endpoint.

SYNOPSIS
       #include <xti.h>

       int t_unbind(
	       int fd );

LIBRARY
       XTI Library (libxti.a)

STANDARDS
       Interfaces  documented on this reference page conform to industry stan‐
       dards as follows:

       t_unbind():  XNS4.0, XNS5.0

       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:

       ─────────────────────────────────────
       Parameter   Before Call	 After Call
       ─────────────────────────────────────
       fd	   y		 n
       ─────────────────────────────────────

       Notes to Table: This is a meaningful parameter.	This is not a meaning‐
       ful parameter.

       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 end‐
       point 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 follow‐
       ing 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).

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

SEE ALSO
       Functions: t_bind(3)

       Standards: standards(5)

       Network Programmer's Guide

								   t_unbind(3)

Vote for polarhome