NAME

Net::Clacks::Server - server for CLACKS interprocess messaging

SYNOPSIS

use Net::Clacks::Server;

DESCRIPTION

This implements the server for the CLACKS interprocess messaging protocol. It supports Interclacks mode, for a master/client server architecture.

new

Create a new instance.

init

DEPRECATED: Initialize server instance (required before running). This is now a dummy function that will show a deprecation warning and return. Initialization is now done automatically when calling run().

run

Run the server instance in it's own event loop. Only returns when server is shutdown.

runOnce

Run through the event loop once. This allows you to use your own programs event loop, and call runOnce a couple of times per second. It is a good idea to call runShutdown() to cleanly disconnect clients before exiting your program. runOnce() returns a "work count" number, on which you *may* decide on how busy the server is and when to call runOnce() next.

runShutdown

Shuts down all connections. This is called automatically if you use run(), but not if you use runOnce()

IMPORTANT NOTE

Please make sure and read the documentations for Net::Clacks as it contains important information pertaining to upgrades and general changes!

AUTHOR

Rene Schickbauer, <cavac@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2008-2023 Rene Schickbauer

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.0 or, at your option, any later version of Perl 5 you may have available.