tt_host_netfile_file(3)

tt_host_netfile_file(3)C LIBRARY FUNCTIONStt_host_netfile_file(3)

NAME
     tt_host_netfile_file - map	between	canonical and local path-
     names 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() func-
     tion  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)  func-
     tions 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  compos-
     ing  the  two calls, paths	for files not accessible from the

Unix System LaboratorLast change: 11 May 1994			1

tt_host_netfile_file(3)C LIBRARY FUNCTIONStt_host_netfile_file(3)

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

Unix System LaboratorLast change: 11 May 1994			2