NAME    [Toc]    [Back]

       t_unbind - Disable a transport endpoint.

SYNOPSIS    [Toc]    [Back]

       #include <xti.h>

       int t_unbind(
               int fd );

LIBRARY    [Toc]    [Back]

       XTI Library (libxti.a)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards 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    [Toc]    [Back]

       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 meaningful parameter.

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

DESCRIPTION    [Toc]    [Back]

       The t_unbind() XTI service function is used in connectionoriented
 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    [Toc]    [Back]

       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    [Toc]    [Back]

       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).

VALID STATES    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       Functions: t_bind(3)

       Standards: standards(5)

       Network Programmer's Guide



                                                      t_unbind(3)