RefererLog Directive

Top - Docs - General - Server - Resource - Access - FAQ - Tutorials

Purpose

The RefererLog directive tells HTTPd where to record referers. The Referer header, if present, is recorded in the following format:

[Time Stamp] URI -> Document

Where URI is the Universal Resource Identifier for the document that references the server, and Document is the name of the file being refered to. This is a path relative to DocumentRoot. It is also possible to ignore logging certain referers by using the RefererIgnore directive.

This directive is non-functional under the Combined LogOption.

A Referer Example Log

[02/Oct/1995:13:03:29] http://www.webcrawler.com/cgi-bin/WebQuery -> /images/icon.gif
[02/Oct/1995:13:03:29] http://www.webcrawler.com/cgi-bin/WebQuery -> /images/back.gif
[02/Oct/1995:13:03:34] http://www.lysator.liu.se:7500/mud/faq/faq1.html -> /ftp/
[02/Oct/1995:13:04:25] http://rhine.ece.utexas.edu/~shishir/ -> /docs/tutorials/
[02/Oct/1995:13:04:30] http://humnet.humberc.on.ca/ -> /archie.html/

Syntax

RefererLog file

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

Virtual Host

This directive is valid in virtual host configuration.

Default

If you do not specify a RefererLog, HTTPd assumes:

RefererLog logs/referer_log

Compile Option: DEFAULT_REFERERLOG

Examples

RefererLog logs/referers

This logs referers to the file logs/referers in the ServerRoot directory.

RefererLog /tmp/httpd-referers

This logs referers to the file /tmp/httpd-referers.

RefererLog /dev/null

This effectively turns off referer logging.

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