jammy (3) FCGI::Engine::ProcManager.3pm.gz

Provided by: libfcgi-engine-perl_0.22-1.1_all bug

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 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.