mod_info.xml revision 6fbd2e53c97ea6976d93e0ac521adabc55e0fb73
013e1ddd21f2142a369c9a9a0eeb6c6a0bc3fcf3patrikj<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
e942c741056732f50da2074b36fe59805d370650slive<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd Copyright 2002-2004 The Apache Software Foundation
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding Licensed under the Apache License, Version 2.0 (the "License");
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding you may not use this file except in compliance with the License.
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding You may obtain a copy of the License at
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd Unless required by applicable law or agreed to in writing, software
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd distributed under the License is distributed on an "AS IS" BASIS,
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd See the License for the specific language governing permissions and
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd limitations under the License.
1c47b0c72c991a6f0ad172c74df0936fe13d6fbfslive<description>Provides a comprehensive overview of the server
5f18f92c1354462df6dc2ba38277a953fa700b13gryzorconfiguration</description>
1c47b0c72c991a6f0ad172c74df0936fe13d6fbfslive <p>To configure <module>mod_info</module>, add the following to your
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim <Location /server-info><br />
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim SetHandler server-info<br />
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin </Location>
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim </example>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin <p>You may wish to add a
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim <directive type="section" module="core">Limit</directive>
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin clause inside the
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin <directive type="section" module="core">Location</directive>
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim directive to limit access to your server configuration
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim information.</p>
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim <p>Once configured, the server information is obtained by
f6445f3ad1c82f9398dc8edd77093cd3e20b806cnoirin accessing <code>http://your.host.dom/server-info</code></p>
f0a393c5c2d7de58f447855369ad2fbfa254e544rbowen Note that the configuration files are read by the
1c47b0c72c991a6f0ad172c74df0936fe13d6fbfslive module at run-time, and therefore the display may
7571ea383299910bead3e93e66246cb212a28d0figalic configuration if the files have been changed since the server
bc36e90829b1ee123307a2339519265139a88173sf was last reloaded. Also, the configuration files must be
bc36e90829b1ee123307a2339519265139a88173sf readable by the user as which the server is running (see the
bc36e90829b1ee123307a2339519265139a88173sf <directive module="mpm_common">User</directive> directive), or
bc36e90829b1ee123307a2339519265139a88173sf else the directive settings will not be listed.
bc36e90829b1ee123307a2339519265139a88173sf <p>It should also be noted that if
bc36e90829b1ee123307a2339519265139a88173sf <module>mod_info</module> is compiled into the server, its
bc36e90829b1ee123307a2339519265139a88173sf handler capability is available in <em>all</em> configuration
bc36e90829b1ee123307a2339519265139a88173sf ramifications for your site.</p>
bc36e90829b1ee123307a2339519265139a88173sf <p>In particular, this module can leak sensitive information
bc36e90829b1ee123307a2339519265139a88173sf from the configuration directives of other Apache modules such as
bc36e90829b1ee123307a2339519265139a88173sf system paths, usernames/passwords, database names, etc. Due to
3a257106808eabaefbb483bdc6273e7af062ead8humbedooh the way this module works there is no way to block information
4927aa0c58523071e62d47580cec3b1fb1100ae2rbowen from it. Therefore, this module should <strong>only</strong> be
3a257106808eabaefbb483bdc6273e7af062ead8humbedooh used in a controlled environment and always with caution.</p>
9b3696c7ad70387ecd46e0f061b99d381dc392f9rbowen<directivesynopsis>
9b3696c7ad70387ecd46e0f061b99d381dc392f9rbowen<description>Adds additional information to the module
9b3696c7ad70387ecd46e0f061b99d381dc392f9rboweninformation displayed by the server-info handler</description>
9b3696c7ad70387ecd46e0f061b99d381dc392f9rbowen<syntax>AddModuleInfo <var>module-name</var> <var>string</var></syntax>
9b3696c7ad70387ecd46e0f061b99d381dc392f9rbowen<contextlist><context>server config</context><context>virtual host</context>
9b3696c7ad70387ecd46e0f061b99d381dc392f9rbowen</contextlist>
9b3696c7ad70387ecd46e0f061b99d381dc392f9rbowen <p>This allows the content of <var>string</var> to be shown as
9b3696c7ad70387ecd46e0f061b99d381dc392f9rbowen HTML interpreted, <strong>Additional Information</strong> for
1c47b0c72c991a6f0ad172c74df0936fe13d6fbfslive href="http://www.apache.org/docs-2.1/mod/mod_deflate.html">\<br />
013e1ddd21f2142a369c9a9a0eeb6c6a0bc3fcf3patrikj http://www.apache.org/docs-2.1/mod/mod_deflate.html</a>'
1c47b0c72c991a6f0ad172c74df0936fe13d6fbfslive</directivesynopsis>
1c47b0c72c991a6f0ad172c74df0936fe13d6fbfslive</modulesynopsis>