1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
4<html xmlns="http://www.w3.org/1999/xhtml">
5  <head>
6    <meta name="generator" content="HTML Tidy, see www.w3.org" />
7
8    <title>Module mod_log_agent</title>
9  </head>
10  <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
11
12  <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
13  vlink="#000080" alink="#FF0000">
14        <div align="CENTER">
15      <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" />
16
17      <h3>Apache HTTP Server Version 1.3</h3>
18    </div>
19
20
21    <h1 align="CENTER">Module mod_log_agent</h1>
22
23    <p>This module provides for logging of the client user
24    agents.</p>
25
26    <p><a href="module-dict.html#Status"
27    rel="Help"><strong>Status:</strong></a> Extension<br />
28     <a href="module-dict.html#SourceFile"
29    rel="Help"><strong>Source File:</strong></a>
30    mod_log_agent.c<br />
31     <a href="module-dict.html#ModuleIdentifier"
32    rel="Help"><strong>Module Identifier:</strong></a>
33    agent_log_module</p>
34
35    <h2>Summary</h2>
36
37    <p>This module is provided strictly for compatibility with NCSA
38    httpd, and is deprecated. We recommend you use <a
39    href="mod_log_config.html">mod_log_config</a> instead.</p>
40
41    <h2>Directives</h2>
42
43    <ul>
44      <li><a href="#agentlog">AgentLog</a></li>
45    </ul>
46
47    <p>See also: <a
48    href="mod_log_config.html#customlog">CustomLog</a> and <a
49    href="mod_log_config.html#logformat">LogFormat</a>.</p>
50    <hr />
51
52    <h2><a id="agentlog" name="agentlog">AgentLog</a></h2>
53
54    <a href="directive-dict.html#Syntax"
55    rel="Help"><strong>Syntax:</strong></a> AgentLog
56    <em>file-pipe</em><br />
57     <a href="directive-dict.html#Default"
58    rel="Help"><strong>Default:</strong></a> <code>AgentLog
59    logs/agent_log</code><br />
60     <a href="directive-dict.html#Context"
61    rel="Help"><strong>Context:</strong></a> server config, virtual
62    host<br />
63     <a href="directive-dict.html#Status"
64    rel="Help"><strong>Status:</strong></a> Extension<br />
65     <a href="directive-dict.html#Module"
66    rel="Help"><strong>Module:</strong></a> mod_log_agent
67
68    <p>The AgentLog directive sets the name of the file to which
69    the server will log the UserAgent header of incoming requests.
70    <em>File-pipe</em> is one of</p>
71
72    <dl>
73      <dt>A filename</dt>
74
75      <dd>A filename relative to the <a
76      href="core.html#serverroot">ServerRoot</a>.</dd>
77
78      <dt>`|' followed by a command</dt>
79
80      <dd>A program to receive the agent log information on its
81      standard input. Note the a new program will not be started
82      for a VirtualHost if it inherits the AgentLog from the main
83      server.</dd>
84    </dl>
85    <strong>Security:</strong> if a program is used, then it will
86    be run under the user who started httpd. This will be root if
87    the server was started by root; be sure that the program is
88    secure.
89
90    <p><strong>Security:</strong> See the <a
91    href="../misc/security_tips.html">security tips</a> document
92    for details on why your security could be compromised if the
93    directory where logfiles are stored is writable by anyone other
94    than the user that starts the server.</p>
95
96    <p>This directive is provided for compatibility with NCSA
97    1.4. The same result can be obtained by using the <a
98    href="mod_log_config.html#logformat">LogFormat</a> and <a
99    href="mod_log_config.html#customlog">CustomLog</a> directives as
100    shown in the following example:</p>
101
102<pre>
103    LogFormat "%{User-agent}i" agent
104    CustomLog logs/agent_log agent
105</pre>
106
107    <p>    <hr />
108
109    <h3 align="CENTER">Apache HTTP Server Version 1.3</h3>
110    <a href="./"><img src="../images/index.gif" alt="Index" /></a>
111    <a href="../"><img src="../images/home.gif" alt="Home" /></a>
112
113    </p>
114  </body>
115</html>
116
117