aboutsummaryrefslogtreecommitdiff
path: root/README.rst
blob: 5738504b6c89c04b8497efc5cd72f587bd6ef9d2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
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 <http://git.lighttpd.net/fcgi-cgi.git/tree/COPYING>`_

Usage
-----

Examples for spawning a fcgi-cgi instance with daemontools or runit::

  #!/bin/sh
  # run script

  exec spawn-fcgi -n -s /var/run/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