tt_host_file_netfile(library call)       tt_host_file_netfile(library call)




 NAME    [Toc]    [Back]
      tt_host_file_netfile - map between local and canonical pathnames on a
      remote host

 SYNOPSIS    [Toc]    [Back]
      #include <Tt/tt_c.h>
      char *tt_host_file_netfile(
      const char *host,
      const char *filename);

 DESCRIPTION    [Toc]    [Back]
      The tt_host_file_netfile function performs a conversion equivalent to
      that of the tt_file_netfile(3) function, but performs it on a remote
      host.

      The filename argument is a pathname (absolute or relative) that is
      valid on the remote host.  Every component of filename must exist,
      except for the last component.  The host argument is a name of a
      remote host.

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, the tt_host_file_netfile function returns
      a freshly allocated null-terminated string of unspecified format,
      which can be passed to tt_netfile_filett_ptr_error(3) to extract one of the following Tt_status values from
      the returned pointer:

      TT_ERR_PATH
                The filename argument is a path that is not valid on the
                remote host.

      TT_ERR_DBAVAIL
                The ToolTalk database server could not be reached on host,
                perhaps because the host is unavailable or cannot be reached
                through the network.

      TT_ERR_DBEXIST
                The ToolTalk database server is not properly installed on
                host.

      TT_ERR_UNIMP
                The ToolTalk database server contacted is of a version that
                does not support tt_host_file_netfile.

 APPLICATION USAGE    [Toc]    [Back]
      The tt_file_netfile(3), tt_netfile_file(3), tt_host_file_netfile(3)
      and tt_host_netfile_file(3) functions allow an application to
      determine a path valid on remote hosts, perhaps for purposes of
      constructing a command string valid for remote execution on that host.
      By composing the two calls, paths for files not accessible from the



                                    - 1 -       Formatted:  January 24, 2005






 tt_host_file_netfile(library call)       tt_host_file_netfile(library call)




      current host can be constructed.  For example, if path /sample/file is
      valid on host A, a program running on host B can use

      tt_host_netfile_file("C", tt_host_file_netfile("A", "/sample/file"))

      to determine a path to the same file valid on host C, if such a path
      is possible.

      Allocated strings should be freed using either tt_free(3) or
      tt_release(3).

      The tt_open(3) function need not be called before
      tt_host_file_netfile.

 SEE ALSO    [Toc]    [Back]
      Tt/tt_c.h - Tttt_c(5), tt_file_netfile(3), tt_netfile_file(3),
      tt_host_netfile_file(3), tt_open(3), tt_free(3), tt_release(3).


                                    - 2 -       Formatted:  January 24, 2005