Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
multiwatch(1)		     General Commands Manual		   multiwatch(1)

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 re-
     ceives 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=multiwatch&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help