NAME    [Toc]    [Back]

       t_close - Close a transport endpoint.

SYNOPSIS    [Toc]    [Back]

       #include <xti.h>

       int t _close(
               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_close():  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 the input
       parameter before and after t_close() 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 a  local
       transport endpoint.

DESCRIPTION    [Toc]    [Back]

       The  t_close() XTI function is used in connection-oriented
       and connectionless transport service to inform a transport
       provider  that  the  transport  user has finished with the
       transport endpoint. The transport endpoint is specified by
       a  file  descriptor  previously  returned  by the t_open()
       function. The t_close() function frees any  local  library
       resources  associated  with  the transport endpoint referenced
 by the file descriptor.

       The t_close() function does not  check  state  information
       (see  the  t_getstate() function). Consequently, t_close()
       may be called in any transport provider state to close  an
       open  transport  endpoint.  When t_close() executes, local
       library resources associated with the  transport  endpoint
       are  automatically  freed. In addition, a close() function
       is called for the referenced file descriptor.  The close()
       function  aborts when there are no other file descriptors,
       in the current or any other process,  that  reference  the
       same transport endpoint.  When close() aborts, any connection
 that is associated with that  transport  endpoint  is
       broken.

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_close() function fails, t_errno may be set to the
       following value: File descriptor fd does not  refer  to  a
       valid  transport  endpoint.   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_close() function is intended to  be  called  in  the
       T_UNBND transport provider state (see the DESCRIPTION section).

SEE ALSO    [Toc]    [Back]

       Functions: t_getstate(3), t_open(3), t_unbind(3)

       Standards: standards(5).

       Network Programmer's Guide



                                                       t_close(3)