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

FreeBSD Manual Pages

  
 
  

home | help
tt_host_netfile_file(library call)	    tt_host_netfile_file(library call)

NAME
       tt_host_netfile_file  --	map between canonical and local	pathnames 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  netfile-
       name argument is	a copy of a null-terminated string returned by tt_net-
       file_file(3) or tt_host_netfile_file(3).

RETURN VALUE
       Upon successful completion, the tt_host_netfile_file function 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)	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_netfile_file.

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

					    tt_host_netfile_file(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_netfile_file&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help