Networking Services Library Functions               tclose(3NSL)



NAME
     tclose - close a transport endpoint

SYNOPSIS
     #include 




     int tclose(int fd);


DESCRIPTION
     This routine is part of the  XTI  interfaces  which  evolved
     from the TLI interfaces. XTI represents the future evolution
     of these interfaces. However, TLI interfaces  are  supported
     for  compatibility.  When  using  a TLI routine that has the
     same name as an XTI routine, the  tiuser.h header file  must
     be  used.   Refer  to  the   TLI COMPATIBILITY section for a
     description of differences between the two interfaces.


     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.


     The function tclose() should be  called  from  the  TUNBND
     state. See tgetstate(3NSL). 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; if there are no other  descriptors  in
     this process or in another process which references the com-
     munication endpoint, any connection that may  be  associated
     with  that  endpoint  is  broken. The connection may be ter-
     minated in an orderly or abortive manner.


     A tclose() issued on a connection endpoint may  cause  data
     previously sent, or data not yet received, to be lost. It is
     the responsibility of the transport user to ensure that data
     is received by the remote peer.

RETURN VALUES
     Upon successful completion, a value of  0 is returned.  Oth-
     erwise,  a  value  of   -1 is returned and terrno is set to
     indicate an error.




SunOS 5.11           Last change: 7 May 1998                    1






Networking Services Library Functions               tclose(3NSL)



VALID STATES
     TUNBND

ERORS
     On failure, terrno is set to the following:

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


     TPROTO     This error indicates that a communication problem
                has  been  detected between XTI and the transport
                provider for which there is no other suitable XTI
                error (terrno).


     TSYSER    A system error has occurred during  execution  of
                this function.


TLI COMPATIBILITY
     The XTI and TLI interface definitions have common names  but
     use different header files. This, and other semantic differ-
     ences between the two interfaces are described in  the  sub-
     sections below.

  Interface Header
     The XTI interfaces use the header file,  xti.h.  TLI  inter-
     faces  should  not  use  this  header.   They should use the
     header:


     #include 

  Error Description Values
     The terrno value that can be set by the XTI  interface  and
     cannot be set by the TLI interface is:

     TPROTO


ATRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:











SunOS 5.11           Last change: 7 May 1998                    2






Networking Services Library Functions               tclose(3NSL)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT Level                     Safe                        
    


SEE ALSO
     close(2),  tgetstate(3NSL),  topen(3NSL),  tunbind(3NSL),
     attributes(5)













































SunOS 5.11           Last change: 7 May 1998                    3