From 6e0cd724d6673e499afabc7f8dc5308e5d804377 Mon Sep 17 00:00:00 2001
From: Christophe Jaillet <jailletc36@apache.org>
Date: Thu, 28 Mar 2019 06:26:19 +0000
Subject: [PATCH] Add missing mod_socache_redis.xml file

It was part of http://home.apache.org/~jim/patches/socache_redisv2.patch but is not in r1855817.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1856454 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_socache_redis.xml | 122 ++++++++++++++++++++++++++
 1 file changed, 122 insertions(+)
 create mode 100644 docs/manual/mod/mod_socache_redis.xml

diff --git a/docs/manual/mod/mod_socache_redis.xml b/docs/manual/mod/mod_socache_redis.xml
new file mode 100644
index 00000000000..aff9db6d0ff
--- /dev/null
+++ b/docs/manual/mod/mod_socache_redis.xml
@@ -0,0 +1,122 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
+<!-- $LastChangedRevision: 1855701 $ -->
+
+<!--
+ 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_redis.xml.meta">
+
+<name>mod_socache_redis</name>
+<description>Redis based shared object cache provider.</description>
+<status>Extension</status>
+<sourcefile>mod_socache_redis.c</sourcefile>
+<identifier>socache_redis_module</identifier>
+<compatibility>Available in Apache 2.4.39 and later</compatibility>
+
+<summary>
+    <p><module>mod_socache_redis</module> is a shared object cache provider
+    which provides for creation and access to a cache backed by the
+    <a href="https://redis.io/">Redis</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 redis:redis.example.com:12345,redis2.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>RedisConnPoolTTL</name>
+<description>TTL used for the connection pool with the Redis server(s)</description>
+<syntax>RedisConnPoolTTL <em>num</em>[<em>units</em>]</syntax>
+<default>RedisConnPoolTTL 15s</default>
+<contextlist>
+<context>server config</context>
+<context>virtual host</context>
+</contextlist>
+<compatibility>Available in Apache 2.4.39 and later</compatibility>
+
+<usage>
+    <p>Set the time to keep idle connections with the Redis server(s)
+    alive (threaded platforms only).</p>
+    
+    <p>Valid values for <directive>RedisConnPoolTTL</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>
+
+    <example>
+    <highlight language="config">
+# Set a timeout of 10 minutes
+RedisConnPoolTTL 10min
+# Set a timeout of 60 seconds
+RedisConnPoolTTL 60
+    </highlight>
+    </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>RedisTimeout</name>
+<description>R/W timeout used for the connection with the Redis server(s)</description>
+<syntax>RedisTimeout <em>num</em>[<em>units</em>]</syntax>
+<default>RedisTimeout 5s</default>
+<contextlist>
+<context>server config</context>
+<context>virtual host</context>
+</contextlist>
+<compatibility>Available in Apache 2.4.39 and later</compatibility>
+
+<usage>
+    <p>Set the Read/Write timeout used for the connection with the Redis
+    server(s).</p>
+    
+    <p>Valid values for <directive>RedisTimeout</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>
+
+    <example>
+    <highlight language="config">
+# Set a timeout of 10 minutes
+RedisTimeout 10min
+# Set a timeout of 60 seconds
+RedisTimeout 60
+    </highlight>
+    </example>
+</usage>
+</directivesynopsis>
+
+</modulesynopsis>
-- 
2.47.3