From 9541b9d885087474f71c66b272a0a0ae721dcc0d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20B=C3=BChler?= Date: Wed, 29 May 2013 13:46:45 +0200 Subject: [PATCH] make README a proper formatted README.rst --- README | 2 -- README.rst | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 54 insertions(+), 2 deletions(-) delete mode 100644 README create mode 100644 README.rst diff --git a/README b/README deleted file mode 100644 index 6919976..0000000 --- a/README +++ /dev/null @@ -1,2 +0,0 @@ - -fcgi-cgi is a FastCGI application to run cgi applications. diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..14825f4 --- /dev/null +++ b/README.rst @@ -0,0 +1,54 @@ +Description +----------- + +:Homepage: + http://redmine.lighttpd.net/projects/fcgi-cgi/wiki + +fcgi-cgi is a FastCGI application to run normal cgi applications. It doesn't +make CGI applications faster, but it allows you to run them on a different +host and with different user permissions (without the need for suexec). + +lighttpd2 won't have a mod_cgi, so you need this FastCGI wrapper to be able +to execute standard cgi applications like mailman and cgit. + +fcgi-cgi is released under the `MIT license `_ + +Usage +----- + +Examples for spawning a fcg-cgi instance with daemontools or runit:: + + #!/bin/sh + # run script + + exec spawn-fcgi -n -s /tmp/fastcgi-cgi.sock -u www-default -U www-data -- /usr/bin/fcgi-cgi + + +Build dependencies +------------------ + +* glib >= 2.16.0 (http://www.gtk.org/) +* libev (http://software.schmorp.de/pkg/libev.html) +* cmake or autotools (for snapshots/releases the autotool generated files are included) + + +Build +----- + +* snapshot/release with autotools:: + + ./configure + make + +* build from git: ``git clone git://git.lighttpd.net/fcgi-cgi.git`` + + * with autotools:: + + ./autogen.sh + ./configure + make + + * with cmake (should work with snapshots/releases too):: + + cmake . + make