httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From n..@apache.org
Subject svn commit: r1075625 - in /httpd/httpd/trunk/docs/manual: mod/mod_authn_socache.xml sitemap.xml socache.xml socache.xml.meta
Date Tue, 01 Mar 2011 02:42:13 GMT
Author: niq
Date: Tue Mar  1 02:42:13 2011
New Revision: 1075625

URL: http://svn.apache.org/viewvc?rev=1075625&view=rev
Log:
Document socache and fix the TODO in authn_socache docs.

Added:
    httpd/httpd/trunk/docs/manual/socache.xml
    httpd/httpd/trunk/docs/manual/socache.xml.meta
Modified:
    httpd/httpd/trunk/docs/manual/mod/mod_authn_socache.xml
    httpd/httpd/trunk/docs/manual/sitemap.xml

Modified: httpd/httpd/trunk/docs/manual/mod/mod_authn_socache.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_authn_socache.xml?rev=1075625&r1=1075624&r2=1075625&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_authn_socache.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_authn_socache.xml Tue Mar  1 02:42:13 2011
@@ -100,12 +100,11 @@ the load on backends</description>
 <override>None</override>
 
 <usage>
-    <p>This is a server-wide setting.  If not set, your platform's
+    <p>This is a server-wide setting to select a provider for the
+    <a href="../socache.html">shared object cache</a>.
+    Values are "dbm", "dc", "mc", or "shmcb", each subject to the
+    appropriate module being loaded.  If not set, your platform's
        default will be used.</p>
-    <note><title>socache</title>
-      <p>The cache is built on the the <var>socache</var> framework.
-      We need a link here once that's documented!</p>
-    </note>
 </usage>
 </directivesynopsis>
 

Modified: httpd/httpd/trunk/docs/manual/sitemap.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/sitemap.xml?rev=1075625&r1=1075624&r2=1075625&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/sitemap.xml (original)
+++ httpd/httpd/trunk/docs/manual/sitemap.xml Tue Mar  1 02:42:13 2011
@@ -57,8 +57,10 @@ Documentation</a>.</p>
 <page href="bind.html">Setting which addresses and ports Apache uses</page>
 <page href="mpm.html">Multi-Processing Modules (MPMs)</page>
 <page href="env.html">Environment Variables in Apache</page>
+<page href="expr.html">Expression Parsing in Apache</page>
 <page href="handler.html">Apache's Handler Use</page>
 <page href="filter.html">Filters</page>
+<page href="socache.html">Shared Object Cache Support</page>
 <page href="suexec.html">suEXEC Support</page>
 <page href="misc/perf-tuning.html">Performance Hints</page>
 <page href="http://wiki.apache.org/httpd/FAQ">Frequently Asked Questions</page>

Added: httpd/httpd/trunk/docs/manual/socache.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/socache.xml?rev=1075625&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/socache.xml (added)
+++ httpd/httpd/trunk/docs/manual/socache.xml Tue Mar  1 02:42:13 2011
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="./style/manual.en.xsl"?>
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<manualpage metafile="socache.xml.meta">
+
+  <title>Shared Object Cache in Apache HTTP Server</title>
+
+  <summary>
+    <p>The Shared Object Cache provides a means to share simple data
+    across all a server's workers, regardless of <a href="mpm.html">thread
+    and process models</a>.  It is used where the advantages of sharing
+    data across processes outweigh the performance overhead of
+    inter-process communication.</p>
+  </summary>
+
+<seealso><module>mod_socache_dbm</module></seealso>
+<seealso><module>mod_socache_dc</module></seealso>
+<seealso><module>mod_socache_memcache</module></seealso>
+<seealso><module>mod_socache_shmcb</module></seealso>
+
+  <section id="providers">
+    <title>Shared Object Cache Providers</title>
+    <p>The shared object cache as such is an abstraction.  Four different
+    modules implement it.  To use the cache, one or more of these modules
+    must be present, and configured.</p>
+    <p>The only configuration required is to select which cache provider
+    to use.  This is the responsibility of modules using the cache, and
+    they enable selecton using directives such as
+    <directive module="authn_socache">AuthnCacheSOCache</directive>,
+    <directive module="ssl">SSLSessionCache</directive>, and
+    <directive module="ssl">SSLStaplingCache</directive>.</p>
+    <p>Currently available providers are:</p>
+    <dl>
+    <dt><module>mod_socache_dbm</module> ("dbm")</dt>
+    <dd>This makes use of a DBM hash file.
+     The choice of underlying DBM configuration may be configurable
+     if the installed APR version supports multiple DBM implementations.</dd>
+    <dt><module>mod_socache_dc</module> ("dc")</dt>
+    <dd>This makes use of the <a href="http://www.distcache.org/">distcache</a>
+    distributed session caching libraries.</dd>
+    <dt><module>mod_socache_memcache</module> ("mc")</dt>
+    <dd>This makes use of the <a href="http://memcached.org/">memcached</a>
+    high-performance, distributed memory object caching system.</dd>
+    <dt><module>mod_socache_shmcb</module> ("shmcb")</dt>
+    <dd>This makes use of a high-performance cyclic buffer inside a
+     shared memory segment.</dd>
+    </dl>
+  </section>
+
+</manualpage>

Added: httpd/httpd/trunk/docs/manual/socache.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/socache.xml.meta?rev=1075625&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/socache.xml.meta (added)
+++ httpd/httpd/trunk/docs/manual/socache.xml.meta Tue Mar  1 02:42:13 2011
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!-- GENERATED FROM XML: DO NOT EDIT -->
+
+<metafile reference="socache.xml">
+  <basename>socache</basename>
+  <path>/</path>
+  <relpath>.</relpath>
+
+  <variants>
+    <variant>en</variant>
+  </variants>
+</metafile>



Mime
View raw message