tt_host_netfile_file(3)

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

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_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_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_NETFILE
                The netfilename is not a valid netfilename.

        TT_ERR_UNIMP
                The ToolTalk database server contacted is of a version that
                does not support tt_host_netfile_file().

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

SEE ALSO
     Tttt_c(5), tt_file_netfile(3), tt_netfile_file(3),
     tt_host_file_netfile(3), tt_open(3), tt_free(3), tt_release(3).