|author||Stefan Bühler <email@example.com>||2009-03-26 15:45:11 +0000|
|committer||Stefan Bühler <firstname.lastname@example.org>||2009-03-26 15:45:11 +0000|
Updated man page
git-svn-id: svn://svn.lighttpd.net/spawn-fcgi/trunk@31 4a9f3682-ca7b-49a8-9a55-ba4640e46f83
2 files changed, 71 insertions, 23 deletions
@@ -7,6 +7,7 @@ NEWS
* Add build date to show-version
* Added options to chown/chmod the socket and to create the socket before chroot() (fixes #1906)
+ * Updated man page
- 1.6.0 - 2009-02-28
diff --git a/spawn-fcgi.1 b/spawn-fcgi.1
index 179410e..8f72e54 100644
@@ -1,34 +1,57 @@
-.TH spawn-fcgi 1 2009-02-06
+.TH spawn-fcgi 1 "26 March 2009"
spawn-fcgi \- Spawns FastCGI processes
[options] [ -- <fcgiapp> [fcgi app arguments]]
-\fIspawn-fcgi\fP is used to spawn remote FastCGI processes (but may be used
-for local processes, too).
+\fIspawn-fcgi\fP is used to spawn remote and local FastCGI processes.
+While it is obviously needed to spawn remote FastCGI backends (the webserver
+can only spawnn local ones), it is recommended to spawn local backends
+with spawn-fcgi, too.
+Reasons why you may want to use spawn-fcgi instead of something else:
+.IP * 3
+Privilege separation without needing a suid-binary or running a server as root.
+.IP * 3
+You can restart your webserver and the FastCGI applications without restarting the others.
+.IP * 3
+You can run them in different chroot()s.
+.IP * 3
+Running your FastCGI applications doesn't depend on the webserver you are running,
+which allows for easier testing of other webservers.
\fIspawn-fcgi\fP accepts the following options:
.B \-f <path>
-Filename of the FastCGI application to spawn. If you need to specify
-additional arguments, specify the application and its parameters after "--";
-this option is ignored if <fcgiapp> is given.
+Filename of the FastCGI application to spawn. This option is deprecated and it
+is recommend to always specify the application (absolute path) and its parameters after "--";
+This option is ignored if fcgiapp is given.
.B \-a <addr>
-IP address to bind to (for TCP/IP-based IPC)
+IP address to bind to; only used if \-p is given too.
.B \-p <port>
-TCP port to bind to (for TCP/IP-based IPC)
+TCP port to bind to; you cannot combine this with the \-s option.
.B \-s <path>
-Path to the Unix-domain socket to bind to (for Unix sockets-based IPC)
+Path to the Unix-domain socket to bind to; you cannot combine this with the \-p option.
.B \-C <children>
(PHP only) Number of children to spawn by setting the PHP_FCGI_CHILDREN
@@ -36,7 +59,10 @@ environment variable. Default is not to overwrite the environment variable;
php will spawn no childs if the var is not set (same as setting it to 0).
.B \-F <children>
-Number of children to fork. Defaults to 1.
+Number of children to fork, defaults to 1. This option doesn't work with \-n,
+have a look at
+if you want to supervise multiple forks on the same socket.
.B \-P <path>
Name of the PID file for spawned processes (ignored in no-fork mode)
@@ -44,21 +70,42 @@ Name of the PID file for spawned processes (ignored in no-fork mode)
No forking should take place (for daemontools)
+.B \-M <mode>
+Change file mode of the unix socket; only used if \-s is given too.
+.B \-?, \-h
+General usage instructions
+Shows version information and exits
+The following options are only available if you invoke spawn-fcgi as root:
.B \-c <dir>
-Chroot to specified directory (can only be invoked by root)
+Chroot to specified directory; the unix socket is created inside the chroot unless \-S is given.
+Create unix socket before chroot()ing.
-User ID to change to (can only be invoked by root)
+User ID to change to.
-Group ID to change to (can only be invoked by root). Defaults to primary group
-of user if -u is given,
+Group ID to change to. Defaults to primary group of the user given for \-u.
-.B \-?, \-h
-General usage instructions
+Change user of the unix socket, defaults to the value of \-u. (only used if \-s is given)
-Shows version information and exits
-This manual page was written by Gunnar Wolf <email@example.com>, for
-the Debian GNU/linux system (but may be used by others).
+Change group of the unix socket, defaults to the primary group of the user given for \-U;
+if \-U wasn't given, defaults to the value of \-g. (only used if \-s is given)
+.SH "SEE ALSO"