mod_log_referer.html revision 3d76f0e292da6a107829fbe83f98b8c0985c6ddb
1N/A<!--%hypertext -->
1N/A<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
1N/A<HTML>
1N/A<HEAD>
1N/A<TITLE>Apache module mod_log_referer</TITLE>
1N/A</HEAD>
1N/A
1N/A<BODY>
1N/A<IMG SRC="/images/apache_sub.gif" ALT="">
1N/A<!--/%hypertext -->
1N/A<H1>Module mod_log_referer</h1>
1N/A
1N/AThis module is contained in the <code>mod_log_referer.c</code> file, and is not
1N/Acompiled in by default. It provides for logging of the documents which
1N/Areference documents on the server.
1N/A
1N/A<h2>Log file format</h2>
1N/AThe log file contains a separate line for each refer. Each line has the
1N/Aformat
1N/A<blockquote><em>uri</em> <code>-></code> <em>document</em></blockquote>
1N/Awhere <em>uri</em> is the (%-escaped) URI for the document that references
1N/Athe one requested by the client, and <em>document</em> is the (%-decoded)
1N/Alocal URL to the document being referred to.
1N/A
1N/A<!--%hypertext -->
1N/A<h2>Directives</h2>
1N/A<ul>
1N/A<li><A HREF="#refererignore">RefererIgnore</A>
1N/A<li><A HREF="#refererlog">RefererLog</A>
1N/A</ul>
1N/A<hr>
1N/A<!--/%hypertext -->
1N/A
1N/A<A name="refererignore"><h2>RefererIgnore</h2></A>
1N/A<!--%plaintext &lt;?INDEX {\tt RefererIgnore} directive&gt; -->
1N/A<strong>Syntax:</strong> RefererIgnore <em>string string ...</em><br>
1N/A<Strong>Context:</strong> server config, virtual host<br>
1N/A<strong>Status:</strong> Extension<br>
1N/A<strong>Module:</strong> mod_log_referer<p>
1N/A
1N/AThe RefererIgnore directive adds to the list of strings to ignore in
1N/AReferer headers. If any of the strings in the list is contained in
1N/Athe Referer header, then no referrer information will be logged for the
1N/Arequest. Example:
1N/A<blockquote><code>RefererIgnore www.ncsa.uiuc.edu</code></blockquote>
1N/AThis avoids logging references from www.ncsa.uiuc.edu.
1N/A<p><hr>
1N/A
1N/A
1N/A<A name="refererlog"><h2>RefererLog</h2></A>
1N/A<!--%plaintext &lt;?INDEX {\tt RefererLog} directive&gt; -->
1N/A<strong>Syntax:</strong> RefererLog <em>file-pipe</em><br>
1N/A<strong>Default:</strong> <code>RefererLog logs/referer_log</code><br>
1N/A<Strong>Context:</strong> server config, virtual host<br>
1N/A<strong>Status:</strong> Extension<br>
1N/A<strong>Module:</strong> mod_log_referer<p>
1N/A
1N/AThe RefererLog directive sets the name of the file to which the server will
1N/Alog the Referer header of incoming requests. <em>File-pipe</em> is one
1N/Aof
1N/A<dl><dt>A filename
1N/A<dd>A filename relative to the <A HREF="core.html#serverroot">ServerRoot</A>.
1N/A<dt> `|' followed by a command
1N/A<dd>A program to receive the referrer log information on its standard input.
1N/ANote the a new program will not be started for a VirtualHost if it inherits
1N/Athe RefererLog from the main server.
1N/A</dl>
1N/A<strong>Security:</strong> if a program is used, then it will be
1N/Arun under the user who started httpd. This will be root if the server
1N/Awas started by root; be sure that the program is secure.<p>
1N/A
1N/AThis directive is provided for compatibility with NCSA 1.4.<p>
1N/A<!--%hypertext -->
1N/A<hr>
1N/A<A HREF="../"><IMG SRC="/images/apache_home.gif" ALT="Home"></A>
1N/A<A HREF="./"><IMG SRC="/images/apache_index.gif" ALT="Index"></A>
1N/A
1N/A</BODY>
1N/A</HTML>
1N/A<!--/%hypertext -->
1N/A