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	 strf‐
       time(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" com‐
       bined
       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)

Vote for polarhome