tt_host_file_netfile(3)

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