tt_netfile_file(3)

tt_netfile_file(3)     C LIBRARY FUNCTIONS     tt_netfile_file(3)

NAME
     tt_netfile_file - map between canonical and local	pathnames
     on	the local host

SYNOPSIS
     #include <Tt/tt_c.h>

     char *tt_netfile_file(const char *netfilename);

DESCRIPTION
     The tt_netfile_file() function converts a netfilename of the
     format  returned by tt_file_netfile(3) to a pathname that is
     valid on the local	host.	If  the	 file  is  not	currently
     mounted  on  the  local host, tt_netfile_file() constructs	a
     pathname of the form:

	  /mountpoint/host/filepath

     where mountpoint is the mount point pathname in the environ-
     ment  variable DTMOUNTPOINT, or /net if the variable is null
     or	unset.

     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_netfile_file()	 function
     returns  a	 null-terminated  local	 filename;  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_NETFILE
		The netfilename	argument  is  not  a  valid  net-
		filename.

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

Unix System LaboratorLast change: 11 May 1994			1

tt_netfile_file(3)     C LIBRARY FUNCTIONS     tt_netfile_file(3)

     The netfilename string input to tt_netfile_file() should  be
     considered	opaque;	the content and	format of the strings are
     not a public interface.  These strings can	be safely  copied
     (with  strcpy(3C)	or similar methods), written to	files, or
     transmitted to other processes, perhaps on	other hosts.

     The mountpoint value is intended to be the	mount  point  for
     the automounter's host map	on those systems supporting auto-
     mounting services.

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

SEE ALSO
     Tttt_c(5),	tt_file_netfile(3), tt_host_file_netfile(3),
     tt_host_netfile_file(3), tt_open(3), tt_free(3),
     tt_release(3).

Unix System LaboratorLast change: 11 May 1994			2