mirror of
https://github.com/apache/httpd.git
synced 2025-07-07 09:41:11 +03:00
3af317e82e
old latex stuff. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@77016 13f79535-47bb-0310-9956-ffa450edef68
76 lines
2.7 KiB
HTML
76 lines
2.7 KiB
HTML
<!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>
|
|
|
|
This directive is provided for compatibility with NCSA 1.4.<p>
|
|
|
|
<!--#include virtual="footer.html" -->
|
|
</BODY>
|
|
</HTML>
|
|
|