Net::Server::Framework::Client - a client library with auto discovery for


Net-Server-Framework documentation  | view source Contained in the Net-Server-Framework distribution.

Index


NAME

Top

Net::Server::Framework::Client - a client library with auto discovery for daemons

VERSION

Top

This documentation refers to Net::Server::Framework::Client version 1.0.

SYNOPSIS

Top

A typical invocation looks like this:

    my $data = Net::Server::Framework::Client::talk('DAEMON_TO_TALK_TO',$c);

DESCRIPTION

Top

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

Top

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

Top

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

Top

There are no known bugs in this module. Please report problems to Lenz Gschwendtner ( <lenz@springtimesoft.com> ) Patches are welcome.

AUTHOR

Top

Lenz Gschwendtner ( <lenz@springtimesoft.com> )

LICENCE AND COPYRIGHT

Top


Net-Server-Framework documentation  | view source Contained in the Net-Server-Framework distribution.