*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> tt_host_file_netfile (3)              



 tt_host_file_netfile(library call)       tt_host_file_netfile(library call)

 NAME    [Toc]    [Back]
      tt_host_file_netfile - map between local and canonical pathnames on a
      remote host

 SYNOPSIS    [Toc]    [Back]
      #include <Tt/tt_c.h>
      char *tt_host_file_netfile(
      const char *host,
      const char *filename);

 DESCRIPTION    [Toc]    [Back]
      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

      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    [Toc]    [Back]
      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_filett_ptr_error(3) to extract one of the following Tt_status values from
      the returned pointer:

                The filename argument is a path that is not valid on the
                remote host.

                The ToolTalk database server could not be reached on host,
                perhaps because the host is unavailable or cannot be reached
                through the network.

                The ToolTalk database server is not properly installed on

                The ToolTalk database server contacted is of a version that
                does not support tt_host_file_netfile.

 APPLICATION USAGE    [Toc]    [Back]
      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

                                    - 1 -       Formatted:  January 24, 2005

 tt_host_file_netfile(library call)       tt_host_file_netfile(library call)

      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

      The tt_open(3) function need not be called before

 SEE ALSO    [Toc]    [Back]
      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).

                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
tt_host_netfile_file HP-UX map between canonical and local pathnames on a remote host
tt_netfile_file HP-UX map between canonical and local pathnames on the local host
tt_file_netfile HP-UX map between local and canonical pathnames on the local host
rcp Tru64 Copies files on the same host, between a local host and a remote host, and between two remote hosts
ftp Tru64 Transfers files between a local and a remote host
ypxfr Linux transfer NIS database from remote server to local host
ypxfr FreeBSD transfer NIS database from remote server to local host
dxhosts Tru64 Provides host management capabilities for local and remote hosts
on HP-UX execute command on remote host with environment similar to local
dtsdate HP-UX Sets local clock from a remote dtsd server host
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service