mirror of
https://github.com/apache/httpd.git
synced 2025-05-19 02:21:09 +03:00
8a147876e2
This is the end of this pass for the online manual. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@78228 13f79535-47bb-0310-9956-ffa450edef68
89 lines
3.1 KiB
HTML
89 lines
3.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>Apache module mod_log_referer</TITLE>
|
|
</HEAD>
|
|
|
|
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
|
|
<BODY
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#000080"
|
|
ALINK="#FF0000"
|
|
>
|
|
<!--#include virtual="header.html" -->
|
|
<H1 ALIGN="CENTER">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>
|
|
|
|
|
|
<h2><A name="refererignore">RefererIgnore</A></h2>
|
|
<!--%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>
|
|
|
|
|
|
<h2><A name="refererlog">RefererLog</A></h2>
|
|
<!--%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>
|
|
|