<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
<!-- $LastChangedRevision$ -->

<!--
 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.
-->

<modulesynopsis metafile="mod_socache_memcache.xml.meta">

<name>mod_socache_memcache</name>
<description>Memcache based shared object cache provider.</description>
<status>Extension</status>
<sourcefile>mod_socache_memcache.c</sourcefile>
<identifier>socache_memcache_module</identifier>

<summary>
    <p><code>mod_socache_memcache</code> is a shared object cache provider
    which provides for creation and access to a cache backed by the
    <a href="http://memcached.org/">memcached</a>
    high-performance, distributed memory object caching system.
    </p>

 
    <p>This shared object cache provider's "create" method requires a 
       comma separated list of memcached host/port specifications. If using
       this provider via another modules configuration (such as 
       <directive module="mod_ssl">SSLSessionCache</directive>), provide
       the list of servers as the optional "arg" parameter.</p>

     <highlight language="config">
         SSLSessionCache memcache:memcache.example.com:12345,memcache2.example.com:12345
     </highlight>
      
    <p>Details of other shared object cache providers can be found
    <a href="../socache.html">here</a>.
    </p>

</summary>

<directivesynopsis>
<name>MemcacheConnTTL</name>
<description>Keepalive time for idle connections</description>
<syntax>MemcacheConnTTL <em>num[units]</em></syntax>
<default>MemcacheConnTTL 15s</default>
<contextlist>
<context>server config</context>
<context>virtual host</context>
</contextlist>
<compatibility>Available in Apache 2.4.17 and later</compatibility>

<usage>

    <p>Set the time to keep idle connections with the memcache server(s)
    alive (threaded platforms only).</p>
    
    <p>Valid values for <directive>MemcacheConnTTL</directive> are times
    up to one hour. 0 means no timeout.</p>

    <note><p>This timeout defaults to units of seconds, but accepts
    suffixes for milliseconds (ms), seconds (s), minutes (min), and hours (h).
    </p></note>

    <p>Before Apache 2.4.17, this timeout was hardcoded and its value was 600 usec.
    So, the closest configuration to match the legacy behaviour is to set
    <directive>MemcacheConnTTL</directive> to 1ms.</p>

    <example>
    <highlight language="config">
# Set a timeout of 10 minutes
MemcacheConnTTL 10min
# Set a timeout of 60 seconds
MemcacheConnTTL 60
    </highlight>
    </example>

</usage>
</directivesynopsis>

</modulesynopsis>
