From b094035a20a755bd85073981b4e0b06adbb89aed Mon Sep 17 00:00:00 2001 From: W-Mark Kubacki Date: Tue, 25 May 2010 22:19:28 +0200 Subject: added configuration examples to manpage --- gnosek-fcgiwrap.8 | 46 +++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 45 insertions(+), 1 deletion(-) (limited to 'gnosek-fcgiwrap.8') 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 +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