TCLOSE(3N)                DG/UX 4.30                 TCLOSE(3N)



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


















     Licensed material--property of copyright holder(s)         Page 1