Section: Maintenance Commands (8)Updated: Jun 3, 2010Local indexUp
fcgiwrap - serve CGI applications over FastCGI
fcgiwrap is a simple server for running CGI applications over
FastCGI. It hopes to provide clean CGI support to Nginx (and other web servers
that may need it).
Number of fcgiwrap processes to prefork.
A URL for the listen socket to bind to. By default fcgiwrap expects
a listen socket to be passed on file descriptor 0, matching the FastCGI convention.
The recommended way to deploy fcgiwrap is to run it under a process manager that
takes care of opening the socket. However, for simple configurations and one-off
tests this option may be used. Valid socket_urls include unix:/path/to/unix/socket,
tcp:dot.ted.qu.ad:port and tcp6:[ipv6_addr]:port.
Show a help message and exit.
When running, fcgiwrap evaluates these environment variables set by
the web server calling an fcgi-script. The variables DOCUMENT_ROOT and
SCRIPT_NAME will be concatenated and the resulting executable run as CGI
script wrapped as FastCGI, with the remainder after the script name
available as PATH_INFO. To disable PATH_INFO mangling, set up your web
server to pass SCRIPT_FILENAME, which should contain the complete path to
the script. Then PATH_INFO will not be modified.
directory which the script resides in
complete path to CGI script. When set, overrides DOCUMENT_ROOT and SCRIPT_NAME
The fastest way to see fcgiwrap do something is to launch it at the command line
fcgiwrap -s unix:/var/run/fcgiwrap.sock
Apart from potential permission problems etc., it should be ready to accept FastCGI
requests and run CGI scripts.
Most probably you will want to launch fcgiwrap by
using a configuration like this: