renamed: gnosek-fcgiwrap.8 -> fcgiwrap.8

1 files changed, 82 insertions, 0 deletions

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 <n>    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 <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).