tt_netfile_file(3) [hpux man page]

tt_netfile_file(library call)											     tt_netfile_file(library call)

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

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

       The netfilename string input to tt_netfile_file should be considered opaque; the content and format of the strings are not a public  inter-
       face.   These strings can be safely copied (with strcpy3C 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 automounting 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

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

														     tt_netfile_file(library call)

Check Out this Related Man Page

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); 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) functions 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 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)

Linux and UNIX Man Pages

tt_netfile_file(3) [hpux man page]

Check Out this Related Man Page