Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
tt_host_file_netfile(library call)	    tt_host_file_netfile(library call)

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

SEE ALSO
       Tt/tt_c.h    -	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).

					    tt_host_file_netfile(library call)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | APPLICATION USAGE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=tt_host_file_netfile&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help