| <!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 <?INDEX {\tt AgentLog} directive> --> |
| <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> |
| |
