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

tt_host_file_netfile(3)
CDE


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

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

DESCRIPTION
  The tt_host_file_netfile function performs a conversion equivalent to that
  of the tt_file_netfile3 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
  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_file3 or 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 filename argument is a path that is not valid on the remote host.
  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 ToolTalk database server contacted is of a version that does not
  support tt_host_file_netfile.

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

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