mod_info.html revision 2664b08232b0a063d1ed03fb76a239786b2c7d50
0N/A<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
553N/A<html>
0N/A<head>
0N/A<title>Apache module mod_info</title>
0N/A</head>
0N/A
553N/A<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
0N/A<BODY
553N/A BGCOLOR="#FFFFFF"
0N/A TEXT="#000000"
0N/A LINK="#0000FF"
0N/A VLINK="#000080"
0N/A ALINK="#FF0000"
0N/A>
0N/A<!--#include virtual="header.html" -->
0N/A<h1 ALIGN="CENTER">Module mod_info</h1>
0N/A
0N/AThis module is contained in the <code>mod_info.c</code> file. It
0N/Aprovides a comprehensive overview of the server configuration
0N/Aincluding all installed modules and directives in the configuration
553N/Afiles. This module is not compiled into the
553N/Aserver by default. It is only available in Apache 1.1 and later. To
553N/Aenable it, add the following line to the server build Configuration
0N/Afile, and rebuild the server:
0N/A
0N/A<PRE>
0N/AModule info_module mod_info.o
0N/A</PRE>
0N/A
0N/A<H2>Directives</H2>
0N/A<UL>
0N/A<LI><A HREF="#addmoduleinfo">AddModuleInfo</A>
0N/A</UL>
0N/A
0N/A<HR>
0N/A<P>
0N/ATo configure it, add the following to your <code>access.conf</code> file.
0N/A
0N/A<PRE>
0N/A&lt;Location /server-info&gt;
0N/ASetHandler server-info
0N/A&lt;/Location&gt;
0N/A</PRE>
0N/A
0N/AYou may wish to add a
0N/A<A
0N/A HREF="core.html#limit"
0N/A>&lt;Limit&gt;</A>
0N/Aclause inside the
0N/A<A
0N/A HREF="core.html#location"
0N/A>location</A>
0N/Adirective to limit access to your server configuration information.<p>
0N/AOnce configured, the server information is obtained by accessing
0N/A<tt>http://your.host.dom/server-info</tt><p>
0N/A<BLOCKQUOTE>
0N/A <STRONG>
0N/A Note that the configuration files are read by the module at run-time,
0N/A and therefore the display may <EM>not</EM> reflect the running
0N/A server's active configuration if the files have been changed since the
0N/A server 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
0N/A HREF="core.html#user"
0N/A ><SAMP>User</SAMP></A>
0N/A directive), or else the directive settings will not be listed.
0N/A <P>
0N/A It should also be noted that if <SAMP>mod_info</SAMP> is compiled into
0N/A the server, its handler capability is available in <EM>all</EM>
0N/A configuration files, including <EM>per</EM>-directory files
0N/A (<EM>e.g.</EM>, <SAMP>.htaccess</SAMP>). This may have
0N/A security-related ramifications for your site.
0N/A </P>
0N/A </STRONG>
0N/A</BLOCKQUOTE>
0N/A
0N/A<HR>
0N/A
0N/A<H2><A NAME="addmoduleinfo">AddModuleInfo</A></H2>
0N/A<STRONG>Syntax:</STRONG> AddModuleInfo <EM>module-name string</EM><BR>
0N/A<STRONG>Context:</STRONG> server config, virtual host<BR>
0N/A<STRONG>Status:</STRONG> base<BR>
0N/A<STRONG>Module:</STRONG> mod_browser<BR>
0N/A<STRONG>Compatibility:</STRONG> Apache 1.3 and above<P>
0N/A
0N/AThis allows the content of <EM>string</EM> to be shown as
0N/AHTML interpreted,
0N/A<STRONG>Additional Information</STRONG> for the module <EM>module-name</EM>.
0N/AExample:
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
0N/A<!--#include virtual="footer.html" -->
0N/A</BODY>
0N/A</HTML>
0N/A