Forks and watches multiple instances of a program in the same context (environment + fds) https://redmine.lighttpd.net/projects/multiwatch
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

51 lines
1.5 KiB

  1. .TH multiwatch 1 "September 17, 2010"
  2. .SH NAME
  3. multiwatch \- forks and watches multiple instances of a program in the same environment
  4. .SH SYNOPSIS
  5. .B multiwatch
  6. [options] \-\- <application> [app arguments]
  7. .B multiwatch
  8. \-v
  9. .B multiwatch
  10. \-\-help | \-?
  11. .SH DESCRIPTION
  12. \fImultiwatch\fP is used to fork and watch multiple FastCGI backends.
  13. .SH OPTIONS
  14. .TP 8
  15. .B \-f, \-\-forks=children
  16. Number of children to fork and watch (default 1)
  17. .TP 8
  18. .B \-r, \-\-retry=retries
  19. Number of retries to fork a single child (default 3)
  20. .TP 8
  21. .B \-t, \-\-timeout=msecs
  22. Retry timeout in ms; if the child dies after the timeout the retry counter is reset (default 10000 ms = 10 s)
  23. .TP 8
  24. .B \-s, \-\-signal=signame
  25. Signal to send to children to signal 'graceful' termination (HUP,INT,QUIT,TERM,USR1,USR2, default is USR1)
  26. .TP 8
  27. .B \-?, \-\-help
  28. General usage instructions
  29. .TP 8
  30. .B \-v, \-\-version
  31. Show version and exit
  32. .SH SIGNAL HANDLING
  33. multiwatch will forward the signal USR2; if it receives HUP,INT,QUIT,TERM or USR1, it will send the
  34. signal from \-\-signal to the children; if it receives another signal from that group, it will forward the
  35. signal again.
  36. A signal of the group HUP,INT,QUIT,TERM and USR1 tells multiwatch to go into "shutdown" mode, so it won't
  37. restart children after receiving it.
  38. .SH EXAMPLE
  39. .TP 8
  40. Spawn 2 rails instances on the same FastCGI socket (and supervise them):
  41. .RS 8
  42. .B spawn\-fcgi \-s /tmp/fastcgi\-rails.sock \-n \-\- /usr/bin/multiwatch \-f 2 /home/rails/public/dispatch.fcgi
  43. .RE
  44. .SH SEE ALSO
  45. spawn\-fcgi(1)
  46. .SH AUTHOR
  47. Stefan Buehler <stbuehler@web.de>.