Net::Async::Tangence::Client - connect to a Tangence server using IO::Async
This subclass of Net::Async::Tangence::Protocol connects to a Tangence server, allowing the client program to access exposed objects in the server. It is a concrete implementation of the Tangence::Client mixin.
The following documentation concerns this specific implementation of the client; for more general information on the Tangence-specific parts of this class, see instead the documentation for Tangence::Client.
The following named parameters may be passed to new or configure:
The identity string to send to the server.
Default error-handling policy for method calls. If set to either of the strings carp or croak then a CODE ref will be created that invokes the given function from Carp; otherwise must be a CODE ref.
The following methods documented with a trailing call to ->get return Future instances.
$rootobj = $client->connect_url( $url, %args )->get
Connects to a Tangence server at the given URL. The returned Future will yield the root object proxy once it has been obtained.
Takes the following named arguments:
Invoked once the registry and root object proxies have been obtained from the server. See the documentation the Tangence::Client tangence_connected method.
Optional. May be set to inet4 or inet6 to force IPv4 or IPv6 if relevant. Ignored by exec: and unix: schemes.
The following URL schemes are recognised:
Directly executes the server as a child process. This is largely provided for testing purposes, as the server will only run for this one client; it will exit when the client disconnects.
The URL's path should point to the required command, and the query string will be split on + signs and used as the arguments. The authority section of the URL will be ignored, so may be left empty.
A convenient wrapper around the exec scheme, to connect to a server running remotely via ssh.
The URL's authority section will give the SSH server (and optionally username), and the path and query sections will be used as for exec.
(This scheme is also available as ssh, though this name is now deprecated)
Connects to a server via a TCP socket.
The URL's authority section will be used to give the server's hostname and port number. The other sections of the URL will be ignored.
Connects to a server via a UNIX local socket.
The URL's path section will give the path to the local socket. The other sections of the URL will be ignored.
Connects to a server running remotely via a UNIX socket over ssh.
(This is implemented by running perl remotely and sending it a tiny self-contained program that connects STDIN/STDOUT to the given UNIX socket path. It requires that the server has perl at least version 5.6 available in the path simply as perl)
Paul Evans <firstname.lastname@example.org>
To install Net::Async::Tangence, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell
For more information on module installation, please visit the detailed CPAN module installation guide.