manual/mod/mod_info.html

	mod_info.html revision 618d2847990e59c6fa82b74b160453e1048a2957
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<HTML>
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<HEAD>
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<TITLE>Apache module mod_info</TITLE>
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo</HEAD>
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<BODY
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo BGCOLOR="#FFFFFF"
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo TEXT="#000000"
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo LINK="#0000FF"
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo VLINK="#000080"
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo ALINK="#FF0000"
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo>
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<!--#include virtual="header.html" -->
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<h1 ALIGN="CENTER">Module mod_info</H1>
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo
02422a7f12dd487ce10ba12311a457b64eb148aeEric FerraiuoloThis module is contained in the <CODE>mod_info.c</CODE> file.  It
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuoloprovides a comprehensive overview of the server configuration
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuoloincluding all installed modules and directives in the configuration
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolofiles.  This module is not compiled into the
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuoloserver by default.  It is only available in Apache 1.1 and later. To
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuoloenable it, add the following line to the server build Configuration
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolofile, and rebuild the server:
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<PRE>
02422a7f12dd487ce10ba12311a457b64eb148aeEric FerraiuoloAddModule modules/standard/mod_info.o
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo</PRE>
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<H2>Directives</H2>
b5390ca8d67763a8c17c8dd688695774fb89826bEric Ferraiuolo<UL>
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<LI><A HREF="#addmoduleinfo">AddModuleInfo</A>
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo</UL>
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<HR>
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<P>
02422a7f12dd487ce10ba12311a457b64eb148aeEric FerraiuoloTo configure it, add the following to your <CODE>access.conf</CODE> file.
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo
02422a7f12dd487ce10ba12311a457b64eb148aeEric Ferraiuolo<PRE>
&lt;Location /server-info&gt;
SetHandler server-info
&lt;/Location&gt;
</PRE>

You may wish to add a
<A
 HREF="core.html#limit"
>&lt;Limit&gt;</A>
clause inside the
<A
 HREF="core.html#location"
>location</A>
directive to limit access to your server configuration information.<P>
Once configured, the server information is obtained by accessing
<TT>http://your.host.dom/server-info</TT><P>
<BLOCKQUOTE>
 <STRONG>
  Note that the configuration files are read by the module at run-time,
  and therefore the display may <EM>not</EM> reflect the running
  server's active configuration if the files have been changed since the
  server was last reloaded.  Also, the configuration files must be
  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> base<BR>
<A
 HREF="directive-dict.html#Module"
 REL="Help"
><STRONG>Module:</STRONG></A> mod_browser<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>