From 9ec99270a93278bae0abff0ff720c11ce86b8a88 Mon Sep 17 00:00:00 2001
From: Nick Kew <niq@apache.org>
Date: Mon, 28 Jun 2010 21:23:19 +0000
Subject: [PATCH] Add cacheing to authn_dbd docs

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@958747 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_authn_dbd.xml | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/docs/manual/mod/mod_authn_dbd.xml b/docs/manual/mod/mod_authn_dbd.xml
index 43df6e227a..d0a5545ed7 100644
--- a/docs/manual/mod/mod_authn_dbd.xml
+++ b/docs/manual/mod/mod_authn_dbd.xml
@@ -57,12 +57,23 @@
 <seealso><directive module="mod_dbd">DBDriver</directive></seealso>
 <seealso><directive module="mod_dbd">DBDParams</directive></seealso>
 
+<section id="socache">
+<title>Performance and Cacheing</title>
+<p>Some users of DBD authentication in HTTPD 2.2 have reported that it
+imposes a problematic load on the database.  This is most likely where
+an HTML page contains hundreds of objects (e.g. images, scripts, etc)
+each of which requires authentication.  Users affected (or concerned)
+by this kind of problem should use <module>mod_authn_socache</module>
+to cache credentials and take most of the load off the database.</p>
+</section>
+
 <section id="example">
 <title>Configuration Example</title>
 <p>This simple example shows use of this module in the context of
 the Authentication and DBD frameworks.</p>
 <example><pre>
 # mod_dbd configuration
+# UPDATED to include authentication cacheing
 DBDriver pgsql
 DBDParams "dbname=apacheauth user=apache password=xxxxxx"
 
@@ -76,7 +87,13 @@ DBDExptime 300
   # for mod_authn_dbd
   AuthType Basic
   AuthName "My Server"
-  AuthBasicProvider dbd
+
+  # To cache credentials, put socache ahead of dbd here
+  AuthBasicProvider socache dbd
+
+  # Also required for caching: tell the cache to cache dbd lookups!
+  AuthnCacheProvider dbd
+  AuthnCacheContext my-server
 
   # mod_authz_core configuration
   Require valid-user
-- 
2.40.0