dirplex: Fixed dotfile-checking typo.
[ashd.git] / doc / multifscgi.doc
1 multifscgi(1)
2 =============
3
4 NAME
5 ----
6 multifscgi - Manage multiple instances of a FastCGI or SCGI server
7
8 SYNOPSIS
9 --------
10 *multifscgi* [*-h*] 'NUM' 'PROGRAM' ['ARGS'...]
11
12 DESCRIPTION
13 -----------
14
15 *multifscgi* is a simple program intended to manage multiple running
16 instances of a FastCGI or SCGI server. It is distributed as part of
17 *ashd*(7).
18
19 The utility of multifscgi lies in the fact some FastCGI or SCGI server
20 programs, such as PHP, process at most one request at a time. As such,
21 multiple such server processes must run simultaneously in order to
22 process requests concurrently.
23
24 The *multifscgi* program works simply by forking 'NUM' instances of
25 whatever program it is given on its command line. As long as the SCGI
26 or FastCGI listen socket is passed on standard input, it will be
27 naturally inherited by those child processes, and whichever one of
28 them is currently idle will be able to accept a request. If any of the
29 children terminate, a new one will be started in its place.
30
31 OPTIONS
32 -------
33
34 *-h*::
35
36         Print a brief help message to standard output and exit.
37
38 SIGNALS
39 -------
40
41 SIGTERM, SIGINT::
42
43         Terminate cleanly be killing off any remaining child
44         processes.
45
46 AUTHOR
47 ------
48 Fredrik Tolf <fredrik@dolda2000.com>
49
50 SEE ALSO
51 --------
52 *callscgi*(1), *callfcgi*(1), *ashd*(7)