TCLOSE(3N-SVR4)    RISC/os Reference Manual     TCLOSE(3N-SVR4)



NAME
     t_close - 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 T_UNBND state [see
     t_getstate(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, t_errno 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).

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


















                        Printed 11/19/92                   Page 1