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:

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