mod_info.html revision d0dd037bdab65b455b4056d58be501ca14e61dfe
0N/A<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
157N/A "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
0N/A
0N/A<html xmlns="http://www.w3.org/1999/xhtml">
0N/A <head>
0N/A <meta name="generator" content="HTML Tidy, see www.w3.org" />
157N/A
0N/A <title>Apache module mod_info</title>
157N/A </head>
0N/A <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
0N/A
0N/A <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
0N/A vlink="#000080" alink="#FF0000">
0N/A <!--#include virtual="header.html" -->
0N/A
0N/A <h1 align="CENTER">Module mod_info</h1>
0N/A
0N/A <p>This module provides a comprehensive overview of the server
0N/A configuration including all installed modules and directives in
0N/A the configuration files.</p>
157N/A
157N/A <p><a href="module-dict.html#Status"
157N/A rel="Help"><strong>Status:</strong></a> Extension<br />
0N/A <a href="module-dict.html#SourceFile"
0N/A rel="Help"><strong>Source File:</strong></a> mod_info.c<br />
0N/A <a href="module-dict.html#ModuleIdentifier"
0N/A rel="Help"><strong>Module Identifier:</strong></a>
0N/A info_module<br />
0N/A <a href="module-dict.html#compatibility"
0N/A rel="Help"><strong>Compatibility:</strong></a> Available in
0N/A Apache 1.1 and later.</p>
0N/A
0N/A <h2>Directives</h2>
0N/A
0N/A <ul>
0N/A <li><a href="#addmoduleinfo">AddModuleInfo</a></li>
0N/A </ul>
0N/A
0N/A <h2>Using mod_info</h2>
0N/A
0N/A <p>To configure it, add the following to your
0N/A <code>httpd.conf</code> file.</p>
0N/A<pre>
0N/A&lt;Location /server-info&gt;
0N/ASetHandler server-info
0N/A&lt;/Location&gt;
0N/A</pre>
0N/A You may wish to add a <a
0N/A href="core.html#limit">&lt;Limit&gt;</a> clause inside the <a
0N/A href="core.html#location">location</a> directive to limit
0N/A access to your server configuration information.
0N/A
0N/A <p>Once configured, the server information is obtained by
0N/A accessing <tt>http://your.host.dom/server-info</tt></p>
0N/A
0N/A <blockquote>
0N/A <strong>Note that the configuration files are read by the
0N/A module at run-time, and therefore the display may
0N/A <em>not</em> reflect the running server's active
0N/A configuration if the files have been changed since the server
0N/A was last reloaded. Also, the configuration files must be
0N/A readable by the user as which the server is running (see the
0N/A <a href="mpm_common.html#user"><samp>User</samp></a> directive), or
0N/A else the directive settings will not be listed.</strong>
0N/A
0N/A <p><strong>It should also be noted that if
0N/A <samp>mod_info</samp> is compiled into the server, its
0N/A handler capability is available in <em>all</em> configuration
0N/A files, including <em>per</em>-directory files (<em>e.g.</em>,
0N/A <samp>.htaccess</samp>). This may have security-related
0N/A ramifications for your site.</strong></p>
0N/A </blockquote>
0N/A <hr />
0N/A
0N/A <h2><a id="addmoduleinfo"
0N/A name="addmoduleinfo">AddModuleInfo</a></h2>
0N/A <a href="directive-dict.html#Syntax"
0N/A rel="Help"><strong>Syntax:</strong></a> AddModuleInfo
0N/A <em>module-name string</em><br />
0N/A <a href="directive-dict.html#Context"
0N/A rel="Help"><strong>Context:</strong></a> server config, virtual
0N/A host<br />
0N/A <a href="directive-dict.html#Status"
0N/A rel="Help"><strong>Status:</strong></a> Extension<br />
0N/A <a href="directive-dict.html#Module"
0N/A rel="Help"><strong>Module:</strong></a> mod_info<br />
0N/A <a href="directive-dict.html#Compatibility"
0N/A rel="Help"><strong>Compatibility:</strong></a> Apache 1.3 and
0N/A above
0N/A
0N/A <p>This allows the content of <em>string</em> to be shown as
0N/A HTML interpreted, <strong>Additional Information</strong> for
0N/A the module <em>module-name</em>. Example:</p>
0N/A
0N/A <blockquote>
0N/A<pre>
0N/AAddModuleInfo mod_auth.c 'See &lt;A HREF="http://www.apache.org/docs/mod/mod_auth.html"&gt;http://www.apache.org/docs/mod/mod_auth.html&lt;/A&gt;'
0N/A</pre>
0N/A </blockquote>
0N/A <!--#include virtual="footer.html" -->
0N/A </body>
0N/A</html>
0N/A
0N/A