DragonFly On-Line Manual Pages

Search: Section:  

HTTPLOG(8)                          httplog                         HTTPLOG(8)


HTTPLOG

       httplog - Apache webserver logfile rollover program


SYNOPSIS

       httplog [-z] [-u USER] [-g GROUP] [-s SYMLINK] [-b BUFFER_SIZE] LOGFILE


DESCRIPTION

       This program makes Apache act similar to Microsofts' IIS webserver in
       its logging style (as opposed to every logfile entry in one single huge
       logfile).  This allows you to easily maintain your webserver logfiles
       for statistics packages in an easily organizable manner without user
       intervention.


USAGE

       It takes one argument at the command line, the path to a logfile as a
       template.  The template pathname can use any valid special characters
       permitted in strftime(3).  Other optional arguments can be appended to
       the command line.

       Optional filename parsing flags that may be used alongside the
       strftime(3) flags are:

       %1     replaced with systems host name.

       %2     replaced with systems domain name.

       %3     replaced with systems fully qualified name.


OPTIONS

       -h     output short help message and exit.

       -z     Compress logfiles with zlib once logfile rollover period hits
              and new logfile is generated.

       -u USER
              Run as specified user rather than current user (typically root).

       -g GROUP
              Run as specified group rather than current group (typically
              root).

       -s SYMLINK
              Create a symlink to the currently active logfile.  This symlink
              does not have to be in the same directory as the currently
              active logfile, and % expandoes do not expand in the symlink
              filename.

       -b BUFFER_SIZE
              Use specified buffer size to buffer logfile data rather than
              default buffer size defined by your system at compile time by
              BUFSIZ.  This option also changes buffer flush style from line
              buffer mode to full buffer mode.


REQUIRES

       You must have Apache installed.  This program has not been tested with
       any other webserver software.
       To be able to use the -z option, you must have zlib installed on your
       system before compiling httplog.


EXAMPLES

       CustomLog "|/usr/local/sbin/httplog /var/log/http/%m%d%Y.log -s
       /var/log/http/access.log" combined
       CustomLog "|/usr/local/sbin/httplog -z -u http -g users
       /var/log/http/%b/%m%d%Y.log" combined
       CustomLog "|/usr/local/sbin/httplog /var/log/http/%b/%m%d%y.log"
       combined
       CustomLog "|/usr/local/sbin/httplog /var/log/%D/referrer.log" referrer


FILES

       httpd.conf Apache configuration file, see httpd(8)


SEE ALSO

       httpd(8),


AUTHOR

       Eli Sand <nutbar@innocent.com>
       http://nutbar.chemlab.org/

Apache Tools                    August 8, 2001                      HTTPLOG(8)

Search: Section: