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
|
<!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="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<title>Module mod_log_agent</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_agent</h1>
<p>This module provides for logging of the client user
agents.</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_agent.c<br />
<a href="module-dict.html#ModuleIdentifier"
rel="Help"><strong>Module Identifier:</strong></a>
agent_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="#agentlog">AgentLog</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>
<hr />
<h2><a id="agentlog" name="agentlog">AgentLog</a></h2>
<a href="directive-dict.html#Syntax"
rel="Help"><strong>Syntax:</strong></a> AgentLog
<em>file-pipe</em><br />
<a href="directive-dict.html#Default"
rel="Help"><strong>Default:</strong></a> <code>AgentLog
logs/agent_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_agent
<p>The AgentLog directive sets the name of the file to which
the server will log the UserAgent 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 agent log information on its
standard input. Note the a new program will not be started
for a VirtualHost if it inherits the AgentLog 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. The same result can be obtained by using the <a
href="mod_log_config.html#logformat">LogFormat</a> and <a
href="mod_log_config.html#customlog">CustomLog</a> directives as
shown in the following example:</p>
<pre>
LogFormat "%{User-agent}i" agent
CustomLog logs/agent_log agent
</pre>
<p><!--#include virtual="footer.html" -->
</p>
</body>
</html>
|
