NAME
Net::Server::Framework::Client - a client library with auto discovery for daemons
VERSION
This documentation refers to Net::Server::Framework::Client version 1.0.
SYNOPSIS
A typical invocation looks like this:
my $data = Net::Server::Framework::Client::talk('DAEMON_TO_TALK_TO',$c);DESCRIPTION
This is a lib that is used to interface with daemons. The interface uses by default a Data::Serializer compressed string to exchange information and finds the appropriate daemon based on the name. The name is looked up in the central registry configured with the $DB variable. The database based registry holds connection data like UNIX sockets or TCP sockets. If there is more than one daemon with the same name the lib does a basic round robin.
BASIC METHODS
c_connect
The connection logic.
encode
The analog to the Net::Server::Framework::encode function only client sides.
decode
The analog to the Net::Server::Framework::decode function only client sides.
talk
This method abstracts the connection logic and the syn/async connection handling. Use this function to talk to a daemon within the Net::Server::Framework.
log
Deprecated. Has to be consolidated to one general function that is backend neutral
logging
See log
CONFIGURATION AND ENVIRONMENT
The library needs a working etc/db.conf file and a configured $DB variable. If asynchronous connections are used then a spooler process is needed.
BUGS AND LIMITATIONS
There are no known bugs in this module. Please report problems to Lenz Gschwendtner ( <lenz@springtimesoft.com> ) Patches are welcome.
AUTHOR
Lenz Gschwendtner ( <lenz@springtimesoft.com> )
LICENCE AND COPYRIGHT
Copyright (c) 2007 Lenz Gschwerndtner ( <lenz@springtimesoft.comn> ) All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.