mod_info.html revision 582d397b9f02d426c91432e5841199e2249f2d77
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<HTML>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<HEAD>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<TITLE>Apache module mod_info</TITLE>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy</HEAD>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<BODY
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy BGCOLOR="#FFFFFF"
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy TEXT="#000000"
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy LINK="#0000FF"
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy VLINK="#000080"
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy ALINK="#FF0000"
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<!--#include virtual="header.html" -->
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<H1 ALIGN="CENTER">Module mod_info</H1>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<p>This module provides a comprehensive overview of the server
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedyconfiguration including all installed modules and directives in the
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedyconfiguration files.</p>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<P><A
f38cb554a534c6df738be3f4d23327e69888e634John Wren KennedyHREF="module-dict.html#Status"
f38cb554a534c6df738be3f4d23327e69888e634John Wren KennedyREL="Help"
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy><STRONG>Status:</STRONG></A> Extension
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<BR>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<A
f38cb554a534c6df738be3f4d23327e69888e634John Wren KennedyHREF="module-dict.html#SourceFile"
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren KennedyREL="Help"
258c9c7d86e8c69f1255ce2b5aeda40ac16d36caHans Rosenfeld><STRONG>Source File:</STRONG></A> mod_info.c
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<BR>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<A
f38cb554a534c6df738be3f4d23327e69888e634John Wren KennedyHREF="module-dict.html#ModuleIdentifier"
f38cb554a534c6df738be3f4d23327e69888e634John Wren KennedyREL="Help"
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy><STRONG>Module Identifier:</STRONG></A> info_module
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<BR>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<A
f38cb554a534c6df738be3f4d23327e69888e634John Wren KennedyHREF="module-dict.html#compatibility"
f38cb554a534c6df738be3f4d23327e69888e634John Wren KennedyREL="Help"
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy><STRONG>Compatibility:</STRONG></A> Available in Apache 1.1 and later.
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy</P>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<H2>Directives</H2>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<UL>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<LI><A HREF="#addmoduleinfo">AddModuleInfo</A>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy</UL>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy<h2>Using mod_info</h2>
24e268f3071ecc622f716e7801683c84f4d4f9dbMatthew Ahrens
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<P>
f38cb554a534c6df738be3f4d23327e69888e634John Wren KennedyTo configure it, add the following to your <CODE>httpd.conf</CODE> file.
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<PRE>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy&lt;Location /server-info&gt;
f38cb554a534c6df738be3f4d23327e69888e634John Wren KennedySetHandler server-info
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy&lt;/Location&gt;
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy</PRE>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy
f38cb554a534c6df738be3f4d23327e69888e634John Wren KennedyYou may wish to add a
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<A
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy HREF="core.html#limit"
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy>&lt;Limit&gt;</A>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedyclause inside the
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<A
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy HREF="core.html#location"
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy>location</A>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedydirective to limit access to your server configuration information.<P>
f38cb554a534c6df738be3f4d23327e69888e634John Wren KennedyOnce configured, the server information is obtained by accessing
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy<TT>http://your.host.dom/server-info</TT><P>
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy<BLOCKQUOTE>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy <STRONG>
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy Note that the configuration files are read by the module at run-time,
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy and therefore the display may <EM>not</EM> reflect the running
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy server's active configuration if the files have been changed since the
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy server was last reloaded. Also, the configuration files must be
f38cb554a534c6df738be3f4d23327e69888e634John Wren Kennedy readable by the user as which the server is running (see the
<A
HREF="core.html#user"
><SAMP>User</SAMP></A>
directive), or else the directive settings will not be listed.
<P>
It should also be noted that if <SAMP>mod_info</SAMP> is compiled into
the server, its handler capability is available in <EM>all</EM>
configuration files, including <EM>per</EM>-directory files
(<EM>e.g.</EM>, <SAMP>.htaccess</SAMP>). This may have
security-related ramifications for your site.
</P>
</STRONG>
</BLOCKQUOTE>
<HR>
<H2><A 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:
<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>