mod_info.xml revision ca0d928ec8e2519c9ef548469de80d80efd0fdba
c3fcea07965f59723831e23da647a77518285b8eslive<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
e942c741056732f50da2074b36fe59805d370650slive<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
23171986812b568beef50b28bdca284ab949e774rbowen<modulesynopsis>
c3fcea07965f59723831e23da647a77518285b8eslive<description>Provides a comprehensive overview of the server
c3fcea07965f59723831e23da647a77518285b8esliveconfiguration</description>
c3fcea07965f59723831e23da647a77518285b8eslive <p>To configure <module>mod_info</module>, add the following to your
23171986812b568beef50b28bdca284ab949e774rbowen<Location /server-info><br />
23171986812b568beef50b28bdca284ab949e774rbowenSetHandler server-info<br />
23171986812b568beef50b28bdca284ab949e774rbowen</Location><br />
c3fcea07965f59723831e23da647a77518285b8eslive <p>You may wish to add a
ca0d928ec8e2519c9ef548469de80d80efd0fdband <directive type="section" module="core">Limit</directive>
23171986812b568beef50b28bdca284ab949e774rbowen clause inside the
ca0d928ec8e2519c9ef548469de80d80efd0fdband <directive type="section" module="core">Location</directive>
23171986812b568beef50b28bdca284ab949e774rbowen directive to limit access to your server configuration
c3fcea07965f59723831e23da647a77518285b8eslive information.</p>
23171986812b568beef50b28bdca284ab949e774rbowen <p>Once configured, the server information is obtained by
23171986812b568beef50b28bdca284ab949e774rbowen accessing <code>http://your.host.dom/server-info</code></p>
23171986812b568beef50b28bdca284ab949e774rbowen Note that the configuration files are read by the
23171986812b568beef50b28bdca284ab949e774rbowen module at run-time, and therefore the display may
23171986812b568beef50b28bdca284ab949e774rbowen configuration if the files have been changed since the server
23171986812b568beef50b28bdca284ab949e774rbowen was last reloaded. Also, the configuration files must be
23171986812b568beef50b28bdca284ab949e774rbowen readable by the user as which the server is running (see the
23171986812b568beef50b28bdca284ab949e774rbowen <directive module="mpm_common">User</directive> directive), or
23171986812b568beef50b28bdca284ab949e774rbowen else the directive settings will not be listed.
23171986812b568beef50b28bdca284ab949e774rbowen <p>It should also be noted that if
23171986812b568beef50b28bdca284ab949e774rbowen <module>mod_info</module> is compiled into the server, its
23171986812b568beef50b28bdca284ab949e774rbowen handler capability is available in <em>all</em> configuration
23171986812b568beef50b28bdca284ab949e774rbowen files, including <em>per</em>-directory files (<em>e.g.</em>,
23171986812b568beef50b28bdca284ab949e774rbowen <code>.htaccess</code>). This may have security-related
23171986812b568beef50b28bdca284ab949e774rbowen ramifications for your site.</p>
d87e108084c51be918345aaa2e2c05803ee88a3djwoolley <p>In particular, this module can leak sensitive information
d87e108084c51be918345aaa2e2c05803ee88a3djwoolley from the configuration directives of other Apache modules such as
d87e108084c51be918345aaa2e2c05803ee88a3djwoolley system paths, usernames/passwords, database names, etc. Due to
d87e108084c51be918345aaa2e2c05803ee88a3djwoolley the way this module works there is no way to block information
d87e108084c51be918345aaa2e2c05803ee88a3djwoolley from it. Therefore, this module should ONLY be used in a controlled
d87e108084c51be918345aaa2e2c05803ee88a3djwoolley environment and always with caution.</p>
23171986812b568beef50b28bdca284ab949e774rbowen<directivesynopsis>
15ba1801088da1aad6d20609cf3f7b0b1eefce8aslive<description>Adds additional information to the module
23171986812b568beef50b28bdca284ab949e774rboweninformation displayed by the server-info handler</description>
23171986812b568beef50b28bdca284ab949e774rbowen<syntax>AddModuleInfo <em>module-name string</em></syntax>
23171986812b568beef50b28bdca284ab949e774rbowen<contextlist><context>server config</context> <context>virtual
23171986812b568beef50b28bdca284ab949e774rbowen <p>This allows the content of <em>string</em> to be shown as
23171986812b568beef50b28bdca284ab949e774rbowen HTML interpreted, <strong>Additional Information</strong> for
9ed9eaf871c58d281af02e76125ceadb5060afa5nd href="http://www.apache.org/docs-2.0/mod/mod_authn_file.html">\<br />
9ed9eaf871c58d281af02e76125ceadb5060afa5nd http://www.apache.org/docs-2.0/mod/mod_authn_file.html</a>'
23171986812b568beef50b28bdca284ab949e774rbowen</directivesynopsis>
23171986812b568beef50b28bdca284ab949e774rbowen</modulesynopsis>