mod_log_agent.html revision 4e59fdbc3e0d0c17a28469c9efbc0a071622d5ec
<!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>
<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>
</UL>
<p>See also: <a href="mod_log_config.html#customlog">CustomLog</a> and
<a href="mod_log_config.html#logformat">LogFormat</a>.
<HR>
<H2><A NAME="agentlog">AgentLog</A></H2>
<!--%plaintext &lt;?INDEX {\tt AgentLog} directive&gt; -->
<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
<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>