From: Ken Coar Date: Wed, 30 Jul 1997 18:02:33 +0000 (+0000) Subject: Added item about the CGI/1.1 spec online locations, and some more X-Git-Tag: APACHE_1_3b1~46 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ae66c789ed4a9c6dad7425e530772a39f071daa5;p=apache Added item about the CGI/1.1 spec online locations, and some more text about the FreeBSD/FD_SETSIZE stuff. (Marc has more to add on that particular topic. but I'd already written this - so he gets to correct/update my blither ;-) PR: 931,938 git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@78818 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/misc/FAQ.html b/docs/manual/misc/FAQ.html index 67fa3ed955..33ae833af0 100644 --- a/docs/manual/misc/FAQ.html +++ b/docs/manual/misc/FAQ.html @@ -15,7 +15,7 @@

Apache Server Frequently Asked Questions

- $Revision: 1.84 $ ($Date: 1997/07/25 10:25:46 $) + $Revision: 1.85 $ ($Date: 1997/07/30 18:02:33 $)

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. +
    +

    +
    +