spawn-fcgi
(1)
Name
spawn-fcgi - Spawns FastCGI processes
Synopsis
spawn-fcgi [options] [ -- <fcgiapp> [fcgi app arguments]]
spawn-fcgi -v
spawn-fcgi -h
Description
User Commands spawn-fcgi(1)
NAME
spawn-fcgi - Spawns FastCGI processes
SYNOPSIS
spawn-fcgi [options] [ -- <fcgiapp> [fcgi app arguments]]
spawn-fcgi -v
spawn-fcgi -h
DESCRIPTION
spawn-fcgi is used to spawn remote and local FastCGI pro-
cesses.
While it is obviously needed to spawn remote FastCGI back-
ends (the web server can only spawn local ones), it is rec-
ommended to spawn local backends with spawn-fcgi, too.
Reasons why you may want to use spawn-fcgi instead of some-
thing else:
* Privilege separation without needing a suid-binary or
running a server as root.
* You can restart your web server and the FastCGI applica-
tions without restarting the others.
* You can run them in different chroot()s.
* Running your FastCGI applications doesn't depend on the
web server you are running, which allows for easier test-
ing of other web servers.
OPTIONS
spawn-fcgi accepts the following options:
-f <path>
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 "--"; the fcgiapp parameter is
directly used for the exec() call, while for start-
ing the binary given with -f /bin/sh is needed
(which may not be available in a chroot).
This option is ignored if fcgiapp is given.
-d <path>
Change the current directory before spawning the
application.
-a <address>
SunOS 5.11 Last change: 26 March 2009 1
User Commands spawn-fcgi(1)
IPv4/IPv6 address to bind to; only used if -p is
given too. Defaults to "0.0.0.0" (IPv4).
-p <port>
TCP port to bind to; you cannot combine this with
the -s option.
-s <path>
Path to the Unix domain socket to bind to; you can-
not combine this with the -p option.
-C <children>
(PHP only) Number of children to spawn by setting
the PHP_FCGI_CHILDREN environment variable. Default
is not to overwrite the environment variable; php
will spawn no children if the variable is not set
(same as setting it to 0).
-F <children>
Number of children to fork, defaults to 1. This
option doesn't work with -n, have a look at multi-
watch(1) if you want to supervise multiple forks on
the same socket.
-P <path>
Name of the PID file for spawned processes (ignored
in no-fork mode)
-n No forking should take place (for daemontools)
-M <mode>
Change file mode of the Unix domain socket; only
used if -s is given too.
-?, -h General usage instructions
-v Shows version information and exits
The following options are only available if you invoke
spawn-fcgi as root:
-c <directory>
Chroot to specified directory; the Unix domain
socket is created inside the chroot unless -S is
given.
-S Create Unix domain socket before chroot().
-u User ID to change to.
-g Group ID to change to. Defaults to primary group of
the user given for -u.
SunOS 5.11 Last change: 26 March 2009 2
User Commands spawn-fcgi(1)
-U Change user of the Unix domain socket, defaults to
the value of -u. (only used if -s is given)
-G Change group of the Unix domain 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)
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------------+
|Availability | web/fastcgi/spawn-fcgi |
+---------------+------------------------+
|Stability | Uncommitted |
+---------------+------------------------+
SEE ALSO
svc(8), supervise(8), see http://cr.yp.to/daemontools.html
multiwatch(1), see http://cgit.stbuehler.de/gitosis/multi-
watch/about/
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from
http://www.lighttpd.net/download/spawn-fcgi-1.6.3.tar.gz
Further information about this software can be found on the
open source community website at http://www.lighttpd.net/.
SunOS 5.11 Last change: 26 March 2009 3