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 receives	another	signal from that group,	it  will  for-
       ward 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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SIGNAL HANDLING | EXAMPLE | SEE ALSO | AUTHOR

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

home | help