Index for Section 3

Alphabetical listing for T

Bottom of page

tt_netfile_file(3)
CDE
NAME
  tt_netfile_file - map between canonical and local pathnames on the local
  host

SYNOPSIS
  #include <tt_c.h>
  char *tt_netfile_file(const char *netfilename);

DESCRIPTION
  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/

  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_file(3) or tt_host_netfile_file(3).

RETURN VALUE
  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
  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 strcpy(3)C or similar methods),
  written to files, or transmitted to other processes, perhaps on other
  hosts.

  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
  tt_c.h(5), tt_file_netfile(3), tt_host_file_netfile(3),
  tt_host_netfile_file(3), tt_open(3), tt_free(3), tt_release(3)

Index for Section 3

Alphabetical listing for T

Top of page