AgentLog directive

Purpose

The AgentLog directive tells HTTPd where to record client agent software. The UserAgent header, if present, is recorded in the format sent by the client.

This is for statistical purposes and the tracing of protocol violations. It should be included by all clients. The first white space delimited word must be the software product name, with an optional slash and version designator. Other products which form part of the user agent may be put as separate words.

A User Agent Example

NCSA Mosaic for the X Window System/2.5 libwww/2.12 modified

Syntax

AgentLog file

file is the name of the file to which user agents will be logged. It is either a full pathname, or a partial pathname relative to ServerRoot.

Only one AgentLog directive is allowed in the configuration file.

Default

If you do not specify an AgentLog, HTTPd assumes:

AgentLog logs/agent_log

Examples

AgentLog logs/agents

This logs user agents to the file logs/agents in the ServerRoot directory.

AgentLog /tmp/httpd-agents

This logs user agents to the file /tmp/httpd-agents.

AgentLog /dev/null

This effectively turns off agent logging.

[Back] Return to Server Configuration File Overview
NCSA HTTPd Development Team / httpd@ncsa.uiuc.edu / Last Modified 7-12-95