mod_log_agent.html revision e10c7703114de421bfd2772a0265691884bafdb8
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<HTML>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<HEAD>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<TITLE>Module mod_log_agent</TITLE>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar</HEAD>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<BODY>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<!--#include virtual="header.html" -->
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<H1>Module mod_log_agent</h1>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod GunjikarThis module is contained in the <code>mod_log_agent.c</code> file, and is not
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikarcompiled in by default. It provides for logging of the client user agents.
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<ul>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<li><A HREF="#agentlog">AgentLog</A>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar</ul>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<hr>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<A name="agentlog"><h2>AgentLog</h2></A>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<!--%plaintext &lt;?INDEX {\tt AgentLog} directive&gt; -->
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<strong>Syntax:</strong> AgentLog <em>file-pipe</em><br>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<strong>Default:</strong> <code>AgentLog logs/agent_log</code><br>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<Strong>Context:</strong> server config, virtual host<br>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<strong>Status:</strong> Extension<br>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<strong>Module:</strong> mod_log_agent<p>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod GunjikarThe AgentLog directive sets the name of the file to which the server will
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikarlog the UserAgent header of incoming requests. <em>File-pipe</em> is one
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikarof
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<dl><dt>A filename
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<dd>A filename relative to the <A HREF="core.html#serverroot">ServerRoot</A>.
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<dt> `|' followed by a command
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<dd>A program to receive the agent log information on its standard input.
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod GunjikarNote the a new program will not be started for a VirtualHost if it inherits
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikarthe AgentLog from the main server.
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar</dl>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<strong>Security:</strong> if a program is used, then it will be
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikarrun under the user who started httpd. This will be root if the server
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikarwas started by root; be sure that the program is secure.<p>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<strong>Security:</strong> See the <A
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod GunjikarHREF="/misc/security_tips.html">security tips</A> document for
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikardetails on why your security could be compromised if the directory
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikarwhere logfiles are stored is writable by anyone other than the user
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikarthat starts the server.<P>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod GunjikarThis directive is provided for compatibility with NCSA 1.4.<p>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar<!--#include virtual="footer.html" -->
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar</BODY>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar</HTML>
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar
c39526b769298791ff5b0b6c5e761f49aabaeb4ePramod Gunjikar