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.

50 lines
1.5 KiB

11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
  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>.