NAME

       multiwatch - forks and watches multiple instances of a program in the same environment

SYNOPSIS

       multiwatch [options] -- <application> [app arguments]

       multiwatch -v

       multiwatch --help | -?

DESCRIPTION

       multiwatch is used to fork and watch multiple FastCGI backends.

OPTIONS

       -f, --forks=children
               Number of children to fork and watch (default 1)

       -r, --retry=retries
               Number of retries to fork a single child (default 3)

       -t, --timeout=msecs
               Retry  timeout  in  ms;  if  the child dies after the timeout the retry counter is
               reset (default 10000 ms = 10 s)

       -s, --signal=signame
               Signal   to    send    to    children    to    signal    'graceful'    termination
               (HUP,INT,QUIT,TERM,USR1,USR2, default is USR1)

       -?, --help
               General usage instructions

       -v, --version
               Show version and exit

SIGNAL HANDLING

       multiwatch will forward the signal USR2; if it receives HUP,INT,QUIT,TERM or USR1, it will
       send the signal from --signal to the children; if it receives  another  signal  from  that
       group, it will forward the signal again.

       A  signal  of  the group HUP,INT,QUIT,TERM and USR1 tells multiwatch to go into "shutdown"
       mode, so it won't restart children after receiving it.

EXAMPLE

       Spawn 2 rails instances on the same FastCGI socket (and supervise them):
               spawn-fcgi   -s   /tmp/fastcgi-rails.sock   -n   --   /usr/bin/multiwatch   -f   2
               /home/rails/public/dispatch.fcgi

SEE ALSO

       spawn-fcgi(1)

AUTHOR

       Stefan Buehler <stbuehler@web.de>.

                                       September  17, 2010                          multiwatch(1)