rpms/mod_fcgid/devel mod_fcgid-2.1-README.Fedora, NONE, 1.1 mod_fcgid-2.1-README.SELinux, NONE, 1.1 mod_fcgid.2.1-docurls.patch, NONE, 1.1 .cvsignore, 1.3, 1.4 configuration.htm, 1.2, 1.3 doc.htm, 1.2, 1.3 fcgid.conf, 1.1, 1.2 mod_fcgid.spec, 1.3, 1.4 sources, 1.3, 1.4 README.Fedora, 1.2, NONE README.SELinux, 1.2, NONE mod_fcgid.1.09-docurls.patch, 1.1, NONE
Paul Howarth (pghmcfc)
fedora-extras-commits at redhat.com
Fri Feb 16 14:20:35 UTC 2007
Author: pghmcfc
Update of /cvs/extras/rpms/mod_fcgid/devel
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv15250
Modified Files:
.cvsignore configuration.htm doc.htm fcgid.conf mod_fcgid.spec
sources
Added Files:
mod_fcgid-2.1-README.Fedora mod_fcgid-2.1-README.SELinux
mod_fcgid.2.1-docurls.patch
Removed Files:
README.Fedora README.SELinux mod_fcgid.1.09-docurls.patch
Log Message:
Update to 2.1
--- NEW FILE mod_fcgid-2.1-README.Fedora ---
Using mod_fcgid in Fedora
=========================
This mod_fcgid package includes a configuration file
/etc/httpd/conf.d/fcgid.conf that ensures that the module is loaded and
added as the handler for .fcg, .fcgi, and .fpl applications (provided
mod_fastcgi in not already loaded, in which case you will need to decide which
module should handle which types of application).
So far the module package has only been tested in conjunction with the "moin"
wiki application. Further feedback regarding other applications is welcome.
Setting up moin with mod_fcgid
==============================
Setting up moin with mod_fcgid is very similar to setting it up as a regular
CGI application.
* Create a directory for your wiki instance:
DESTDIR=/var/www/mywiki
mkdir -p $DESTDIR/cgi-bin
* Copy in the wiki template data and the application itself:
cp -a /usr/share/moin/{data,underlay} $DESTDIR
cp -a /usr/share/moin/server/moin.fcg $DESTDIR/cgi-bin
cp -a /usr/share/moin/config/wikiconfig.py $DESTDIR/cgi-bin
* Fix the directory ownership
chown -R apache:apache $DESTDIR/{data,underlay}
* Edit $DESTDIR/cgi-bin/wikiconfig.py to suit your needs
* Create a httpd configuration file for the wiki, e.g.
/etc/httpd/conf.d/mywiki.conf
# Wiki application data common to all wiki instances
Alias /wiki/ "/usr/share/moin/htdocs/"
<Directory "/usr/share/moin/htdocs/">
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
# Wiki instance with mod_fcgid
<IfModule mod_fcgid.c>
ScriptAlias /mywiki "/var/www/mywiki/cgi-bin/moin.fcg"
<Directory "/var/www/mywiki/cgi-bin/">
Options Indexes FollowSymLinks ExecCGI
AllowOverride None
Order allow,deny
Allow from all
</Directory>
</IfModule>
* If you are using SELinux with Fedora Core 5 or later, install the
mod_fcgid-selinux package and see the README.SELinux file in that package
for details of the file contexts to use
* Restart the web server to load the new configuration:
service httpd restart
That should do it!
--- NEW FILE mod_fcgid-2.1-README.SELinux ---
Using mod_fcgid with SELinux in Fedora Core 5 onwards
=====================================================
Versions of this package built for Fedora Core 5 or later include an SELinux
policy module to support FastCGI applications. This has only been tested so far
with moin, so feedback from other applications is welcome. The intention is for
this module to be included in the SELinux reference policy eventually.
The module source (fastcgi.{fc,te}) is included for reference as documentation
in the package.
The module introduces a new set of SELinux types for FastCGI applications,
comparable with the types described in "man httpd_selinux" for regular CGI
scripts (or "system scripts" as they are known in SELinux):
* httpd_fastcgi_content_t (equivalent to httpd_sys_content_t)
- Set files with httpd_fastcgi_content_t for content that is available
from all FastCGI scripts and the daemon.
* httpd_fastcgi_script_exec_t (equivalent to httpd_sys_script_exec_t)
- Set FastCGI scripts with httpd_fastcgi_script_exec_t to allow them to run
with access to all fastcgi types.
* httpd_fastcgi_script_ro_t (equivalent to httpd_sys_script_ro_t)
- Set files with httpd_fastcgi_script_ro_t if you want
httpd_fastcgi_script_exec_t scripts to read the data, and disallow other
non-fastcgi scripts from access.
* httpd_fastcgi_script_rw_t (equivalent to httpd_sys_script_rw_t)
- Set files with httpd_fastcgi_script_rw_t if you want
httpd_fastcgi_script_exec_t scripts to read/write the data, and disallow
other non-fastcgi scripts from access.
* httpd_fastcgi_script_ra_t (equivalent to httpd_sys_script_ra_t)
- Set files with httpd_fastcgi_script_ra_t if you want
httpd_fastcgi_script_exec_t scripts to read/append to the file, and
disallow other non-fastcgi scripts from access.
So for the moin wiki layout described in README.Fedora of the main mod_fcgid
package, the contexts would be set as follows:
cd /var/www/mywiki
chcon -t httpd_fastcgi_content_t .
chcon -R -t httpd_fastcgi_script_exec_t cgi-bin
chcon -R -t httpd_fastcgi_script_rw_t data underlay
It is necessary to turn on the httpd_enable_cgi boolean to run either regular
or FastCGI scripts:
setsebool -P httpd_enable_cgi 1
If the httpd_unified boolean is set, "sys" and "fastcgi" scripts can access
each other's data. This means that you only need to set the actual FastCGI
scripts themselves to httpd_fastcgi_script_exec_t and can leave the file
contexts for everything else set to the "sys" types if you prefer. This is
useful if you have a mixture of CGI and FastCGI applications accessing the
same data.
If you have any questions or issues regarding FastCGI and SELinux, please don't
hesitate to bring them up on fedora-selinux-list.
mod_fcgid.2.1-docurls.patch:
--- NEW FILE mod_fcgid.2.1-docurls.patch ---
--- mod_fcgid.2.1/directives.htm 2007-02-16 03:40:23.000000000 +0000
+++ mod_fcgid.2.1/directives.htm 2007-02-16 10:45:44.000000000 +0000
@@ -14,10 +14,10 @@
<tr>
<td align="left" bgcolor="#f8eda6" nowrap="nowrap"> <a
href="index.htm">Home</a> <br>
- <a href="index.cn.htm">Chinese Info</a> <br>
- <a href="download.htm">Download (source)</a> <br>
- <a href="doc.htm">Documentations</a> <br>
- <a href="feedback.htm">Feedback</a> <br>
+ <a href="http://fastcgi.coremail.cn/index.cn.htm">Chinese Info</a> <br>
+ <a href="http://fastcgi.coremail.cn/download.htm">Download (source)</a> <br>
+ <a href="http://fastcgi.coremail.cn/doc.htm">Documentations</a> <br>
+ <a href="http://fastcgi.coremail.cn/feedback.htm">Feedback</a> <br>
<a
href="http://sourceforge.net/donate/index.php?group_id=174879"><img
src="http://images.sourceforge.net/images/project-support.jpg"
Index: .cvsignore
===================================================================
RCS file: /cvs/extras/rpms/mod_fcgid/devel/.cvsignore,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- .cvsignore 31 Oct 2006 18:37:08 -0000 1.3
+++ .cvsignore 16 Feb 2007 14:20:03 -0000 1.4
@@ -1 +1 @@
-mod_fcgid.2.0.tar.gz
+mod_fcgid.2.1.tar.gz
Index: configuration.htm
===================================================================
RCS file: /cvs/extras/rpms/mod_fcgid/devel/configuration.htm,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- configuration.htm 31 Oct 2006 18:37:08 -0000 1.2
+++ configuration.htm 16 Feb 2007 14:20:03 -0000 1.3
@@ -1,156 +1,238 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
-
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
-<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
-<meta name="ProgId" content="FrontPage.Editor.Document">
-<title>The mod_fcgid Home Page</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=gb2312">
+ <meta name="GENERATOR" content="Microsoft FrontPage 4.0">
+ <meta name="ProgId" content="FrontPage.Editor.Document">
+ <title>The mod_fcgid Home Page</title>
</head>
-
<body>
-
-<p><b><a name="regular fastcgi"></a>This is a for regular fastcgi. </b><p>LoadModule fcgid_module
-modules/mod_fcgid.so<p>
-<Location /fcgid><br>
- SetHandler fcgid-script<br>
- Options ExecCGI<br>
- allow from all<br>
-</Location><p>
-
-<hr>
-<p><b><a name="suEXEC"></a>This is for suEXEC. Please get more information about suEXEC <a href="http://httpd.apache.org/docs-2.0/suexec.html">here</a>. </b><p>LoadModule fcgid_module
-modules/mod_fcgid.so<p>
-<Location /fcgid><br>
- SetHandler fcgid-script<br>
- Options ExecCGI<br>
- allow from all<br>
-</Location><p>
-<VirtualHost 192.168.1.89><br>
- ServerAdmin <a href="mailto:webmaster at host.foo.com">webmaster at host.foo.com<br>
-</a> DocumentRoot /usr/local/apache2/htdocs/<br>
- ServerName host.foo.com<br>
- SuexecUserGroup pqf pqf<br>
-</VirtualHost><p>
-¡¡
-<hr>
-<p><b><a name="PHP"></a>This is for fastcgi-mode PHP (UNIX)</b><p>LoadModule fcgid_module modules/mod_fcgid.so<p>
-<Directory /usr/local/apache2/htdocs/php><br>
- SetHandler fcgid-script<br>
- FCGIWrapper /usr/local/bin/php .php<br>
- Options ExecCGI<br>
- allow from all<br>
-</Directory><p><b>This works too:</b><p>LoadModule fcgid_module
-modules/mod_fcgid.so <p>
-AddHandler fcgid-script .php<br>
-<Directory /usr/local/apache2/htdocs/php><br>
- FCGIWrapper /usr/local/bin/php .php<br>
- Options ExecCGI<br>
- allow from all<br>
-</Directory><p><b># Please make sure:<br>
-# php is configured with --enable-fastcgi option<br>
-# check error_log(with debug level), if
-any thing goes wrong</b>
-<hr>
-<p><b><a name="suPHP"></a>This is for suPHP ( UNIX )</b>
-<p>LoadModule fcgid_module modules/mod_fcgid.so<br>
-<br>
-<VirtualHost *:80><br>
- ServerName test2.example.com<br>
- DocumentRoot /usr/local/apache2/htdocs/test2.example.com/<br>
- SuexecUserGroup pqf pqf<br>
-</VirtualHost><br>
-<br>
-<Directory /usr/local/apache2/htdocs/test2.example.com/><br>
- AddHandler fcgid-script .php<br>
- Options ExecCGI<br>
- allow from all<br>
- FCGIWrapper /usr/local/apache2/htdocs/test2.example.com/php .php<br>
-</Directory></p>
-<p>
-<b>
-# Please make sure:<br>
-# php is configured with --enable-fastcgi option<br>
-# copy php execution to /usr/local/apache2/htdocs/test2.example.com/ directory<br>
-# make sure all files in /usr/local/apache2/htdocs/test2.example.com/ with right
-owner and group<br>
-# check error_log(with debug level) and suexec_log, if
-any thing goes wrong</b>
+<p><b><a name="regular fastcgi"></a>This is a for regular fastcgi. </b></p>
+<p>LoadModule fcgid_module modules/mod_fcgid.so</p>
+<p><Location /fcgid><br>
+ SetHandler fcgid-script<br>
+ Options ExecCGI<br>
+ allow from all<br>
+</Location></p>
+<p>
+</p>
+<hr>
+<p><b><a name="suEXEC"></a>This is for suEXEC. Please get more
+information about suEXEC <a
+ href="http://httpd.apache.org/docs-2.0/suexec.html">here</a>. </b></p>
+<p>LoadModule fcgid_module modules/mod_fcgid.so</p>
+<p><Location /fcgid><br>
+ SetHandler fcgid-script<br>
+ Options ExecCGI<br>
+ allow from all<br>
+</Location></p>
+<p><VirtualHost 192.168.1.89><br>
+ ServerAdmin <a href="mailto:webmaster at host.foo.com">webmaster at host.foo.com<br>
+</a> DocumentRoot /usr/local/apache2/htdocs/<br>
+ ServerName host.foo.com<br>
+ SuexecUserGroup pqf pqf<br>
+</VirtualHost></p>
+<p>¡¡
+</p>
+<hr>
+<p><b><a name="PHP"></a>This is for fastcgi-mode PHP (UNIX)</b></p>
+<p>LoadModule fcgid_module modules/mod_fcgid.so</p>
+<p> <Directory /usr/local/apache2/htdocs/php><br>
+ SetHandler fcgid-script<br>
+ FCGIWrapper /usr/local/bin/php .php
+</p>
+<p> <span style="font-weight: bold;"># You need mod_fcgid
+version >= 2.1 to support arguments in FCGIWrapper, if you want<br>
+ # FCGIWrapper "/usr/local/bin/php -c /etc/" .php</span></p>
+ Options ExecCGI<br>
+<p> allow from all<br>
+</Directory></p>
+<p><b>This works too:</b></p>
+<p>LoadModule fcgid_module modules/mod_fcgid.so </p>
+<p>AddHandler fcgid-script .php<br>
+<Directory /usr/local/apache2/htdocs/php><br>
+ FCGIWrapper /usr/local/bin/php .php</p>
+<p> <span style="font-weight: bold;">#</span> <span
+ style="font-weight: bold;">You need mod_fcgid version >= 2.1 to
+support arguments in FCGIWrapper, if you want<br>
+ # FCGIWrapper "/usr/local/bin/php -c /etc/" .php</span></p>
+<p> Options ExecCGI<br>
+ allow from all<br>
+</Directory></p>
+<p><b># Please make sure:<br>
+# php is configured with --enable-fastcgi option<br>
+# check error_log(with debug level), if any thing goes wrong</b> </p>
+<p> </p>
+<hr>
+<p><b><a name="Ruby"></a>This is for fastcgi-mode </b><span
+ style="font-weight: bold;">Ruby on Rails ( Thank Andre Nathan giving
+me this demo configuration )<br>
+</span><br>
+LoadModule fcgid_module modules/mod_fcgid.so<br>
+SocketPath /tmp/fcgidsock<br>
+SharememPath /tmp/fcgidshm<br>
+DefaultInitEnv RAILS_ENV production<br>
<br>
-
+<Directory /home/sneakymustard/tumble/public><br>
+ Options ExecCGI FollowSymLinks<br>
+ AllowOverride AuthConfig Indexes Limit<br>
+ Order allow,deny<br>
+ Allow from all<br>
+<br>
+ AddHandler fcgid-script .fcgi</p>
+<p><span style="font-weight: bold;"> # You need
+mod_fcgid version >= 2.1 to support arguments "xxx/dispatch.fcgi" in
+FCGIWrapper <br>
+</span> FCGIWrapper "/usr/bin/ruby
+/home/sneakymustard/tumble/public/dispatch.fcgi" .fcgi<br>
+<br>
+ RewriteEngine On<br>
+ RewriteRule ^$ index.html [QSA]<br>
+ RewriteRule ^([^.]+)$ $1.html [QSA]<br>
+ RewriteCond %{REQUEST_FILENAME} !-f<br>
+ RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]<br>
+</Directory><br>
+<br>
+</p>
+<span style="font-weight: bold;"></span>
+<p> </p>
+<hr>
+<p><b><a name="suPHP"></a>This is for suPHP ( UNIX )</b> </p>
+<p>LoadModule fcgid_module modules/mod_fcgid.so<br>
+<br>
+<VirtualHost *:80><br>
+ ServerName test2.example.com<br>
+ DocumentRoot
+/usr/local/apache2/htdocs/test2.example.com/<br>
+ SuexecUserGroup pqf pqf<br>
+</VirtualHost><br>
+<br>
+<Directory /usr/local/apache2/htdocs/test2.example.com/><br>
+ AddHandler fcgid-script .php<br>
+ Options ExecCGI<br>
+ allow from all<br>
+ FCGIWrapper
+/usr/local/apache2/htdocs/test2.example.com/php .php</p>
+<p></p>
+<p> <span style="font-weight: bold;">#</span> <span
+ style="font-weight: bold;">You need mod_fcgid version >= 2.1 to
+support arguments in FCGIWrapper, if you want<br>
+ # FCGIWrapper "/usr/local/bin/php -c /etc/" .php</span></p>
+<p> </Directory></p>
+<p> <b> # Please make sure:<br>
+# php is configured with --enable-fastcgi option<br>
+# copy php execution to /usr/local/apache2/htdocs/test2.example.com/
+directory<br>
+# make sure all files in /usr/local/apache2/htdocs/test2.example.com/
+with right owner and group<br>
+# check error_log(with debug level) and suexec_log, if any thing goes
+wrong</b> <br>
+</p>
<hr>
<p><br>
-<b><a name="PHP-Windows"></a>This is for fastcgi-mode PHP ( Windows )</b><p>LoadModule fcgid_module modules/mod_fcgid.so<p>
-<Directory "C:/Apache2/htdocs/php/"><br>
- SetHandler fcgid-script<br>
- Options execCGI<br>
- AllowOverride None<br>
- Order allow,deny<br>
- Allow from all<br>
- FCGIWrapper "c:/php/php.exe" .php<br>
-</Directory><p><b>This works too:</b><p>LoadModule fcgid_module modules/mod_fcgid.so <p>
-AddHandler fcgid-script .php<br>
-<Directory "C:/Apache2/htdocs/php/"><br>
- FCGIWrapper "c:/php/php.exe" .php<br>
- Options ExecCGI<br>
- allow from all<br>
+<b><a name="PHP-Windows"></a>This is for fastcgi-mode PHP ( Windows )</b>
+</p>
+<p>LoadModule fcgid_module modules/mod_fcgid.so<br>
+DefaultInitEnv PHPRC "c:/php/"<br>
+DefaultInitEnv PATH
+"c:/php;C:/WINDOWS/system32;C:/WINDOWS;C:/WINDOWS/System32/Wbem;"<br>
+DefaultInitEnv SystemRoot "C:/Windows"<br>
+DefaultInitEnv SystemDrive "C:"<br>
+DefaultInitEnv TEMP "C:/WINDOWS/TEMP"<br>
+DefaultInitEnv TMP "C:/WINDOWS/TEMP"<br>
+DefaultInitEnv windir "C:/WINDOWS"<br>
+<Directory "C:/Apache2/htdocs/php/"><br>
+ SetHandler fcgid-script<br>
+ Options execCGI<br>
+ AllowOverride None<br>
+ Order allow,deny<br>
+ Allow from all<br>
+ FCGIWrapper "c:/php/php.exe" .php</p>
+<p> <span style="font-weight: bold;">#</span> <span
+ style="font-weight: bold;">You need mod_fcgid version >= 2.1 to
+support arguments in FCGIWrapper, if you want<br>
+ # FCGIWrapper "/usr/local/bin/php -c /etc/" .php</span><br>
+</Directory></p>
+<p><b>This works too:</b>
+</p>
+<p>LoadModule fcgid_module modules/mod_fcgid.so<br>
+DefaultInitEnv PHPRC "c:/php/"<br>
+DefaultInitEnv PATH
+"c:/php;C:/WINDOWS/system32;C:/WINDOWS;C:/WINDOWS/System32/Wbem;"<br>
+DefaultInitEnv SystemRoot "C:/Windows"<br>
+DefaultInitEnv SystemDrive "C:"<br>
+DefaultInitEnv TEMP "C:/WINDOWS/TEMP"<br>
+DefaultInitEnv TMP "C:/WINDOWS/TEMP"<br>
+DefaultInitEnv windir "C:/WINDOWS"<br>
+AddHandler fcgid-script .php<br>
+<Directory "C:/Apache2/htdocs/php/"><br>
+ FCGIWrapper "c:/php/php.exe" .php</p>
+<p> <span style="font-weight: bold;">#</span> <span
+ style="font-weight: bold;">You need mod_fcgid version >= 2.1 to
+support arguments in FCGIWrapper, if you want<br>
+ # FCGIWrapper "/usr/local/bin/php -c /etc/" .php<br>
+</span></p>
+<p><span style="font-weight: bold;"></span>
+Options ExecCGI<br>
+ allow from all<br>
</Directory><br>
-
+</p>
<hr>
-<p><b><a name="Authenticator"></a>This is for Authenticator</b></p>
+<p><b><a name="Authenticator"></a>This is for Authenticator</b></p>
<p>LoadModule fcgid_module modules/mod_fcgid.so
-<p><Location /fcgid><br>
- SetHandler fcgid-script<br>
- Options ExecCGI<br>
- allow from all<br>
- AuthType Basic<br>
- AuthName ProtectedRealm<br>
- FastCgiAuthenticator /some/path/authenticator<br>
- require valid-user<br>
-</Location><br>
</p>
-<p><b>Another configuration: <a name="FastCgiAuthenticatorAuthoritative">FastCgiAuthenticatorAuthoritative</a>
+<p><Location /fcgid><br>
+SetHandler fcgid-script<br>
+Options ExecCGI<br>
+allow from all<br>
+AuthType Basic<br>
+AuthName ProtectedRealm<br>
+FastCgiAuthenticator /some/path/authenticator<br>
+require valid-user<br>
+</Location><br>
+</p>
+<p><b>Another configuration: <a
+ name="FastCgiAuthenticatorAuthoritative">FastCgiAuthenticatorAuthoritative</a>
(default On)</b></p>
-<p>Setting the <code>FastCgiAuthenticatorAuthoritative</code> directive
-explicitly to <em>Off</em> allows authentication to be passed on to lower level
-modules</p>
-
+<p>Setting the <code>FastCgiAuthenticatorAuthoritative</code>
+directive explicitly to <em>Off</em> allows authentication to be
+passed on to lower level modules</p>
<hr>
-<p><b><a name="Authorizer"></a>This is for Authorizer</b></p>
-
+<p><b><a name="Authorizer"></a>This is for Authorizer</b></p>
<p>LoadModule fcgid_module modules/mod_fcgid.so
-<p><Location /fcgid><br>
- SetHandler fcgid-script<br>
- Options ExecCGI<br>
- allow from all<br>
- AuthType Basic<br>
- AuthName ProtectedRealm<br>
- FastCgiAuthorizer /some/place/Authorizer<br>
-</Location></p>
-
-<p><b>Another configuration: <a name="FastCgiAuthorizerAuthoritative">FastCgiAuthorizerAuthoritative</a>
+</p>
+<p><Location /fcgid><br>
+SetHandler fcgid-script<br>
+Options ExecCGI<br>
+allow from all<br>
+AuthType Basic<br>
+AuthName ProtectedRealm<br>
+FastCgiAuthorizer /some/place/Authorizer<br>
+</Location></p>
+<p><b>Another configuration: <a name="FastCgiAuthorizerAuthoritative">FastCgiAuthorizerAuthoritative</a>
(default On)</b></p>
-
-<p>Setting the <code>FastCgiAuthorizerAuthoritative</code> directive explicitly
-to <em>Off</em> allows authorization to be passed on to lower level modules</p>
-
+<p>Setting the <code>FastCgiAuthorizerAuthoritative</code> directive
+explicitly to <em>Off</em> allows authorization to be passed on to
+lower level modules</p>
<hr>
-<p><b><a name="AccessChecker"></a>This is for AccessChecker</b></p>
+<p><b><a name="AccessChecker"></a>This is for AccessChecker</b></p>
<p>LoadModule fcgid_module modules/mod_fcgid.so
-<p><Location /fcgid><br>
- SetHandler fcgid-script<br>
- Options ExecCGI<br>
- allow from all<br>
- FastCgiAccessChecker /some/place/access-checker<br>
-</Location><br>
</p>
-<p><b>Another configuration: </b><a name="FastCgiAccessCheckerAuthoritative"><b>FastCgiAccessCheckerAuthoritative</b></a><b>
+<p><Location /fcgid><br>
+SetHandler fcgid-script<br>
+Options ExecCGI<br>
+allow from all<br>
+FastCgiAccessChecker /some/place/access-checker<br>
+</Location><br>
+</p>
+<p><b>Another configuration: </b><a
+ name="FastCgiAccessCheckerAuthoritative"><b>FastCgiAccessCheckerAuthoritative</b></a><b>
(default On)</b></p>
-<p>Setting the <code>FastCgiAccessCheckerAuthoritative</code> directive
-explicitly to <em>Off</em> allows access checking to be passed on to lower level
-modules</p>
+<p>Setting the <code>FastCgiAccessCheckerAuthoritative</code>
+directive explicitly to <em>Off</em> allows access checking to be
+passed on to lower level modules</p>
<p>¡¡</p>
<p>¡¡</p>
-
<p>¡¡</p>
<p>¡¡</p>
<p>¡¡</p>
@@ -171,7 +253,5 @@
<p>¡¡</p>
<p>¡¡</p>
<p>¡¡</p>
-
</body>
-
</html>
Index: doc.htm
===================================================================
RCS file: /cvs/extras/rpms/mod_fcgid/devel/doc.htm,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- doc.htm 31 Oct 2006 18:37:08 -0000 1.2
+++ doc.htm 16 Feb 2007 14:20:03 -0000 1.3
@@ -1,113 +1,210 @@
-<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
- "http://www.w3.org/TR/html4/loose.dtd">
-
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
-
<head>
-
-<title>The mod_fcgid Home Page</title>
-
-<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
-
+ <title>The mod_fcgid Home Page</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
-
<body bgcolor="#ffffff">
-
<table border="0" cellpadding="5" cellspacing="0" width="893">
-
-<tr>
-
-<td align="center" valign="top" width="200">
-
-
-
-<table cellpadding="5" cellspacing="0">
-
-<tr>
-
-<td nowrap bgcolor="#f8eda6" align="left">
-
-<a href="index.htm">Home</a> <br>
-<a href="index.cn.htm">Chinese Info</a> <br>
-<a href="download.htm">Download (source)</a> <br>
-<a href="doc.htm">Documentations</a> <br>
-
-
-<a href="feedback.htm">Feedback</a>
-
-
-</td> </tr> </table> </td>
-
-<td valign="top" width="669">
-
-<ul>
- <li>
-
-<p><b><font size="4">Here are some examples of configuration</font></b></p>
- </li>
-</ul>
-
-<p><a href="configuration.htm#regular fastcgi">Configuration for Regular fastcgi
-(non-PHP, non-Ruby, non-Python) </a><p><a href="configuration.htm#suEXEC">Configuration
-for suEXEC fastcgi</a><p><a href="configuration.htm#PHP">Configuration for PHP
-(UNIX)</a><p><a href="configuration.htm#suPHP">Configuration for suPHP (UNIX)</a><p><a href="configuration.htm#PHP-Windows">Configuration
-for PHP (Windows)</a><p><a href="configuration.htm#Authenticator">Configuration
-for Authenticator</a><p><a href="configuration.htm#Authorizer">Configuration
-for Authorizer</a><p><a href="configuration.htm#AccessChecker">Configuration
-for AccessChecker</a><p>
-<hr>
-<ul>
- <li><h2><b><font size="4">There are
+ <tbody>
+ <tr>
+ <td align="center" valign="top" width="200">
+ <table cellpadding="5" cellspacing="0">
+ <tbody>
+ <tr>
+ <td align="left" bgcolor="#f8eda6" nowrap="nowrap"> <a
+ href="index.htm">Home</a> <br>
+ <a href="index.cn.htm">Chinese Info</a> <br>
+ <a href="download.htm">Download (source)</a> <br>
+ <a href="doc.htm">Documentations</a> <br>
+ <a href="feedback.htm">Feedback</a> <br>
+ <a
+ href="http://sourceforge.net/donate/index.php?group_id=174879"><img
+ src="http://images.sourceforge.net/images/project-support.jpg"
+ alt="Support This Project" border="0" height="32" width="88"> </a> </td>
+ </tr>
+ </tbody>
+ </table>
+ </td>
+ <td valign="top" width="669">
+ <ul>
+ <li>
+ <p><b><font size="4">Here are some examples of configuration</font></b></p>
+ </li>
+ </ul>
+ <p><a href="configuration.htm#regular%20fastcgi">Configuration
+for Regular fastcgi
+(non-PHP, non-Ruby, non-Python) </a></p>
+ <p><a href="configuration.htm#suEXEC">Configuration
+for suEXEC fastcgi</a></p>
+ <p><a href="configuration.htm#PHP">Configuration for PHP
+(UNIX)</a><br>
+ </p>
+ <p><a href="configuration.htm#Ruby">Configuration for Ruby on
+Rails</a><br>
+ </p>
+ <p><a href="configuration.htm#suPHP">Configuration for suPHP
+(UNIX)</a></p>
+ <p><a href="configuration.htm#PHP-Windows">Configuration
+for PHP (Windows)</a></p>
+ <p><a href="configuration.htm#Authenticator">Configuration
+for Authenticator</a></p>
+ <p><a href="configuration.htm#Authorizer">Configuration
+for Authorizer</a></p>
+ <p><a href="configuration.htm#AccessChecker">Configuration
+for AccessChecker</a></p>
+ <p> </p>
+ <hr>
+ <ul>
+ <li>
+ <h2><a class="mozTocH2" name="mozTocId601839"></a><b><font
+ size="4">There are
some other configurations you can set</font></b></h2>
- </li>
-</ul>
-<p><b>IdleTimeout n (300
-seconds)</b><p>An idle fastcgi application will be terminated after IdleTimeout
-seconds. <p><b>IdleScanInterval n (120 seconds)</b><p>The scan interval for idle
-fastcgi applications. <p><b>BusyTimeout n (300 seconds)</b><p>a fastcgi
-application will be terminated if handing a single request longer than busy
-timeout.<p><b>BusyScanInterval n (120 seconds)</b><p>The scan interval for busy
-timeout fastcgi applications.<p><b>ErrorScanInterval n (3 seconds)</b><p>The
-scan interval for exit pending fastcgi applications. fastcgi applications will
-be terminated within this scanning.<p><b>ZombieScanInterval n (3 seconds)</b><p>The
-scan interval for zombie process. <p><b>ProcessLifeTime n (3600 seconds)</b><p>A
-fastcgi application will be terminated if lifetime expired, even no error is
-detected.<p><b>SocketPath path (logs/fcgidsock)</b><p>The directory to put the
-UNIX domain socket. (UNIX only)<p><b>SpawnScoreUpLimit n (10)</b><p>The
-spawn-speed control score up water limit. Score increases while a process is spawned or terminated, and decreases
-as time progresses; while the score is higher than <b>SpawnScoreUpLimit</b>, the spawning will be
-held for a while. The higher this number is, the higher speed of the spawning
-can be.<p><b>SpawnScore n (1)</b><p>The weight of spawning. This weight
-will be plused to the spawn-control score on every spawn. The higher this number
-is, the lower speed of spawning can be.<p><b>TerminationScore n (2)</b><p>The
-weight of termination. This weight will be plused to the score while fastcgi
-process terminates. The higher this number is, the lower speed of spawning can
-be.<p><b>MaxProcessCount n (1000)</b><p>The max count of total fastcgi process
-count.<p><b>DefaultMaxClassProcessCount n (100)</b><p>The maximum number of
-fastcgi application instances allowed to run for any one fastcgi application. <p><b>DefaultMinClassProcessCount n
-(3)</b><p>The minimum number of
-fastcgi application instances for any one fastcgi application. <p><b>DefaultInitEnv
-env_name env_value</b><p>The default environment variables before a fastcgi
+ </li>
+ </ul>
+ <p><b>IdleTimeout n (300
+seconds)</b></p>
+ <p>An idle fastcgi application will be terminated after
+IdleTimeout
+seconds. </p>
+ <p><b>IdleScanInterval n (120 seconds)</b></p>
+ <p>The scan interval for idle
+fastcgi applications. </p>
+ <p><b>BusyTimeout n (300 seconds)</b></p>
+ <p>a fastcgi
+application will be terminated if handing a single request longer than
+busy
+timeout.</p>
+ <p><b>BusyScanInterval n (120 seconds)</b></p>
+ <p>The scan interval for busy
+timeout fastcgi applications.</p>
+ <p><b>ErrorScanInterval n (3 seconds)</b></p>
+ <p>The
+scan interval for exit pending fastcgi applications. fastcgi
+applications will
+be terminated within this scanning.</p>
+ <p><b>ZombieScanInterval n (3 seconds)</b></p>
+ <p>The
+scan interval for zombie process. </p>
+ <p><b>ProcessLifeTime n (3600 seconds)</b></p>
+ <p>A
+fastcgi application will be terminated if lifetime expired, even no
+error is
+detected.</p>
+ <p><b>SocketPath path (logs/fcgidsock)</b></p>
+ <p>The directory to put the
+UNIX domain socket. (UNIX only)<br>
+ </p>
+ <p><span style="font-weight: bold;">SharememPath path
+(logs/fcgid_shm)</span><br>
+ </p>
+ <p>The share memory file path. (UNIX only) (version >= 2.1
+only)<br>
+ </p>
+ <p><b>SpawnScoreUpLimit n (10)</b></p>
+ <p>The
+spawn-speed control score up water limit. Score increases while a
+process is spawned or terminated, and decreases
+as time progresses; while the score is higher than <b>SpawnScoreUpLimit</b>,
+the spawning will be
+held for a while. The higher this number is, the higher speed of the
+spawning
+can be.</p>
+ <p><b>SpawnScore n (1)</b></p>
+ <p>The weight of spawning. This weight
+will be plused to the spawn-control score on every spawn. The higher
+this number
+is, the lower speed of spawning can be.</p>
+ <p><b>TerminationScore n (2)</b></p>
+ <p>The
+weight of termination. This weight will be plused to the score while
+fastcgi
+process terminates. The higher this number is, the lower speed of
+spawning can
+be.</p>
+ <p><b>MaxProcessCount n (1000)</b></p>
+ <p>The max count of total fastcgi process
+count.</p>
+ <p><b>DefaultMaxClassProcessCount n (100)</b></p>
+ <p>The maximum number of
+fastcgi application instances allowed to run for any one fastcgi
+application. </p>
+ <p><b>DefaultMinClassProcessCount n
+(3)</b></p>
+ <p>The minimum number of
+fastcgi application instances for any one fastcgi application. </p>
+ <p><b>DefaultInitEnv
+env_name env_value</b></p>
+ <p>The default environment variables before a fastcgi
application is spawned. You can set this configuration more
-than once.<p><b>IPCConnectTimeout n (3 seconds)</b><p>The connect timeout to a
-fastcgi application. <p><b>IPCCommTimeout n (20 seconds)</b><p>The communication
-timeout to a fastcgi application. Please increase this value if your CGI have a
-slow initialization or slow respond.<p><b>OutputBufferSize n (64k bytes)</b><p>CGI
-output cache buffer size.<p><b>PHP_Fix_Pathinfo_Enable</b><b> n(n=0/1, default 0)</b><p>If
+than once.<br>
+ </p>
+ <table style="text-align: left; width: 667px; height: 147px;"
+ border="1" cellpadding="2" cellspacing="2">
+ <tbody>
+ <tr>
+ <td style="vertical-align: top;">Note: If you get:<br>
+ <div><span style="font-weight: bold;">Can't create TCP/IP
+socket (10106)</span> error while running PHP script(<span
+ style="font-weight: bold;">on Win32 only</span>), you will have to set
+these(<span style="font-weight: bold;">Please modify the values if
+necessary</span>):<br>
+ <font face="Arial" size="2">DefaultInitEnv PHPRC "c:/php/"<br>
+DefaultInitEnv PATH
+"c:/php;C:/WINDOWS/system32;C:/WINDOWS;C:/WINDOWS/System32/Wbem;"<br>
+DefaultInitEnv SystemRoot "C:/Windows"<br>
+DefaultInitEnv SystemDrive "C:"<br>
+DefaultInitEnv TEMP "C:/WINDOWS/TEMP"<br>
+DefaultInitEnv TMP "C:/WINDOWS/TEMP"<br>
+DefaultInitEnv windir "C:/WINDOWS"<br>
+ <br>
+(Thank Steffen of apachelounge.com for this note)<br>
+ </font></div>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ <p><br>
+ </p>
+ <p><b>IPCConnectTimeout n (3 seconds)</b></p>
+ <p>The connect timeout to a
+fastcgi application. </p>
+ <p><b>IPCCommTimeout n (20 seconds)</b></p>
+ <p>The communication
+timeout to a fastcgi application. Please increase this value if your
+CGI have a
+slow initialization or slow respond.</p>
+ <p><b>OutputBufferSize n (64k bytes)</b></p>
+ <p>CGI
+output cache buffer size.</p>
+ <p><b>PHP_Fix_Pathinfo_Enable</b><b> n(n=0/1, default 0)</b></p>
+ <p>If
you are using PHP and set cgi.fix_pathinfo=1 in php.ini, set
-PHP_Fix_Pathinfo_Enable 1.<p><b>MaxRequestsPerProcess n (-1)</b><p>(Added in
-version 1.11, patch from Robert L Mathews)<p>Adds a MaxRequestsPerProcess parameter that allows mod_fcgid to
-exit after handling a certain number of requests, similar to the existing ProcessLifeTime option. <p>This solves a problem with PHP in FastCGI mode. By default, PHP stops
-accepting new FastCGI connections after handling 500 requests; unfortunately, there is a potential race condition during the PHP cleanup code in which
-PHP can be shutting down but still have the socket open, so mod_fcgid under heavy load can send request number 501 to PHP and have it "accepted", but then
-PHP appears to simply exit, causing errors.<p>If you are using PHP, you should
-set it to 500. -1 mean fastcgi process will not exit no matter how many requests
+PHP_Fix_Pathinfo_Enable 1.</p>
+ <p><b>MaxRequestsPerProcess n (-1)</b></p>
+ <p>(Added in
+version 1.11, patch from Robert L Mathews)</p>
+ <p>Adds a MaxRequestsPerProcess parameter that allows mod_fcgid
+to
+exit after handling a certain number of requests, similar to the
+existing ProcessLifeTime option. </p>
+ <p>This solves a problem with PHP in FastCGI mode. By default,
+PHP stops
+accepting new FastCGI connections after handling 500 requests;
+unfortunately, there is a potential race condition during the PHP
+cleanup code in which
+PHP can be shutting down but still have the socket open, so mod_fcgid
+under heavy load can send request number 501 to PHP and have it
+"accepted", but then
+PHP appears to simply exit, causing errors.</p>
+ <p>If you are using PHP, you should
+set it to 500. -1 mean fastcgi process will not exit no matter how many
+requests
it has handled.<br>
-
-</td>
-
-</tr>
-
+ </p>
+ </td>
+ </tr>
+ </tbody>
</table>
-
-</body></html>
+</body>
+</html>
Index: fcgid.conf
===================================================================
RCS file: /cvs/extras/rpms/mod_fcgid/devel/fcgid.conf,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- fcgid.conf 6 Sep 2006 13:08:59 -0000 1.1
+++ fcgid.conf 16 Feb 2007 14:20:03 -0000 1.2
@@ -11,5 +11,6 @@
AddHandler fcgid-script fcg fcgi fpl
</IfModule>
-# Sane place to put sockets
+# Sane place to put sockets and shared memory file
SocketPath run/mod_fcgid
+SharememPath run/fcgid_shm
Index: mod_fcgid.spec
===================================================================
RCS file: /cvs/extras/rpms/mod_fcgid/devel/mod_fcgid.spec,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- mod_fcgid.spec 31 Oct 2006 18:37:08 -0000 1.3
+++ mod_fcgid.spec 16 Feb 2007 14:20:03 -0000 1.4
@@ -10,7 +10,7 @@
%endif
Name: mod_fcgid
-Version: 2.0
+Version: 2.1
Release: 1%{?dist}
Summary: Apache2 module for high-performance server-side scripting
Group: System Environment/Daemons
@@ -20,11 +20,11 @@
Source1: fcgid.conf
Source2: fastcgi.te
Source3: fastcgi.fc
-Source4: README.Fedora
+Source4: mod_fcgid-2.1-README.Fedora
Source5: http://fastcgi.coremail.cn/doc.htm
Source6: http://fastcgi.coremail.cn/configuration.htm
-Source7: README.SELinux
-Patch0: mod_fcgid.1.09-docurls.patch
+Source7: mod_fcgid-2.1-README.SELinux
+Patch0: mod_fcgid.2.1-docurls.patch
BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n)
BuildRequires: httpd-devel >= 2.0
Requires: httpd-mmn = %([ -a %{_includedir}/httpd/.mmn ] && %{__cat} %{_includedir}/httpd/.mmn || echo missing)
@@ -38,9 +38,9 @@
%if %{selinux_module}
%define selinux_policyver %(sed -e 's,.*selinux-policy-\\([^/]*\\)/.*,\\1,' /usr/share/selinux/devel/policyhelp)
%package selinux
-Summary: SELinux policy module supporting FastCGI applications with mod_fcgid
-Group: System Environment/Base
-BuildRequires: %{selinux_buildreqs}
+Summary: SELinux policy module supporting FastCGI applications with mod_fcgid
+Group: System Environment/Base
+BuildRequires: %{selinux_buildreqs}
# selinux-policy is required for directory ownership of %{_datadir}/selinux/*
# Modules built against one version of a policy may not work with older policy
# versions, as noted on fedora-selinux-list:
@@ -48,9 +48,9 @@
# Hence the versioned dependency. The versioning will hopefully be replaced by
# an ABI version requirement or something similar in the future
%if "%{selinux_policyver}" != ""
-Requires: selinux-policy >= %{selinux_policyver}
+Requires: selinux-policy >= %{selinux_policyver}
%endif
-Requires: %{name} = %{version}-%{release}
+Requires: %{name} = %{version}-%{release}
Requires(post): /usr/sbin/semodule, /sbin/restorecon
Requires(postun): /usr/sbin/semodule, /sbin/restorecon
@@ -60,8 +60,13 @@
%prep
%setup -q -n mod_fcgid.%{version}
-%{__cp} -p %{SOURCE2} %{SOURCE3} %{SOURCE4} %{SOURCE6} %{SOURCE7} .
+%{__cp} -p %{SOURCE1} fcgid.conf
+%{__cp} -p %{SOURCE2} fastcgi.te
+%{__cp} -p %{SOURCE3} fastcgi.fc
+%{__cp} -p %{SOURCE4} README.Fedora
%{__cp} -p %{SOURCE5} directives.htm
+%{__cp} -p %{SOURCE6} configuration.htm
+%{__cp} -p %{SOURCE7} README.SELinux
%patch0 -p1
%{__sed} -i -e 's/\r$//' directives.htm configuration.htm
@@ -71,9 +76,9 @@
%if %{selinux_module}
for selinuxvariant in %{selinux_variants}
do
- %{__make} NAME=${selinuxvariant} -f /usr/share/selinux/devel/Makefile
- %{__mv} fastcgi.pp fastcgi.pp.${selinuxvariant}
- %{__make} NAME=${selinuxvariant} -f /usr/share/selinux/devel/Makefile clean
+ %{__make} NAME=${selinuxvariant} -f /usr/share/selinux/devel/Makefile
+ %{__mv} fastcgi.pp fastcgi.pp.${selinuxvariant}
+ %{__make} NAME=${selinuxvariant} -f /usr/share/selinux/devel/Makefile clean
done
%endif
@@ -81,20 +86,20 @@
%{__rm} -rf %{buildroot}
topdir=$(/usr/bin/dirname $(/usr/sbin/apxs -q exp_installbuilddir))
%{__make} \
- top_dir=${topdir} \
- DESTDIR=%{buildroot} \
- MKINSTALLDIRS="%{__mkdir_p}" \
- install
-%{__install} -D -m 644 %{SOURCE1} %{buildroot}%{_sysconfdir}/httpd/conf.d/fcgid.conf
+ top_dir=${topdir} \
+ DESTDIR=%{buildroot} \
+ MKINSTALLDIRS="%{__mkdir_p}" \
+ install
+%{__install} -D -m 644 fcgid.conf %{buildroot}%{_sysconfdir}/httpd/conf.d/fcgid.conf
%{__install} -d -m 755 %{buildroot}%{_localstatedir}/run/mod_fcgid
# Install SELinux policy modules
%if %{selinux_module}
for selinuxvariant in %{selinux_variants}
do
- %{__install} -d %{buildroot}%{_datadir}/selinux/${selinuxvariant}
- %{__install} -p -m 644 fastcgi.pp.${selinuxvariant} \
- %{buildroot}%{_datadir}/selinux/${selinuxvariant}/fastcgi.pp
+ %{__install} -d %{buildroot}%{_datadir}/selinux/${selinuxvariant}
+ %{__install} -p -m 644 fastcgi.pp.${selinuxvariant} \
+ %{buildroot}%{_datadir}/selinux/${selinuxvariant}/fastcgi.pp
done
# Hardlink identical policy module packages together
/usr/sbin/hardlink -cv %{buildroot}%{_datadir}/selinux
@@ -129,7 +134,7 @@
%endif
%files
-%defattr(-,root,root,0755)
+%defattr(-,root,root,-)
%doc ChangeLog AUTHOR COPYING configuration.htm directives.htm
%doc README.Fedora
%{_libdir}/httpd/modules/mod_fcgid.so
@@ -138,12 +143,19 @@
%if %{selinux_module}
%files selinux
-%defattr(-,root,root,0755)
+%defattr(-,root,root,-)
%doc fastcgi.fc fastcgi.te README.SELinux
%{_datadir}/selinux/*/fastcgi.pp
%endif
%changelog
+* Fri Feb 16 2007 Paul Howarth <paul at city-fan.org> 2.1-1
+- Update to 2.1
+- Update documentation and patches
+- Rename some source files to reduce chances of conflicting names
+- Include SharememPath directive in conf file to avoid unfortunate upstream
+ default location
+
* Mon Oct 30 2006 Paul Howarth <paul at city-fan.org> 2.0-1
- Update to 2.0
- Source is now hosted at sourceforge.net
Index: sources
===================================================================
RCS file: /cvs/extras/rpms/mod_fcgid/devel/sources,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- sources 31 Oct 2006 18:37:08 -0000 1.3
+++ sources 16 Feb 2007 14:20:03 -0000 1.4
@@ -1 +1 @@
-3aa51f1e293e6d881028295a23021dae mod_fcgid.2.0.tar.gz
+68a6479e398a20577334f16a8b06c418 mod_fcgid.2.1.tar.gz
--- README.Fedora DELETED ---
--- README.SELinux DELETED ---
--- mod_fcgid.1.09-docurls.patch DELETED ---
More information about the scm-commits
mailing list