Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

tt_host_file_netfile (3)

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

tt_host_file_netfile(3)       ToolTalk Functions       tt_host_file_netfile(3)



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); other-
       wise,  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 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_file_net-
       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_net-
       file_file(3), tt_open(3), tt_free(3), tt_release(3).




ToolTalk 1.3                     1 March 1996          tt_host_file_netfile(3)