Commit f5e5a6d8 authored by Christophe Jaillet's avatar Christophe Jaillet
Browse files

Document the 3rd argument of 'RewriteMap' 

(r1664575 in trunk)

Compatibility note will be added in the next commit.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1827600 13f79535-47bb-0310-9956-ffa450edef68
parent 2b25d843

docs/manual/mod/mod_rewrite.xml

+6 −0
Original line number Diff line number Diff line
@@ -300,6 +300,7 @@ LogLevel alert rewrite:trace3 
<name>RewriteMap</name>

<description>Defines a mapping function for key-lookup</description>

<syntax>RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em>

    <em>MapTypeOptions</em>

</syntax>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>
@@ -347,6 +348,11 @@ RewriteMap examplemap "txt:/path/to/file/map.txt" 
RewriteRule "^/ex/(.*)" "${examplemap:$1}"

      </highlight>



      <p>The meaning of the <em>MapTypeOptions</em> argument depends on

      particular <em>MapType</em>. See the

      <a href="../rewrite/rewritemap.html">Using RewriteMap</a> for

      more information.</p>



      <p>The following combinations for <em>MapType</em> and

      <em>MapSource</em> can be used:</p>

docs/manual/rewrite/rewritemap.xml

+5 −4
Original line number Diff line number Diff line
@@ -366,10 +366,11 @@ by many requests. 
    module="mod_rewrite">RewriteEngine</directive> set to

    <code>on</code>.</p>



    <p>By default, external rewriting programs are started as root.

    This can be changed on UNIX systems by passing user name and

    group name as third argument to <directive module="mod_rewrite">

    RewriteMap</directive> in the <code>username:groupname</code> format.</p>

    <p>By default, external rewriting programs are run as the

    user:group who started httpd. This can be changed on UNIX systems

    by passing user name and group name as third argument to

    <directive module="mod_rewrite">RewriteMap</directive> in the

    <code>username:groupname</code> format.</p>



    <p>This feature utilizes the <code>rewrite-map</code> mutex,

    which is required for reliable communication with the program.