summaryrefslogtreecommitdiff
path: root/docs/manual/mod/mod_log_agent.html
blob: 5307c76c9d4a7ba157cf4ed368f0a0eadd2cff7a (plain)
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
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<HTML>
<HEAD>
<TITLE>Module mod_log_agent</TITLE>
</HEAD>

<BODY>
<!--#include virtual="header.html" -->
<H1>Module mod_log_agent</h1>

This module is contained in the <code>mod_log_agent.c</code> file, and is not
compiled in by default. It provides for logging of the client user agents.


<ul>
<li><A HREF="#agentlog">AgentLog</A>
</ul>
<hr>


<h2><A name="agentlog">AgentLog</A></h2>
<!--%plaintext &lt;?INDEX {\tt AgentLog} directive&gt; -->
<strong>Syntax:</strong> AgentLog <em>file-pipe</em><br>
<strong>Default:</strong> <code>AgentLog logs/agent_log</code><br>
<Strong>Context:</strong> server config, virtual host<br>
<strong>Status:</strong> Extension<br>
<strong>Module:</strong> 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
<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 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.
</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>