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