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

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



 tt_file_netfile(library call)                 tt_file_netfile(library call)

 NAME    [Toc]    [Back]
      tt_file_netfile - map between local and canonical pathnames on the
      local host

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

 DESCRIPTION    [Toc]    [Back]
      The tt_file_netfile function converts a local pathname to a
      netfilename, a form that can be passed to other hosts on the network
      and converted back to a local pathname for the same file with

      The filename argument is a pathname (absolute or relative) that is
      valid on the local host.  Every component of filename must exist,
      except that the last component need not exist.

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, the tt_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 this

 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

      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 netfile string returned by tt_file_netfile should be considered
      opaque; the content and format of the strings are not a public
      interface.  These strings can be safely copied (with strcpy3C or
      similar methods), written to files, or transmitted to other processes,
      perhaps on other hosts.

                                    - 1 -       Formatted:  January 24, 2005

 tt_file_netfile(library call)                 tt_file_netfile(library call)

      Allocated strings should be freed using either tt_free(3) or

      The tt_open(3) function need not be called before tt_file_netfile.

 SEE ALSO    [Toc]    [Back]
      Tt/tt_c.h - Tttt_c(5), tt_netfile_file(3), tt_host_file_netfile(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_netfile_file HP-UX map between canonical and local pathnames on the local host
tt_host_netfile_file HP-UX map between canonical and local pathnames on a remote host
tt_host_file_netfile HP-UX map between local and canonical pathnames on a remote host
gethostname Tru64 Get the name of the local host
rcp Tru64 Copies files on the same host, between a local host and a remote host, and between two remote hosts
hostid Tru64 Sets or displays the identifier of the local host
protocols Tru64 Defines the Internet protocols used on the local host
ftp Tru64 Transfers files between a local and a remote host
ruptime IRIX show host status of local machines
local.users Tru64 Specifies mail recipients on the local host.
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service