tt_netfile_file(library call)                 tt_netfile_file(library call)




 NAME    [Toc]    [Back]
      tt_netfile_file - map between canonical and local pathnames on the
      local host

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

 DESCRIPTION    [Toc]    [Back]
      The tt_netfile_file function converts a netfilename of the format
      returned by tt_file_netfile(3) to a pathname that is valid on the
      local host.  If the file is not currently mounted on the local host,
      tt_netfile_file constructs a pathname of the form:

      /mountpoint/host/filepath

      where mountpoint is the mount point pathname in the environment
      variable DTMOUNTPOINT, or /net if the variable is null or unset.

      The netfilename argument is a copy of a null-terminated string
      returned by tt_netfile_fileRETURN VALUE    [Toc]    [Back]
      Upon successful completion, the tt_netfile_file function returns a
      null-terminated local filename; 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_NETFILE
                The netfilename argument is not a valid netfilename.

 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

      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.

      The netfilename string input to tt_netfile_file should be considered
      opaque; the content and format of the strings are not a public
      interface.  These strings can be safely copied (with strcpy3C or
      similar methods), written to files, or transmitted to other processes,
      perhaps on other hosts.



                                    - 1 -       Formatted:  January 24, 2005






 tt_netfile_file(library call)                 tt_netfile_file(library call)




      The mountpoint value is intended to be the mount point for the
      automounter's host map on those systems supporting automounting
      services.

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

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


                                    - 2 -       Formatted:  January 24, 2005