[svnbook commit] r3264 - trunk/src/en/book

cmpilato noreply at red-bean.com
Mon Aug 11 10:25:12 CDT 2008


Author: cmpilato
Date: Mon Aug 11 10:25:12 2008
New Revision: 3264

Log:
Finish Trac ticket #125 (Document SVNPathAuthz short_circuit), and add
a section for mod_authz_svn directives to the reference chapter.

* en/book/ch09-reference.xml
  (svn.ref.mod_dav_svn): Fix the SVNPathAuthz directive to not claim
    to have a file-path value -- it's values are "On", "Off", or (the
    newly-added) "short_circuit".
  (svn.ref.mod_authz_svn): New section for mod_authz_svn directives.


Modified:
   trunk/src/en/book/ch09-reference.xml

Modified: trunk/src/en/book/ch09-reference.xml
==============================================================================
--- trunk/src/en/book/ch09-reference.xml	(original)
+++ trunk/src/en/book/ch09-reference.xml	Mon Aug 11 10:25:12 2008
@@ -8789,14 +8789,17 @@
           </varlistentry>
 
           <varlistentry>
-            <term><literal>SVNPathAuthz
-              <replaceable>file-path</replaceable></literal></term>
+            <term><literal>SVNPathAuthz On|Off|short_circuit</literal></term>
             <listitem>
 
-              <para>Controls path-based authorization by enabling or
-                disabling subrequests.  See
-                <xref linkend="svn.serverconfig.httpd.authz.pathauthzoff"/>
-                for details.</para>
+              <para>Controls path-based authorization by enabling
+                subrequests (<literal>On</literal>), disabling
+                subrequests (<literal>Off</literal>), or querying
+                <command>mod_authz_svn</command> directly
+                (<literal>short_circuit</literal>).  See <xref
+                linkend="svn.serverconfig.httpd.authz.pathauthzoff"/>
+                for details.  By default, this directive's value is
+                <literal>On</literal>.</para>
 
             </listitem>
           </varlistentry>
@@ -9002,6 +9005,99 @@
   <!-- ================================================================= -->
   <!-- ================================================================= -->
   <!-- ================================================================= -->
+  <sect1 id="svn.ref.mod_authz_svn">
+
+    <title>mod_authz_svn</title>
+    
+    <refentry id="svn.ref.mod_authz_svn.conf">
+      <refnamediv>
+
+        <refname>mod_authz_svn Configuration Directives</refname>
+        <refpurpose>Apache configuration directives for configuring
+        path-based authorization for Subversion repositories served
+        through the Apache HTTP Server.</refpurpose>
+
+      </refnamediv>
+
+      <refsect1 id="svn.ref.mod_authz_svn.conf.desc">
+        <title>Description</title>
+
+        <para>This section briefly describes each Apache configuration
+          directive offered by <command>mod_authz_svn</command>.  For
+          an in-depth description of using path-based authorization in
+          Subversion, see <xref linkend="svn.serverconfig.pathbasedauthz"/>.)</para>
+
+      </refsect1>
+
+      <refsect1 id="svn.ref.mod_authz_svn.conf.directives">
+        <title>Directives</title>
+
+        <para>These are the <filename>httpd.conf</filename> directives
+          that apply to <command>mod_authz_svn</command>:</para>
+
+        <variablelist>
+   
+          <varlistentry>
+            <term><literal>AuthzSVNAccessFile
+              <replaceable>file-path</replaceable></literal></term>
+            <listitem>
+
+              <para>Consult <replaceable>file-path</replaceable> for
+                access rules describing the permissions for paths in
+                Subversion repository.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>AuthzSVNAnonymous On|Off</literal></term>
+            <listitem>
+
+              <para>Set to <literal>Off</literal> to disable two
+                special-case behaviours of this
+                module:  interaction with the <literal>Satisfy
+                Any</literal> directive and enforcement of the
+                authorization policy even when no
+                <literal>Require</literal> directives are present.  By
+                default, this directive's value is
+                <literal>On</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>AuthzSVNAuthoritative On|Off</literal></term>
+            <listitem>
+
+              <para>Set to <literal>Off</literal> to allow access
+                control to be passed along to lower modules.  By default,
+                this directive's value is <literal>On</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>AuthzSVNNoAuthWhenAnonymousAllowed On|Off</literal></term>
+            <listitem>
+
+              <para>Set to <literal>On</literal> to suppress
+                authentication and authorization for requests which
+                anonymous users are allowed to perform.  By default,
+                this directive's value is
+                <literal>Off</literal>.</para>
+
+            </listitem>
+          </varlistentry>
+
+        </variablelist>
+      </refsect1>
+
+    </refentry>
+  </sect1>
+
+  <!-- ================================================================= -->
+  <!-- ================================================================= -->
+  <!-- ================================================================= -->
   <sect1 id="svn.ref.properties">
 
     <title>Subversion Properties</title>




More information about the svnbook-dev mailing list