Click this button to go to the index for this section.

tt_host_netfile_file(3)
CDE


NAME
  tt_host_netfile_file - map between canonical and local pathnames on a
  remote host

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

DESCRIPTION
  The tt_host_netfile_file function performs a conversion equivalent to that
  of the tt_netfile_file3 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_file3
  or tt_host_netfile_file3.

RETURN VALUE
  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_file3; otherwise, it returns an error pointer.
  The application can use tt_ptr_error3 to extract one of the following
  Tt_status values from the returned pointer:
  The ToolTalk database server could not be reached on host, perhaps because
  the host is unavailable or cannot be reached through the network.
  The ToolTalk database server is not properly installed on host.
  The netfilename is not a valid netfilename.
  The ToolTalk database server contacted is of a version that does not
  support tt_host_netfile_file.

APPLICATION USAGE
  The tt_file_netfile3, tt_netfile_file3, tt_host_file_netfile3 and
  tt_host_netfile_file3 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.

  Allocated strings should be freed using either tt_free3 or tt_release3.


  The tt_open3 function need not be called before tt_host_netfile_file.

SEE ALSO
  Tt/tt_c.h5, tt_file_netfile3, tt_netfile_file3, tt_host_file_netfile3,
  tt_open3, tt_free3, tt_release3.