tt_host_netfile_file(library call)       tt_host_netfile_file(library call)




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

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

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

      The host argument is the host on which the file resides.  The
      netfilename argument is a copy of a null-terminated string returned by
      tt_netfile_fileRETURN VALUE    [Toc]    [Back]
      Upon successful completion, the tt_host_netfile_file function returns
      a freshly allocated null-terminated string of unspecified format,
      which can be passed to tt_host_netfile_file(3); otherwise, it returns
      an error pointer.  The application can use tt_ptr_error(3) to extract
      one of the following Tt_status values from the returned pointer:

      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_NETFILE
                The netfilename is not a valid netfilename.

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

 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
      current host can be constructed.  For example, if path /sample/file is
      valid on host A, a program running on host B can use




                                    - 1 -       Formatted:  January 24, 2005






 tt_host_netfile_file(library call)       tt_host_netfile_file(library call)




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

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


                                    - 2 -       Formatted:  January 24, 2005