granicus.if.org Git - apache/blob - docs/manual/socache.xml

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
   3 <?xml-stylesheet type="text/xsl" href="./style/manual.en.xsl"?>
   4 <!-- $LastChangedRevision$ -->
   5
   6 <!--
   7  Licensed to the Apache Software Foundation (ASF) under one or more
   8  contributor license agreements.  See the NOTICE file distributed with
   9  this work for additional information regarding copyright ownership.
  10  The ASF licenses this file to You under the Apache License, Version 2.0
  11  (the "License"); you may not use this file except in compliance with
  12  the License.  You may obtain a copy of the License at
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  16  Unless required by applicable law or agreed to in writing, software
  17  distributed under the License is distributed on an "AS IS" BASIS,
  18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19  See the License for the specific language governing permissions and
  20  limitations under the License.
  21 -->
  22
  23 <manualpage metafile="socache.xml.meta">
  24
  25   <title>Shared Object Cache in Apache HTTP Server</title>
  26
  27   <summary>
  28     <p>The Shared Object Cache provides a means to share simple data
  29     across all a server's workers, regardless of <a href="mpm.html">thread
  30     and process models</a>.  It is used where the advantages of sharing
  31     data across processes outweigh the performance overhead of
  32     inter-process communication.</p>
  33   </summary>
  34
  35   <section id="providers">
  36     <title>Shared Object Cache Providers</title>
  37     <p>The shared object cache as such is an abstraction.  Four different
  38     modules implement it.  To use the cache, one or more of these modules
  39     must be present, and configured.</p>
  40     <p>The only configuration required is to select which cache provider
  41     to use.  This is the responsibility of modules using the cache, and
  42     they enable selecton using directives such as
  43     <directive module="authn_socache">AuthnCacheSOCache</directive>,
  44     <directive module="ssl">SSLSessionCache</directive>, and
  45     <directive module="ssl">SSLStaplingCache</directive>.</p>
  46     <p>Currently available providers are:</p>
  47     <dl>
  48     <dt>"dbm" (mod_socache_dbm)</dt>
  49     <dd>This makes use of a DBM hash file.
  50      The choice of underlying DBM configuration may be configurable
  51      if the installed APR version supports multiple DBM implementations.</dd>
  52     <dt>"dc" (mod_socache_dc)</dt>
  53     <dd>This makes use of the <a href="http://www.distcache.org/">distcache</a>
  54     distributed session caching libraries.</dd>
  55     <dt>"mc" (mod_socache_memcache)</dt>
  56     <dd>This makes use of the <a href="http://memcached.org/">memcached</a>
  57     high-performance, distributed memory object caching system.</dd>
  58     <dt>"shmcb" (mod_socache_shmcb)</dt>
  59     <dd>This makes use of a high-performance cyclic buffer inside a
  60      shared memory segment.</dd>
  61     </dl>
  62   </section>
  63
  64 </manualpage>