![[APACHE DOCUMENTATION]](../images/sub.gif)
This module provides for logging of the requests made to the server, using the Common Log Format or a user-specified format.
Status: Base
Source File:
mod_log_config.c
Module Identifier:
config_log_module
Compatibility: Was an extension
module prior to Apache 1.2.
This module provides for flexible logging of client requests. Logs are written in a customizable format, and may be written directly to a file, or to an external program. Conditional logging is provided so that individual requests may be included or excluded from the logs based on characteristics of the request.
Three directives are provided by this module:
TransferLog to create a log file,
LogFormat to set a custom format, and
CustomLog to define a log file and format in one
step. The TransferLog and CustomLog
directives can be used multiple times in each server to cause
each request to be logged to multiple files.
See also: Apache Log Files.
The format argument to the LogFormat and
CustomLog directives is a string. This string is
used to log each request to the log file. It can contain literal
characters copied into the log files and the C-style control
characters "\n" and "\t" to represent new-lines and tabs.
Literal quotes and back-slashes should be escaped with
back-slashes.
The characteristics of the request itself are logged by
placing "%" directives in the format string, which are
replaced in the log entry by the values as follows:
%...a: Remote IP-address
%...A: Local IP-address
%...B: Bytes sent, excluding HTTP headers.
%...b: Bytes sent, excluding HTTP headers. In CLF format
i.e. a '-' rather than a 0 when no bytes are sent.
%...c: Connection status when response was completed.
'X' = connection aborted before the response completed.
'+' = connection may be kept alive after the response is sent.
'-' = connection will be closed after the response is sent.
%...{FOOBAR}e: The contents of the environment variable FOOBAR
%...f: Filename
%...h: Remote host
%...H The request protocol
%...{Foobar}i: The contents of Foobar: header line(s) in the request
sent to the server.
%...l: Remote logname (from identd, if supplied)
%...m The request method
%...{Foobar}n: The contents of note "Foobar" from another module.
%...{Foobar}o: The contents of Foobar: header line(s) in the reply.
%...p: The canonical Port of the server serving the request
%...P: The process ID of the child that serviced the request.
%...q The query string (prepended with a ? if a query string exists,
otherwise an empty string)
%...r: First line of request
%...s: Status. For requests that got internally redirected, this is
the status of the *original* request --- %...>="directive-dict.html#Override"
rel="Help">Override: FileInfo
Status: Base
Module: mod_actions
Compatibility: Action is only
available in Apache 1.1 and later
This directive adds an action, which will activate
cgi-script when action-type is triggered by the
request. The cgi-script is the URL-path to a resource that
has been configured as a CGI script using ScriptAlias
or AddHandler. The action-type can be either
a handler or a MIME content type. It
sends the URL and file path of the requested document using the
standard CGI PATH_INFO and PATH_TRANSLATED environment
variables.
Examples:
# Requests for files of a particular type:
Action image/gif /cgi-bin/images.cgi
# Files of a particular file extension
AddHandler my-file-type .xyz
Action my-file-type /cgi-bin/program.cgi
In the first example, requests for files with a MIME content
type of image/gif will instead be handled by the
specified cgi script /cgi-bin/images.cgi.
In the second example, requests for files with a file extension of
.xyz are handled instead by the specified cgi script
/cgi-bin/program.cgi.
See also: AddHandler
Script directive
Syntax: Script method
cgi-script
Context: server config, virtual
host, directory
Status: Base
Module: mod_actions
Compatibility: Script is only
available in Apache 1.1 and later; arbitrary method use is only
available with 1.3.10 and later
This directive adds an action, which will activate
cgi-script when a file is requested using the method of
method. The cgi-script is the URL-path to a resource
that has been configured as a CGI script using
ScriptAlias or AddHandler. The URL and
file path of the requested document is sent using the standard CGI
PATH_INFO and PATH_TRANSLATED environment variables.
Prior to Apache 1.3.10, method can only be one of
GET, POST, PUT, or
DELETE. As of 1.3.10, any arbitrary method name
may be used. Method names are case-sensitive, so
Script PUT and Script put
have two entirely different effects.
Note that the Script command defines default actions only.
If a CGI script is called, or some other resource that is
capable of handling the requested method internally, it will do
so. Also note that Script with a method of GET
will only be called if there are query arguments present
(e.g., foo.html?hi). Otherwise, the request will
proceed normally.
Examples:
# For <ISINDEX>-style searching
Script GET /cgi-bin/search
# A CGI PUT handler
Script PUT /~bob/put.cgi
Apache HTTP Server Version 1.3
