| <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN"> |
| <HTML> |
| <HEAD> |
| <TITLE>Apache module mod_log_referer</TITLE> |
| </HEAD> |
| |
| <BODY> |
| <!--#include virtual="header.html" --> |
| <H1>Module mod_log_referer</h1> |
| |
| This module is contained in the <code>mod_log_referer.c</code> file, and is not |
| compiled in by default. It provides for logging of the documents which |
| reference documents on the server. |
| |
| <h2>Log file format</h2> |
| The log file contains a separate line for each refer. Each line has the |
| format |
| <blockquote><em>uri</em> <code>-></code> <em>document</em></blockquote> |
| where <em>uri</em> is the (%-escaped) URI for the document that references |
| the one requested by the client, and <em>document</em> is the (%-decoded) |
| local URL to the document being referred to. |
| |
| |
| <h2>Directives</h2> |
| <ul> |
| <li><A HREF="#refererignore">RefererIgnore</A> |
| <li><A HREF="#refererlog">RefererLog</A> |
| </ul> |
| <hr> |
| |
| |
| <A name="refererignore"><h2>RefererIgnore</h2></A> |
| <!--%plaintext <?INDEX {\tt RefererIgnore} directive> --> |
| <strong>Syntax:</strong> RefererIgnore <em>string string ...</em><br> |
| <Strong>Context:</strong> server config, virtual host<br> |
| <strong>Status:</strong> Extension<br> |
| <strong>Module:</strong> mod_log_referer<p> |
| |
| The RefererIgnore directive adds to the list of strings to ignore in |
| Referer headers. If any of the strings in the list is contained in |
| the Referer header, then no referrer information will be logged for the |
| request. Example: |
| <blockquote><code>RefererIgnore www.ncsa.uiuc.edu</code></blockquote> |
| This avoids logging references from www.ncsa.uiuc.edu. |
| <p><hr> |
| |
| |
| <A name="refererlog"><h2>RefererLog</h2></A> |
| <!--%plaintext <?INDEX {\tt RefererLog} directive> --> |
| <strong>Syntax:</strong> RefererLog <em>file-pipe</em><br> |
| <strong>Default:</strong> <code>RefererLog logs/referer_log</code><br> |
| <Strong>Context:</strong> server config, virtual host<br> |
| <strong>Status:</strong> Extension<br> |
| <strong>Module:</strong> mod_log_referer<p> |
| |
| The RefererLog directive sets the name of the file to which the server will |
| log the Referer header of incoming requests. <em>File-pipe</em> is one |
| of |
| <dl><dt>A filename |
| <dd>A filename relative to the <A HREF="core.html#serverroot">ServerRoot</A>. |
| <dt> `|' followed by a command |
| <dd>A program to receive the referrer log information on its standard input. |
| Note the a new program will not be started for a VirtualHost if it inherits |
| the RefererLog from the main server. |
| </dl> |
| <strong>Security:</strong> if a program is used, then it will be |
| run under the user who started httpd. This will be root if the server |
| was started by root; be sure that the program is secure.<p> |
| |
| <strong>Security:</strong> See the <A |
| HREF="../misc/security_tips.html">security tips</A> document for |
| details on why your security could be compromised if the directory |
| where logfiles are stored is writable by anyone other than the user |
| that starts the server.<P> |
| |
| This directive is provided for compatibility with NCSA 1.4.<p> |
| |
| <!--#include virtual="footer.html" --> |
| </BODY> |
| </HTML> |
| |
