hpux man page for tt_host_file_netfile

tt_host_file_netfile(library call)										tt_host_file_netfile(library call)

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_netfile(3) 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_file(3) or 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_PATH
		 The filename argument is a path that is not valid on the remote host.

       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_UNIMP
		 The ToolTalk database server contacted is of a version that does not support tt_host_file_netfile.

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.

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

SEE ALSO
       Tt/tt_c.h - Tttt_c(5), tt_file_netfile(3), tt_netfile_file(3), tt_host_netfile_file(3), tt_open(3), tt_free(3), tt_release(3).

														tt_host_file_netfile(library call)