diff --git a/README.html b/README.html new file mode 100644 index 0000000..fdc21a3 --- /dev/null +++ b/README.html @@ -0,0 +1,114 @@ + + + +To clone this repository, issue the following command: +
+ $ git-clone git://stbuehler.de/spawn-fcgi.git
+
+ +

Branches

+

+master: master branch
+debian: patch for debian package - will be rebased, so you may need to force updates with -f
+

+ +

Original home

+ +

+Source based on spawn-fcgi from lighttpd, +rewritten for external packaging and some extra features: +

+

+ +

+Includes modified code from the Linux-PAM project +for the limits. +

+ +

Description

+

+spawn-fcgi prepares the environment for fastcgi applications; it opens a socket (tcp / unix-domain) +on filedescriptor 0, changes uid/gid for process and unix-domain socket, closes STDIN/STDOUT, ... +

+ +

Usage

+ +

+Examples for daemontools (with lighttpd on debian):
+ +For php5: +

+
+#!/bin/sh
+
+exec 2>&1
+exec /usr/bin/spawn-fcgi -s /var/run/lighttpd/php-webuser.sock -n -u webuser -U www-data -l -- /usr/bin/php5-cgi
+
+ +

+For turbogears: +

+

+#!/bin/sh
+
+exec 2>&1
+cd /var/www/tgapp
+exec /usr/bin/spawn-fcgi -s /var/run/lighttpd/tgapp.sock -n -u tg-user -U www-data -- /var/www/tg-app/start-tgapp-fcgi.py prod.cfg
+
+ +

+/var/www/tg-app/start-tgapp-fcgi.py:
+

+

+#!/usr/bin/env python
+import pkg_resources
+import cherrypy
+import sys
+
+cherrypy.lowercase_api = True
+
+pkg_resources.require("TurboGears")
+
+from cherrypy._cpwsgi       import wsgiApp
+from flup.server.fcgi       import WSGIServer
+from os.path                import *
+
+import turbogears
+
+if len(sys.argv) > 1:
+    configfile = sys.argv[1]
+elif exists(join(dirname(__file__), "setup.py")):
+    configfile = "dev.cfg"
+else:
+    configfile = "prod.cfg"
+
+turbogears.update_config(configfile=configfile, modulename="tgapp.config")
+
+from tgapp.controllers import Root
+
+cherrypy.root = Root()
+
+cherrypy.server.start(initOnly=True, serverClass=None)
+
+WSGIServer(application=wsgiApp).run()
+
+ +

+spawn-fcgi is released under a BSD license, which may be found in the source files: +

+spawn-fcgi.c:
+	Copyright (c) 2004, Jan Kneschke, incremental
+	All rights reserved.
+pam_limits.c:
+	Copyright (c) Cristian Gafton, 1996-1997, >gafton@redhat.com<
+	All rights reserved.
+
+