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

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



 tt_host_netfile_file(library call)       tt_host_netfile_file(library call)

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

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

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

      The host argument is the host on which the file resides.  The
      netfilename argument is a copy of a null-terminated string returned by
      tt_netfile_fileRETURN VALUE    [Toc]    [Back]
      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:

                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 netfilename is not a valid netfilename.

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

 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
      current host can be constructed.  For example, if path /sample/file is
      valid on host A, a program running on host B can use

                                    - 1 -       Formatted:  January 24, 2005

 tt_host_netfile_file(library call)       tt_host_netfile_file(library call)

      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_file_netfile(3), tt_open(3), tt_free(3), tt_release(3).

                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
tt_host_file_netfile HP-UX map between local and canonical 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