NAME

       FCGI::Engine::ProcManager - module for managing FastCGI applications.

DESCRIPTION

       This module is a refactoring of FCGI::ProcManager, it behaves exactly the same, but the
       API is a little different. The function-oriented API has been removed in favor of object-
       oriented API. The "pm_" prefix has been removed from  the hook routines and instead they
       now use the "augment" and "inner" functionality from Moose. More docs will come
       eventually.

   Signal Handling
       FCGI::Engine::ProcManager attempts to do the right thing for proper shutdowns.

       When it receives a SIGHUP, it sends a SIGTERM to each of its children, and then resumes
       its normal operations.

       When it receives a SIGTERM, it sends a SIGTERM to each of its children, sets an alarm(3)
       "die timeout" handler, and waits for each of its children to die.  If all children die
       before this timeout, process manager exits with return status 0.  If all children do not
       die by the time the "die timeout" occurs, the process manager sends a SIGKILL to each of
       the remaining children, and exists with return status 1.

       FCGI::Engine::ProcManager uses POSIX::sigaction() to override the default SA_RESTART
       policy used for perl's %SIG behavior.  Specifically, the process manager never uses
       SA_RESTART, while the child FastCGI servers turn off SA_RESTART around the accept loop,
       but re-enstate it otherwise.

       The desired (and implemented) effect is to give a request as big a chance as possible to
       succeed and to delay their exits until after their request, while allowing the FastCGI
       servers waiting for new requests to die right away.

METHODS

       I will fill this in more eventually, but for now if you really wanna know, read the
       source.

SEE ALSO

       FCGI::ProcManager
           This module is a fork of the FCGI::ProcManager code, with lots of code cleanup as well
           as general Moosificaition.

BUGS

       All complex software has bugs lurking in it, and this module is no exception. If you find
       a bug please either email me, or add the bug to cpan-RT.

AUTHOR

       Stevan Little <stevan@iinteractive.com>

COPYRIGHT AND LICENSE

       Copyright 2007-2010 by Infinity Interactive, Inc.

       <http://www.iinteractive.com>

       This library is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.