tt_host_file_netfile(3)

tt_host_file_netfile(3)C LIBRARY FUNCTIONStt_host_file_netfile(3)

NAME
     tt_host_file_netfile - map	between	local and canonical path-
     names 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() func-
     tion  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)  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

Unix System LaboratorLast change: 11 May 1994			1

tt_host_file_netfile(3)C LIBRARY FUNCTIONStt_host_file_netfile(3)

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

Unix System LaboratorLast change: 11 May 1994			2