Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

tt_host_netfile_file (3)

Name

tt_host_netfile_file - map between canonical and local pathnames on a remote host

Synopsis

#include <Tt/tt_c.h>
char *tt_host_netfile_file(const char *host,
const char *netfilename);

Description

tt_host_netfile_file(3)       ToolTalk Functions       tt_host_netfile_file(3)



NAME
       tt_host_netfile_file  -  map between canonical and local pathnames on a
       remote host

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

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

       The host argument is the host on which the file resides.  The  netfile-
       name argument is a copy of a null-terminated string returned by tt_net-
       file_file(3) or tt_host_netfile_file(3).

RETURN VALUE
       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:

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

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

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 com-
       mand  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_net-
       file_file().


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/tooltalk |
       +---------------+------------------+
       |Stability      | Committed        |
       +---------------+------------------+
SEE ALSO
       tt_c(5), tt_file_netfile(3), tt_netfile_file(3), tt_host_file_net-
       file(3), tt_open(3), tt_free(3), tt_release(3).




ToolTalk 1.3                     1 March 1996          tt_host_netfile_file(3)