GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MULTIWATCH (1)

NAME

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

CONTENTS

Synopsis
Description
Options
Signal Handling
Example
See Also
Author

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>.
Search for    or go to Top of page |  Section 1 |  Main Index


--> MULTIWATCH (1) September 17, 2010

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.