From: Ralf S. Engelschall Date: Thu, 31 Jul 1997 08:57:21 +0000 (+0000) Subject: merge in Ken's recent FAQ changes from HEAD X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=123e91c9ae2347363cedc9e2ba50412ec83533b7;p=thirdparty%2Fapache%2Fhttpd.git merge in Ken's recent FAQ changes from HEAD git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/1.3@78831 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/APACHE_1_2_X/htdocs/manual/misc/FAQ.html b/APACHE_1_2_X/htdocs/manual/misc/FAQ.html index bf326671d72..9f23b29a612 100644 --- a/APACHE_1_2_X/htdocs/manual/misc/FAQ.html +++ b/APACHE_1_2_X/htdocs/manual/misc/FAQ.html @@ -15,7 +15,7 @@

Apache Server Frequently Asked Questions

- $Revision: 1.63.2.12 $ ($Date: 1997/07/27 17:19:01 $) + $Revision: 1.63.2.13 $ ($Date: 1997/07/31 08:57:21 $)

The latest version of this FAQ is always available from the main @@ -221,33 +221,36 @@

  • Why does my authentification give me a server error?
  • Do I have to keep the (mSQL) - authentification information on the same machine? + authentification information on the same machine?
  • Why is my mSQL authentification terribly slow?
  • Where can I find mod_rewrite rulesets - which already solve particular URL-related problems? + which already solve particular URL-related problems?
  • Where can I find any published information about - URL-manipulations and mod_rewrite? + URL-manipulations and mod_rewrite?
  • Why is mod_rewrite so difficult to learn - and seems so complicated? + and seems so complicated?
  • What can I do if my RewriteRules don't work - as expected? + as expected?
    • -
  • Why are some of my URLs don't get - prefixed with DocumentRoot when using mod_rewrite? +
  • Why don't some of my URLs get + prefixed with DocumentRoot when using mod_rewrite?
  • How can I make all my URLs case-insensitive - with mod_rewrite? + with mod_rewrite?
  • Why are RewriteRules in my VirtualHost - parts ignored? + parts ignored?
  • How can I use strings with whitespaces - in RewriteRule's ENV flag? + in RewriteRule's ENV flag? +
    • +
  • Where can I find the "CGI + specification"?
    • @@ -577,6 +580,7 @@ >AddHandler directive.

    +

    1. In an appropriate section of your server configuration files, add a line such as @@ -597,10 +601,10 @@ HREF="../mod/core.html#options" >Options declaration that includes the ExecCGI option. -

      -

    +

    +

    In some situations it can be not conform to your local policy to actually allow all files named "*.cgi" to be executable. Perhaps all you want is to enable a particular file in a normal directory to @@ -611,16 +615,18 @@ >mod_rewrite and the following steps:

    +

    1. Locally add to the corresponding .htaccess file a ruleset similar to this one:

      -
      - RewriteEngine on
      - RewriteBase /~foo/bar/
      - RewriteRule ^quux\.cgi$ - [T=application/x-httpd-cgi]
      -
      +
      RewriteEngine on +
      + RewriteBase /~foo/bar/ +
      + RewriteRule ^quux\.cgi$ - [T=application/x-httpd-cgi]       +

      2. @@ -628,12 +634,11 @@ Options - declaration that includes the ExecCGI and - FollowSymLinks option. -

      -

      + declaration that includes the ExecCGI and + FollowSymLinks option.
    +

  • @@ -912,24 +917,25 @@ HREF="perf.html" >performance hints page. There is a specific note for - FreeBSD below. + FreeBSD below.
  • "Don't do that" - try to run with fewer virtual hosts
  • Spread your operation across multiple server processes (using - Listen - for example, but see the first point) and/or ports. + Listen + for example, but see the first point) and/or ports.

    • Since this is an operating-system limitation, there's not much else available in the way of solutions. +

    As of 1.2.1 we have made attempts to work around various limitations involving running with many descriptors. - More information is available. + More information is available.

    @@ -938,16 +944,32 @@ Can I increase FD_SETSIZE on FreeBSD?

    - On FreeBSD 2.2 and older FD_SETSIZE, 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 - files. Increasing this limit (and recompiling Apache) is not enough, + On versions of FreeBSD older than 2.2 FD_SETSIZE, 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: +

    +
    +
    options FD_SETSIZE nnn +
    +
    +

    + 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 libc with the changed setting.

    - On FreeBSD 3.0 the default is 1024, so the problem is lessened. + With FreeBSD 2.2 and later, you can increase the setting of + FD_SETSIZE at Apache compilation time by adding + "-DFD_SETSIZE=nnn" to the + EXTRA_CFLAGS line in your Configuration + file. +

    +

    + On FreeBSD 3.0 the default is 1024, so the problem is lessened still + more, and may not require any intervention at all.

    @@ -1639,9 +1661,9 @@
  • - Why is the environment variable - REMOTE_USER not set? - + Why is the environment variable + REMOTE_USER not set? +

    This variable is set and thus available in SSI or CGI scripts if and only if the requested document was protected by access @@ -1847,8 +1869,8 @@

  • - Where can I find mod_rewrite rulesets which already solve - particular URL-related problems? + Where can I find mod_rewrite rulesets which already solve + particular URL-related problems?

    There is a collection of @@ -1872,8 +1894,8 @@

  • - Where can I find any published information about URL-manipulations and - mod_rewrite? + Where can I find any published information about URL-manipulations and + mod_rewrite?

    There is an article from @@ -1898,8 +1920,8 @@

  • - Why is mod_rewrite so difficult to learn and seems so - complicated? + Why is mod_rewrite so difficult to learn and seems so + complicated?

    Hmmm... there are a lot of reasons. First, mod_rewrite itself is a powerful @@ -1924,8 +1946,8 @@

  • - What can I do if my RewriteRules don't work as expected? - + What can I do if my RewriteRules don't work as expected? +

    Use "RewriteLog somefile" and @@ -1935,9 +1957,8 @@

    • -
  • - Why are some of my URLs don't get prefixed with DocumentRoot - when using mod_rewrite? +
  • Why don't some of my URLs + get prefixed with DocumentRoot when using mod_rewrite?

    If the rule starts with /somedir/... make sure that really no @@ -1951,8 +1972,8 @@

  • - How can I make all my URLs case-insensitive with mod_rewrite? - + How can I make all my URLs case-insensitive with mod_rewrite? +

    You can't! The reason is: First, case translations for arbitrary length URLs @@ -1971,8 +1992,8 @@

  • - Why are RewriteRules in my VirtualHost parts ignored? - + Why are RewriteRules in my VirtualHost parts ignored? +

    Because you have to enable the engine for every virtual host explicitly due @@ -1982,8 +2003,8 @@

  • - How can I use strings with whitespaces in RewriteRule's ENV - flag? + How can I use strings with whitespaces in RewriteRule's ENV + flag?

    There is only one ugly solution: You have to surround the complete flag @@ -1994,6 +2015,31 @@

    • +
  • Where can I find the "CGI + specification"? +

    + The Common Gateway Interface (CGI) specification currently lives in at + least two versions: +

    +

    +

      +
    1. At the original NCSA site + <http://hoohoo.ncsa.uiuc.edu/cgi/interface.html>. + This version hasn't been updated since 1995, and there have been + some efforts to update it and replace it with +
      2. +
    2. The most current version, which is struggling to become an + Internet RFC, found at + <http://www.ast.cam.ac.uk/~drtr/cgi-spec.html>. +
      3. +
    +

    +
    +