[ новости /+++ | форум | теги | ]

NAME
     tt_host_file_netfile - map between local and canonical path-
     names 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() func-
     tion  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); 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_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)  func-
     tions 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.

     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_netfile().

SEE ALSO
     tt_c(5), tt_file_netfile(3), tt_netfile_file(3),
     tt_host_netfile_file(3), tt_open(3), tt_free(3),
     tt_release(3).

Партнёры:

Хостинг: