NAME AnyEvent::Watchdog - generic watchdog/program restarter SYNOPSIS # MUST be use'd as the very first thing in the main program, # as it clones/forks the program before it returns. use AnyEvent::Watchdog; DESCRIPTION This module implements a watchdog that can repeatedly fork the program and thus effectively restart it - as soon as the module is use'd, it will fork the program (if possible) and continue to run it normally in the child, while the parent becomes a supervisor. The child can then ask the supervisor to restart itself instead of exiting, or ask the supervisor to restart it gracefully or forcefully. NOTE: This module *MUST* be used as the first thing in the main program. It will cause weird effects when used from another module, as perl does not expect to be forked inside "BEGIN" blocks. RECIPES Use AnyEvent::Watchdog solely as a convenient on-demand-restarter: use AnyEvent::Watchdog; # and whenever you want to restart (e.g. to upgrade code): use AnyEvent::Watchdog::Util; AnyEvent::Watchdog::Util::restart; Use AnyEvent::Watchdog to kill the program and exit when the event loop fails to run for more than two minutes: use AnyEvent::Watchdog autorestart => 1, heartbeat => 120; Use AnyEvent::Watchdog to automatically kill (but not restart) the program when it fails to handle events for longer than 5 minutes: use AnyEvent::Watchdog heartbeat => 300; VARIABLES/FUNCTIONS This module is controlled via the AnyEvent::Watchdog::Util module: use AnyEvent::Watchdog::Util; # attempt restart AnyEvent::Watchdog::Util::restart; # check if it is running AnyEvent::Watchdog::Util::enabled or croak "not running under watchdog!"; SEE ALSO AnyEvent::Watchdog::Util, AnyEvent. AUTHOR Marc Lehmann <schmorp@schmorp.de> http://home.schmorp.de/