NAME

Net::Objwrap::Server - provide server for proxy access to Perl object

VERSION

0.08

DESCRIPTION

Remote object server component of Net::Objwrap distribution. See Net::Objwrap for a description of this module and instructions for using it.

FUNCTIONS

new

$server = Net::Objwrap::Server->new($file, @objects)

$server = Net::Objwrap::Server->new(\%opts, $file, @objects)

Creates a new remote object server that initially serves one or more references in @objects. Writes server connection information and metadata about the served objects to a file called $file.

If a hash reference is provided as the first argument, it is treated as a set of server configuration options. Recognized key-value pairs in server configuration are:

keep_alive => int

On server startup, keeps the server alive for at least the given number of seconds, waiting for one or more clients to connect. Default is 30. In test mode the default is 1.

idle_timeout => int

Keeps the server alive for at least the given number of seconds after the last client has disconnected, to give other clients time to connect. The default is 30. In test mode, the default is 1.

alarm_freq => int

Frequency, in seconds, that the server process accepting new connections is interrupted. During these interruptions, the server assesses whether any existing clients have disconnected, and whether the server will shut down. The server will shut down when it has been up for at least the number of "keep alive" seconds (see above), when there are no existing connections from clients, and when the last interaction with a client was at least "idle timeout" seconds ago (see above).

LICENSE AND COPYRIGHT

Copyright (c) 2017, Marty O'Brien.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.1 or, at your option, any later version of Perl 5 you may have available.

See http://dev.perl.org/licenses/ for more information.