tt_host_file_netfile - map between local and canonical pathnames on a remote host
#include <Tt/tt_c.h> char *tt_host_file_netfile(const char *host, const char *filename);
tt_host_file_netfile(3) ToolTalk Functions 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); other- wise, 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 com- mand 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_net- file(). ATTRIBUTES See attributes(7) for descriptions of the following attributes: +---------------+------------------+ |ATTRIBUTE TYPE | ATTRIBUTE VALUE | +---------------+------------------+ |Availability | library/tooltalk | +---------------+------------------+ |Stability | Committed | +---------------+------------------+ SEE ALSO tt_c(5), tt_file_netfile(3), tt_netfile_file(3), tt_host_net- file_file(3), tt_open(3), tt_free(3), tt_release(3). ToolTalk 1.3 1 March 1996 tt_host_file_netfile(3)