1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<title>Apache module mod_log_referer</title>
<style>
.obsolete
{
margin: 0;
padding: 8px 10px;
padding-left: 50px;
padding-bottom: 10px;
line-height: 1.4em;
background: #f99 url(../images/warning.png) no-repeat 0px 0px;
}
.currentdocs
{
background: #f99;
}
</style>
</head>
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
<body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
vlink="#000080" alink="#FF0000">
<div align="CENTER">
<img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" />
<h3>Apache HTTP Server Version 1.3</h3>
<div class="obsolete"><p>You are looking at the documentation for the
1.3 version of the Apache HTTP Server, which is no longer
maintained, and has been declared "end of life". If you are in
fact still using the 1.3 version, please consider upgrading.
The current version of the server is <a
href="http://httpd.apache.org/docs/2.4/">2.4</a>.
In the current version of the server, you should use
<a
href="http://httpd.apache.org/docs/2.4/mod/mod_log_config.html"
>mod_log_config</a>.</p>
</div>
<h1 align="CENTER">Module mod_log_referer</h1>
<p>This module provides for logging of the documents which
reference documents on the server.</p>
<p><a href="module-dict.html#Status"
rel="Help"><strong>Status:</strong></a> Extension<br />
<a href="module-dict.html#SourceFile"
rel="Help"><strong>Source File:</strong></a>
mod_log_referer.c<br />
<a href="module-dict.html#ModuleIdentifier"
rel="Help"><strong>Module Identifier:</strong></a>
referer_log_module</p>
<h2>Summary</h2>
<p>This module is provided strictly for compatibility with NCSA
httpd, and is deprecated. We recommend you use <a
href="mod_log_config.html">mod_log_config</a> instead.</p>
<h2>Directives</h2>
<ul>
<li><a href="#refererignore">RefererIgnore</a></li>
<li><a href="#refererlog">RefererLog</a></li>
</ul>
<p>See also: <a
href="mod_log_config.html#customlog">CustomLog</a> and <a
href="mod_log_config.html#logformat">LogFormat</a>.</p>
<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.
<hr />
<h2><a id="refererignore"
name="refererignore">RefererIgnore</a> directive</h2>
<a href="directive-dict.html#Syntax"
rel="Help"><strong>Syntax:</strong></a> RefererIgnore
<em>string</em> [<em>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> Extension<br />
<a href="directive-dict.html#Module"
rel="Help"><strong>Module:</strong></a> 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:</p>
<blockquote>
<code>RefererIgnore www.ncsa.uiuc.edu</code>
</blockquote>
This avoids logging references from www.ncsa.uiuc.edu.
<hr />
<h2><a id="refererlog" name="refererlog">RefererLog</a>
directive</h2>
<a href="directive-dict.html#Syntax"
rel="Help"><strong>Syntax:</strong></a> RefererLog
<em>file-pipe</em><br />
<a href="directive-dict.html#Default"
rel="Help"><strong>Default:</strong></a> <code>RefererLog
logs/referer_log</code><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> Extension<br />
<a href="directive-dict.html#Module"
rel="Help"><strong>Module:</strong></a> 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</p>
<dl>
<dt>A filename</dt>
<dd>A filename relative to the <a
href="core.html#serverroot">ServerRoot</a>.</dd>
<dt>`|' followed by a command</dt>
<dd>A program to receive the referrer log information on its
standard input. Note that a new program will not be started
for a VirtualHost if it inherits the RefererLog from the main
server.</dd>
</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>
<p>This directive is provided for compatibility with NCSA
1.4.</p>
<p><!--#include virtual="footer.html" -->
</p>
</body>
</html>
|
