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

NAME
     tt_host_netfile_file - map between canonical and local path-
     names 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  netfilename  argument  is  a  copy of a null-terminated
     string      returned      by      tt_netfile_file(3)      or
     tt_host_netfile_file(3).

RETURN VALUE
     Upon successful completion, the tt_host_netfile_file() func-
     tion  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)  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  compos-
     ing  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_netfile_file().

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

Партнёры:

Хостинг: