NAME

POEST::Server - The Poest Master General

SYNOPSIS

 my $server = POEST::Server->new(
   Config     => 'POEST::Config::Genearl',
   ConfigFile => '/etc/poest.conf',
 );
 
 $server->start;

ABSTRACT

This module controls the server itself.

DESCRIPTION

All high-level server interaction happens here.

new()

Create a new server instance. This will not make the server run, but it will configure it, load the modules and configure them, and spawn the proper POE sessions. All the parameters passed to new will be passed directly to the configurator of your choice, as defined by the Config parameter (POEST::Config by default).

run()

Make the server run. This will block execution when called directly.

start()

Fork and start the server. This method will return the pid of the server. If the pidfile configuration parameter is found in the configuration class, an attempt is made to write that pid file. If that attempt fails, or if the pid file already exists, and exception is thrown and the attempt to start the server is stalled.

stop()

Stop the server. If a pidfile was specified, the pid will be read from it. Otherwise, an attempt to find a process name with the value of $0 is tried, by default that is set to 'poest'.

NOTE: As of right this minute, the process table magic isn't written as Proc::ProcessTable isn't ported to Darwin.

Configuration

Thses are the configuration parameters that the server itself needs from the configuration mechanism.

hostname

The main host that this smtp server runs for.

port

The port this server will run on.

plugin

This is a multi-value parameter. Each value is the full name of the module that contains the plugin class.

AUTHOR

Casey West, <casey@dyndns.org>

COPYRIGHT AND LICENSE

Copyright 2003 DynDNS.org

You may distribute this package under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl README file, with the exception that it may not be placed on physical media for distribution without the prior written approval of the author.

THIS PACKAGE IS PROVIDED WITH USEFULNESS IN MIND, BUT WITHOUT GUARANTEE OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE IT AT YOUR OWN RISK.

For more information, please visit http://opensource.dyndns.org

SEE ALSO

perl, POEST::Plugin, POEST::Config, POEST::Server::Commands.

cpanm POEST::Server

perl -MCPAN -e shell
install POEST::Server