NAME

POEST::Server - The Poest Master General

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 in 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@geeknest.com>

COPYRIGHT

Copyright (c) 2003 Casey West. All rights reserved. This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

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