Return to accesslog.txt CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / lighttpd / doc / outdated

Annotation of embedaddon/lighttpd/doc/outdated/accesslog.txt, revision 1.1

1.1     ! misho       1: =========
        !             2: Accesslog
        !             3: =========
        !             4: 
        !             5: ---------------------
        !             6: Module: mod_accesslog
        !             7: ---------------------
        !             8: 
        !             9: :Author: Jan Kneschke
        !            10: :Date: $Date: 2004/11/03 22:26:05 $
        !            11: :Revision: $Revision: 1.2 $
        !            12: 
        !            13: :abstract:
        !            14:   The accesslog module ...
        !            15: 
        !            16: .. meta::
        !            17:   :keywords: lighttpd, accesslog, CLF
        !            18: 
        !            19: .. contents:: Table of Contents
        !            20: 
        !            21: Description
        !            22: ===========
        !            23: 
        !            24: CLF like by default, flexible like apache
        !            25: 
        !            26: Options
        !            27: =======
        !            28: 
        !            29: accesslog.use-syslog
        !            30:   send the accesslog to syslog
        !            31: 
        !            32:   Default: disabled
        !            33: 
        !            34: accesslog.filename
        !            35:   name of the file where the accesslog should be written too if syslog
        !            36:   is not used.
        !            37: 
        !            38:   if the name starts with a '|' the rest of the name is taken
        !            39:   as the name of a process which will be spawn and will get the
        !            40:   output
        !            41: 
        !            42:   e.g.: ::
        !            43: 
        !            44:     accesslog.filename = "/var/log/lighttpd.log"
        !            45: 
        !            46:     $HTTP["host"] == "mail.example.org" {
        !            47:       accesslog.filename = "|/usr/bin/cronolog"
        !            48:     }
        !            49: 
        !            50:   Default: disabled
        !            51: 
        !            52: accesslog.format
        !            53:   the format of the logfile
        !            54: 
        !            55:   ====== ================================
        !            56:   Option Description
        !            57:   ====== ================================
        !            58:   %%     a percent sign
        !            59:   %h     name or address of remote-host
        !            60:   %l     ident name (not supported)
        !            61:   %u     authenticated user
        !            62:   %t     timestamp for the request-start
        !            63:   %r     request-line
        !            64:   %s     status code
        !            65:   %b     bytes sent for the body
        !            66:   %i     HTTP-header field
        !            67:   %a     remote address
        !            68:   %A     local address
        !            69:   %B     same as %b
        !            70:   %C     cookie field (not supported)
        !            71:   %D     time used in ms (not supported)
        !            72:   %e     environment (not supported)
        !            73:   %f     phyiscal filename
        !            74:   %H     request protocol (HTTP/1.0, ...)
        !            75:   %m     request method (GET, POST, ...)
        !            76:   %n     (not supported)
        !            77:   %o     `response header`_
        !            78:   %p     server port
        !            79:   %P     (not supported)
        !            80:   %q     query string
        !            81:   %T     time used in seconds
        !            82:   %U     request URL
        !            83:   %v     server-name
        !            84:   %V     (not supported)
        !            85:   %X     connection status
        !            86:   %I     bytes incomming
        !            87:   %O     bytes outgoing
        !            88:   ====== ================================
        !            89: 
        !            90:   If %s is written %>s or %<s the < and the > are ignored. They are support
        !            91:   for compat with apache.
        !            92: 
        !            93:   %i and %o expect the name of the field which should be written in curly brackets.
        !            94: 
        !            95:   e.g.: ::
        !            96: 
        !            97:     accesslog.format = "%h %l %u %t \"%r\" %b %>s \"%{User-Agent}i\" \"%{Referer}i\""
        !            98: 
        !            99:   Default: CLF compatible output
        !           100: 
        !           101: Response Header
        !           102: ---------------
        !           103: 
        !           104: The accesslog module provides a special way to log content from the
        !           105: application in a accesslog file. It can be used to log the session id into a
        !           106: logfile.
        !           107: 
        !           108: If you want to log it into the accesslog just specify the field-name within
        !           109: a %{...}o like ::
        !           110: 
        !           111:   accesslog.format = "%h %l %u %t \"%r\" %b %>s \"%{User-Agent}i\" \"%{Referer}i\" \"%{X-LIGHTTPD-SID}o\""
        !           112: 
        !           113: The prefix ``X-LIGHTTPD-`` is special as every response header starting with
        !           114: this prefix is assumed to be special for lighttpd and won't be sent out
        !           115: to the client.
        !           116: 
        !           117: An example the use this functionality is provided below: ::
        !           118: 
        !           119:   <?php
        !           120: 
        !           121:   session_start();
        !           122: 
        !           123:   header("X-LIGHTTPD-SID: ".session_id());
        !           124: 
        !           125:   ?>
        !           126: