summaryrefslogtreecommitdiff
path: root/docs/manual/mod/mod_log_agent.html
blob: 9e8fa50855c6f6661faff2b3fdb5807a056ee266 (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
55
56
57
58
59
60
61
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>Module mod_log_agent</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_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>