.TH webdruid 1 "22-Jun-2004" "Version 0.5.4" "The WebDruid"
.SH NAME
webdruid - A web site log file analysis tool.
.SH SYNOPSIS
.B webdruid
[\fI option ... \fP] [\fI log-file1 \fP] [\fI log-file2 \fP] ...
.PP
.B webdruid-resolve
[\fI option ... \fP] [\fI log-file1 \fP] [\fI log-file2 \fP] ...
.PP
.SH DESCRIPTION
\fIThe WebDruid\fP is a web site log file analysis program which produces
usage statistics in HTML format for viewing with a browser.  The results
are presented in both columnar and graphical format, which facilitates
interpretation.  Yearly, monthly, daily and hourly usage statistics are
presented, along with the ability to display usage by site, URL, referrer,
user agent (browser), username, search strings, entry/exit pages,  and
country (some information may not be available if not present in the log
file being processed).
.PP
\fIThe WebDruid\fP supports \fBCLF\fP (common log format) log files,
as well as \fBCombined\fP log formats as defined by NCSA and others,
and variations of these which it attempts to handle intelligently.  In
addition, \fIthe WebDruid\fP also supports \fBW3C\fP
formatted log files, allowing it to parse IIS log files.
Logs may also be compressed, via \fBgzip\fP.
If a compressed log file is detected, it will be automatically uncompressed
while it is read.  Compressed logs must have the standard \fIgzip\fP
extension of \fB.gz\fP.
.PP
\fIThe WebDruid\fP, when used with the \fIgraphviz tools\fP, can produce path graphs
and users flow graphs. Path graph allows you to see the preferred path your
users take when browsing on your web site. Users flow will draw lines
between the urls, each line being balanced by the number of hits.
For more information see 'Using path & users flox graphs' in the README file.
.PP
\fIwebdruid-resolve\fP is normally just a symbolic link to \fIwebdruid\fP.
When run as \fIwebdruid-resolve\fP, only DNS file creation/updates are performed,
and the program will exit once complete.  All normal options and
configuration directives are available, however many will not be used.
.PP
\fIThe WebDruid\fP main documentation is located in the README file.
It contains instructions on operating with the software, as well as
a reference for all the /etc/webdruid/webdruid.conf config file directives,
and command line options.
.SH BUGS
Report bugs to \fIfabien@juliana-multimedia.com\fP.
.SH COPYRIGHT
Copyright (C) 2003-2004 by Fabien Chevalier.
.PP
Original Copyright (C) 1997-2000 by Bradford L. Barrett.
.PP
Distributed under the GNU GPL.  See the files "\fICOPYING\fP" and "\fICopyright\fP",
supplied with all distributions for additional information.
.SH AUTHOR
Fabien Chevalier <\fIfabien@juliana-multimedia.com\fP>