Mailing List Archive

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: