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 ++ +
+master: master branch
+debian: patch for debian package - will be rebased, so you may need to force updates with -f
+
+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. +
+ ++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, ... +
+ +
+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. ++