cvs commit: apache/htdocs/manual/mod mod_access.html

[Dean Gaudet]

dgaudet     97/04/24 04:25:12

  Modified:    htdocs/manual/mod  mod_access.html
  Log:
  Document from env=, and the initial states for the deny,allow and allow,deny
  orders.
  
  Revision  Changes    Path
  1.4       +54 -5     apache/htdocs/manual/mod/mod_access.html
  
  Index: mod_access.html
  ===================================================================
  RCS file: /export/home/cvs/apache/htdocs/manual/mod/mod_access.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -C3 -r1.3 -r1.4
  *** mod_access.html   1997/02/03 01:18:17     1.3
  --- mod_access.html   1997/04/24 11:25:11     1.4
  ***************
  *** 16,22 ****
  --- 16,24 ----
    
    <menu>
    <li><A HREF="#allow">allow</A>
  + <li><A HREF="#allowfromenv">allow from env=</A>
    <li><A HREF="#deny">deny</A>
  + <li><A HREF="#denyfromenv">deny from env=</A>
    <li><A HREF="#order">order</A>
    </menu>
    <hr>
  ***************
  *** 49,55 ****
    Note that this compares whole components; <code>bar.edu</code>
    would not match <code>foobar.edu</code>.<p>
    
  ! See also <A HREF="#deny">deny</A> and <A HREF="#order">order</A>.<p><hr>
    
    <A name="deny"><h2>deny</h2></A>
    <!--%plaintext &lt;?INDEX {\tt deny} directive&gt; -->
  --- 51,80 ----
    Note that this compares whole components; <code>bar.edu</code>
    would not match <code>foobar.edu</code>.<p>
    
  ! See also <A HREF="#deny">deny</A>, <A HREF="#order">order</A>, and
  ! <a href="mod_browser.html#browsermatch">BrowserMatch</a>.<p>
  ! 
  ! <a name="allowfromenv"><strong>Syntax:</strong> allow from 
env=<em>variablename</em></a><br>
  ! <Strong>Context:</strong> directory, .htaccess<br>
  ! <Strong>Override:</strong> Limit<br>
  ! <strong>Status:</strong> Base<br>
  ! <strong>Module:</strong> mod_access<br>
  ! <strong>Compatibility:</strong> Apache 1.2 and above<p>
  ! 
  ! The allow from env directive controls access to a directory by the
  ! existance (or non-existance) of an environment variable.
  ! 
  ! Example:<blockquote><pre>
  ! BrowserMatch ^KnockKnock/2.0 let_me_in
  ! &lt;Directory /docroot&gt;
  ! order allow,deny
  ! allow from env=let_me_in
  ! deny from all
  ! &lt;/Directory&gt;
  ! </pre></blockquote>
  ! 
  ! See also <A HREF="#denyfromenv">deny from env</A>
  ! and <A HREF="#order">order</A>.<p><hr>
    
    <A name="deny"><h2>deny</h2></A>
    <!--%plaintext &lt;?INDEX {\tt deny} directive&gt; -->
  ***************
  *** 78,84 ****
    Note that this compares whole components; <code>bar.edu</code>
    would not match <code>foobar.edu</code>.<p>
    
  ! See also <A HREF="#allow">allow</A> and <A HREF="#order">order</A>.<p><hr>
    
    <A name="order"><h2>order</h2></A>
    <!--%plaintext &lt;?INDEX {\tt order} directive&gt; -->
  --- 103,131 ----
    Note that this compares whole components; <code>bar.edu</code>
    would not match <code>foobar.edu</code>.<p>
    
  ! See also <A HREF="#allow">allow</A> and <A HREF="#order">order</A>.<p>
  ! 
  ! <a name="denyfromenv"><strong>Syntax:</strong> deny from 
env=<em>variablename</em></a><br>
  ! <Strong>Context:</strong> directory, .htaccess<br>
  ! <Strong>Override:</strong> Limit<br>
  ! <strong>Status:</strong> Base<br>
  ! <strong>Module:</strong> mod_access<br>
  ! <strong>Compatibility:</strong> Apache 1.2 and above<p>
  ! 
  ! The deny from env directive controls access to a directory by the
  ! existance (or non-existance) of an environment variable.
  ! 
  ! Example:<blockquote><pre>
  ! BrowserMatch ^BadRobot/0.9 go_away
  ! &lt;Directory /docroot&gt;
  ! order deny,allow
  ! deny from env=go_away
  ! allow from all
  ! &lt;/Directory&gt;
  ! </pre></blockquote>
  ! 
  ! See also <A HREF="#allowfromenv">allow from env</A>
  ! and <A HREF="#order">order</A>.<p><hr>
    
    <A name="order"><h2>order</h2></A>
    <!--%plaintext &lt;?INDEX {\tt order} directive&gt; -->
  ***************
  *** 94,105 ****
    of
    <dl>
    <dt>deny,allow
  ! <dd>the deny directives are evaluated before the allow directives.
    <dt>allow,deny
  ! <dd>the allow directives are evaluated before the deny directives.
    <dt>mutual-failure
    <dd>Only those hosts which appear on the allow list and do not appear
  ! on the deny list are granted access.
    </dl>
    
    Example:
  --- 141,154 ----
    of
    <dl>
    <dt>deny,allow
  ! <dd>the deny directives are evaluated before the allow directives.  (The
  ! initial state is OK.)
    <dt>allow,deny
  ! <dd>the allow directives are evaluated before the deny directives.  (The
  ! initial state is FORBIDDEN.)
    <dt>mutual-failure
    <dd>Only those hosts which appear on the allow list and do not appear
  ! on the deny list are granted access.  (The initial state is irrelevant.)
    </dl>
    
    Example: