1multiwatch(1)               General Commands Manual              multiwatch(1)
2
3
4

NAME

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

SYNOPSIS

10       multiwatch [options] -- <application> [app arguments]
11
12       multiwatch -v
13
14       multiwatch --help | -?
15

DESCRIPTION

17       multiwatch is used to fork and watch multiple FastCGI backends.
18

OPTIONS

20       -f, --forks=children
21               Number of children to fork and watch (default 1)
22
23       -r, --retry=retries
24               Number of retries to fork a single child (default 3)
25
26       -t, --timeout=msecs
27               Retry timeout in ms; if the child dies after  the  timeout  the
28               retry counter is reset (default 10000 ms = 10 s)
29
30       -s, --signal=signame
31               Signal  to  send  to  children to signal 'graceful' termination
32               (HUP,INT,QUIT,TERM,USR1,USR2, default is USR1)
33
34       -?, --help
35               General usage instructions
36
37       -v, --version
38               Show version and exit
39

SIGNAL HANDLING

41       multiwatch   will   forward   the   signal   USR2;   if   it   receives
42       HUP,INT,QUIT,TERM or USR1, it will send the signal from --signal to the
43       children; if it receives another signal from that group, it  will  for‐
44       ward the signal again.
45
46       A signal of the group HUP,INT,QUIT,TERM and USR1 tells multiwatch to go
47       into "shutdown" mode, so it won't restart children after receiving it.
48

EXAMPLE

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

SEE ALSO

56       spawn-fcgi(1)
57

AUTHOR

59       Stefan Buehler <stbuehler@web.de>.
60
61
62
63                              September  17, 2010                multiwatch(1)