summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorW-Mark Kubacki <wmark@hurrikane.de>2010-05-25 22:19:28 +0200
committerW-Mark Kubacki <wmark@hurrikane.de>2010-05-25 22:19:28 +0200
commitb094035a20a755bd85073981b4e0b06adbb89aed (patch)
treecd6589a69a25f8718264cbec4016766dd25341f5
parenta7986e6fce04416c41ac50a0369c0273ec22377e (diff)
downloadfcgiwrap-b094035a20a755bd85073981b4e0b06adbb89aed.tar.xz
fcgiwrap-b094035a20a755bd85073981b4e0b06adbb89aed.zip
added configuration examples to manpage
-rw-r--r--gnosek-fcgiwrap.846
1 files changed, 45 insertions, 1 deletions
diff --git a/gnosek-fcgiwrap.8 b/gnosek-fcgiwrap.8
index eac4a51..09b359a 100644
--- a/gnosek-fcgiwrap.8
+++ b/gnosek-fcgiwrap.8
@@ -1,5 +1,5 @@
.\" Hey, EMACS: -*- nroff -*-
-.TH FCGIWRAP 8 "April 1, 2009"
+.TH FCGIWRAP 8 "May 25, 2010"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@@ -31,8 +31,52 @@ Number of fcgiwrap processes to prefork.
.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 <root@localdomain.pl>
+with contributions by W-Mark Kubacki <wmark@hurrikane.de>.
.PP
This manual page was written by Jordi Mallach <jordi@iti.upv.es>,
for the Debian project (and may be used by others).