t_close(3N)             LIBRARY FUNCTIONS             t_close(3N)



NAME
     tclose - close a transport endpoint

SYNOPSIS
     #include <tiuser.h>

     int tclose(fd)
     int fd;

DESCRIPTION
     The tclose function informs the transport provider that the
     user  is  finished  with the transport endpoint specified by
     fd, and frees any local library  resources  associated  with
     the  endpoint.  In addition, tclose closes the file associ-
     ated with the transport endpoint.

     tclose  should  be  called  from  the  TUNBND  state  [see
     tgetstate(3N)].   However,  this  function  does  not check
     state information, so it may be called  from  any  state  to
     close  a  transport  endpoint.   If  this  occurs, the local
     library resources associated with the endpoint will be freed
     automatically.   In  addition,  close(2)  will be issued for
     that file descriptor; the close will be abortive if no other
     process  has  that  file  open, and will break any transport
     connection that may be associated with  that  endpoint.   On
     failure, terrno may be set to the following:

     [TBADF]      The specified file descriptor does not refer to
                  a transport endpoint.

SEE ALSO
     t_getstate(3N), t_open(3N), t_unbind(3N).
     UNIX System V Network Programmer's Guide.

DIAGNOSTICS
     tclose returns 0 on success and -1 on failure  and  terrno
     is set to indicate the error.


















                                                                1