merge in Ken's recent FAQ changes from HEAD (82f92da0) · Commits · CYBER - Cyber Security / TS 103 523 MSP / TLMSP / TLMSP Apache Httpd

docs/manual/misc/FAQ.html

+100 −54

Original line number	Diff line number	Diff line
		@@ -15,7 +15,7 @@
		<!--#include virtual="header.html" -->
		<H1 ALIGN="CENTER">Apache Server Frequently Asked Questions</H1>
		<P>
		$Revision: 1.63.2.12 $ ($Date: 1997/07/27 17:19:01 $)
		$Revision: 1.63.2.13 $ ($Date: 1997/07/31 08:57:21 $)
		</P>
		<P>
		The latest version of this FAQ is always available from the main
		@@ -237,7 +237,7 @@
		<LI><A HREF="#rewrite-dontwork">What can I do if my RewriteRules don't work
		as expected?</A>
		</LI>
		<LI><A HREF="#rewrite-prefixdocroot">Why are some of my URLs don't get
		<LI><A HREF="#rewrite-prefixdocroot">Why don't some of my URLs get
		prefixed with DocumentRoot when using mod_rewrite?</A>
		</LI>
		<LI><A HREF="#rewrite-nocase">How can I make all my URLs case-insensitive
		@@ -249,6 +249,9 @@
		<LI><A HREF="#rewrite-envwhitespace">How can I use strings with whitespaces
		in RewriteRule's ENV flag?</A>
		</LI>
		<LI><A HREF="#cgi-spec">Where can I find the "CGI
		specification"?</A>
		</LI>
		</OL>
		</LI>
		</UL>
		@@ -577,6 +580,7 @@
		><SAMP>AddHandler</SAMP></A>
		directive.
		</P>
		<P>
		<OL>
		<LI>In an appropriate section of your server configuration files, add
		a line such as
		@@ -597,10 +601,10 @@
		HREF="../mod/core.html#options"
		><SAMP>Options</SAMP></A>
		declaration that includes the <SAMP>ExecCGI</SAMP> option.
		<P>
		</P>
		</LI>
		</OL>
		</P>
		<P>
		In some situations it can be not conform to your local policy to actually
		allow all files named "<SAMP>*.cgi</SAMP>" to be executable.
		Perhaps all you want is to enable a particular file in a normal directory to
		@@ -611,16 +615,18 @@
		><SAMP>mod_rewrite</SAMP></A>
		and the following steps:
		</P>
		<P>
		<OL>
		<LI>Locally add to the corresponding <SAMP>.htaccess</SAMP> file a ruleset
		similar to this one:
		<P>
		<DL>
		<DD><CODE>
		RewriteEngine on<br>
		RewriteBase /~foo/bar/<br>
		RewriteRule ^quux\.cgi$ - [T=application/x-httpd-cgi]<br>
		</CODE></DD>
		<DD><CODE>RewriteEngine on
		<BR>
		RewriteBase /~foo/bar/
		<BR>
		RewriteRule ^quux\.cgi$ - [T=application/x-httpd-cgi]</CODE>
		</DD>
		</DL>
		</P>
		</LI>
		@@ -630,10 +636,9 @@
		><SAMP>Options</SAMP></A>
		declaration that includes the <SAMP>ExecCGI</SAMP> and
		<SAMP>FollowSymLinks</SAMP> option.
		<P>
		</P>
		</LI>
		</OL>
		</P>
		<HR>
		</LI>
		<LI><A NAME="premature-script-headers">
		@@ -912,7 +917,7 @@
		HREF="perf.html"
		>performance hints</A>
		page. There is a specific note for
		<a href="#freebsd-setsize">FreeBSD</a> below.
		<A HREF="#freebsd-setsize">FreeBSD</A> below.
		</LI>
		<LI>"Don't do that" - try to run with fewer virtual hosts
		</LI>
		@@ -926,10 +931,11 @@
		<P>
		Since this is an operating-system limitation, there's not much else
		available in the way of solutions.
		</P>
		<P>
		As of 1.2.1 we have made attempts to work around various limitations
		involving running with many descriptors.
		<a href="descriptors.html">More information is available.</a>
		<A HREF="descriptors.html">More information is available.</A>
		</P>
		<HR>
		</LI>
		@@ -938,16 +944,32 @@
		<STRONG>Can I increase <SAMP>FD_SETSIZE</SAMP> on FreeBSD?</STRONG>
		</A>
		<P>
		On FreeBSD 2.2 and older <SAMP>FD_SETSIZE</SAMP>, which limits the
		number of open
		files on the system, is limited to 256. This can restrict the number of
		virtual hosts you can use; especially if they all use different log
		On versions of FreeBSD older than 2.2 <SAMP>FD_SETSIZE</SAMP>, which
		limits the number of open files on the system, is controlled by a
		kernel option and is limited to 256. You can set this value using a
		line such as the following in your kernel configuration file:
		</P>
		<DL>
		<DD><CODE>options FD_SETSIZE <EM>nnn</EM></CODE>
		</DD>
		</DL>
		<P>
		This can restrict the number of
		virtual hosts you can use, especially if they all use different log
		files. Increasing this limit (and recompiling Apache) is not enough,
		as it is on some platforms (such as Solaris), as you also will have
		to recompile <SAMP>libc</SAMP> with the changed setting.
		</P>
		<P>
		On FreeBSD 3.0 the default is 1024, so the problem is lessened.
		With FreeBSD 2.2 and later, you <EM>can</EM> increase the setting of
		<SAMP>FD_SETSIZE</SAMP> at Apache compilation time by adding
		"<SAMP>-DFD_SETSIZE=<EM>nnn</EM></SAMP>" to the
		<SAMP>EXTRA_CFLAGS</SAMP> line in your <SAMP>Configuration</SAMP>
		file.
		</P>
		<P>
		On FreeBSD 3.0 the default is 1024, so the problem is lessened still
		more, and may not require any intervention at all.
		</P>
		<HR>
		</LI>
		@@ -1935,9 +1957,8 @@
		</P>
		<HR>
		</LI>
		<LI><A NAME="rewrite-prefixdocroot">
		<STRONG>Why are some of my URLs don't get prefixed with DocumentRoot
		when using mod_rewrite?</STRONG>
		<LI><A NAME="rewrite-prefixdocroot"><STRONG>Why don't some of my URLs
		get prefixed with DocumentRoot when using mod_rewrite?</STRONG>
		</A>
		<P>
		If the rule starts with <SAMP>/somedir/...</SAMP> make sure that really no
		@@ -1994,6 +2015,31 @@
		</P>
		<HR>
		</LI>
		<LI><A NAME="cgi-spec"><STRONG>Where can I find the "CGI
		specification"?</STRONG></A>
		<P>
		The Common Gateway Interface (CGI) specification currently lives in at
		least two versions:
		</P>
		<P>
		<OL>
		<LI>At the original NCSA site
		<<A
		HREF="http://hoohoo.ncsa.uiuc.edu/cgi/interface.html"
		><SAMP>http://hoohoo.ncsa.uiuc.edu/cgi/interface.html</SAMP></A>>.
		This version hasn't been updated since 1995, and there have been
		some efforts to update it and replace it with
		</LI>
		<LI>The most current version, which is struggling to become an
		Internet RFC, found at
		<<A
		HREF="http://www.ast.cam.ac.uk/~drtr/cgi-spec.html"
		><SAMP>http://www.ast.cam.ac.uk/~drtr/cgi-spec.html</SAMP></A>>.
		</LI>
		</OL>
		</P>
		<HR>
		</LI>

		<!-- Don't forget to add HR tags at the end of each list item.. -->