# Module mod_log_common

This module is contained in the `mod_log_common.c` file, and is compiled in by default. It provides for logging of the requests made to the server using the Common Logfile Format.

## Log file format

The log file contains a separate line for each request. A line is composed of several tokens separated by spaces:

> host ident authuser date request status bytes

If a token does not have a value then it is represented by a hyphen (-). The meanings and values of these tokens are as follows:

host
  The fully-qualified domain name of the client, or its IP number if the name is not available.
ident
  If IdentityCheck is enabled and the client machine runs identd, then this is the identity information reported by the client.
authuser
  If the request was for an password protected document, then this is the userid used in the request.
date
  The date and time of the request, in the following format:

    > `date = [day/month/year:hour:minute:second zone]
    > day = 2*digit
    > month = 3*letter
    > year = 4*digit
    > hour = 2*digit
    > minute = 2*digit
    > second = 2*digit
    > zone = (`+' | `-') 4*digit`

request
  The request line from the client, enclosed in double quotes (`"`).
status
  The three digit status code returned to the client.
bytes
  The number of bytes in the object returned to the client, not including any headers.

## Directives

- TransferLog

## TransferLog

Syntax: TransferLog file-pipe
Default: `TransferLog logs/transfer_log`
Context: server config, virtual host
Status: Base
Module: mod_log_common

The TransferLog directive sets the name of the file to which the server will log the incoming requests. File-pipe is one of

A filename
  A filename relative to the ServerRoot.
`|' followed by a command
  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 TransferLog from the main server.

Security: 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.