From d16c4cfd02105cdfdd92e92183e3573eb9131c03 Mon Sep 17 00:00:00 2001 From: W-Mark Kubacki Date: Tue, 25 May 2010 22:20:09 +0200 Subject: renamed: gnosek-fcgiwrap.8 -> fcgiwrap.8 --- fcgiwrap.8 | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 fcgiwrap.8 (limited to 'fcgiwrap.8') diff --git a/fcgiwrap.8 b/fcgiwrap.8 new file mode 100644 index 0000000..09b359a --- /dev/null +++ b/fcgiwrap.8 @@ -0,0 +1,82 @@ +.\" Hey, EMACS: -*- nroff -*- +.TH FCGIWRAP 8 "May 25, 2010" +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.SH NAME +fcgiwrap \- serve CGI applications over FastCGI +.SH SYNOPSIS +.B fcgiwrap +.I [OPTIONS] + +.SH DESCRIPTION +\fBfcgiwrap\fP 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). + +.SH OPTIONS +.TP +.B \-c \fInumber\fP +Number of fcgiwrap processes to prefork. +.TP +.B \-h +Show a help message and exit. + +.SH ENVIRONMENT +When running, \fBfcgiwrap\fP evaluates these environment variables set by +the web server calling a fcgi-scipt. These variables will be concatenated +and the resulting executable run as CGI script wrapped as FastCGI. + +DOCUMENT_ROOT +.RS +directory which the script resides in +.RE +SCRIPT_NAME +.RS +actual executable + +.SH EXAMPLE +Most probably you will want to launch \fBfcgiwrap\fP by +.I spawn-fcgi +using a configuration like this: + +FCGI_SOCKET=/var/run/fcgiwrap.sock +.br +FCGI_PROGRAM=/usr/sbin/fcgiwrap +.br +FCGI_USER=nginx +.br +FCGI_GROUP=www +.br +FCGI_EXTRA_OPTIONS="-M 0700" +.br +ALLOWED_ENV="PATH" + +.I Nginx +can be configured to have the arbitrary CGI +.I cgit +run as FastCGI as follows: + +location / { +.br + fastcgi_param DOCUMENT_ROOT /var/www/localhost/htdocs/cgit/; +.br + fastcgi_param SCRIPT_NAME cgit; +.br +} + +.SH AUTHOR +fcgiwrap was written by Grzegorz Nosek +with contributions by W-Mark Kubacki . +.PP +This manual page was written by Jordi Mallach , +for the Debian project (and may be used by others). -- cgit v1.2.3