webalizer(1) The Webalizer webalizer(1)NAME
webalizer - A web server log file analysis tool.
SYNOPSIS
webalizer [ option ... ] [ log-file ]
webazolver [ option ... ] [ log-file ]
DESCRIPTION
The Webalizer is a web server 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).
The Webalizer supports CLF (common log format) log files, as well as
Combined log formats as defined by NCSA and others, and variations of
these which it attempts to handle intelligently. In addition, the
Webalizer supports xferlog formatted (FTP) log files, squid proxy logs
and W3C extended format logs. Logs may also be compressed, via gzip
(.gz) or, if enabled at compile time, bzip2 (.bz2). If a compressed
log file is detected, it will be automatically uncompressed while it is
read. Compressed logs must have the standard gzip extension of .gz or
bzip2 extension of .bz2.
webazolver is normally just a symbolic link to the Webalizer. When run
as webazolver, 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. In addition,
a DNS cache file must be specified. If the number of DNS children pro‐
cesses to use are not specified, the webazolver will default to 5.
This documentation applies to The Webalizer Version 2.23
RUNNING THE WEBALIZER
The Webalizer was designed to be run from a Unix command line prompt or
as a crond(8) job. Once executed, the general flow of the program is:
o A default configuration file is scanned for. A file named
webalizer.conf is searched for in the current directory, and if
found, it's configuration data is parsed. If the file is not
present in the current directory, the file
/usr/local/etc/webalizer.conf is searched for and, if found, is
used instead.
o Any command line arguments given to the program are parsed.
This may include the specification of a configuration file,
which is processed at the time it is encountered.
o If a log file was specified, it is opened and made ready for
processing. If no log file was given, STDIN is used for input.
If the log filename '-' is specified, STDIN will be forced.
o If an output directory was specified, the program does a
chdir(2) to that directory in preparation for generating out‐
put. If no output directory was given, the current directory
is used.
o If a non-zero number of DNS Children processes were specified,
they will be started, and the specified log file will be pro‐
cessed, creating or updating the specified DNS cache file.
o If no hostname was given, the program attempts to get the host‐
name using a uname(2) system call. If that fails, localhost is
used.
o A history file is searched for in the current directory (output
directory) and read if found. This file keeps totals for pre‐
vious months, which is used in the main index.html HTML docu‐
ment. Note: The file location can now be specified with the
HistoryName configuration option.
o If incremental processing was specified, a data file is
searched for and loaded if found, containing the 'internal
state' data of the program at the end of a previous run. Note:
The file location can now be specified with the IncrementalName
configuration option.
o Main processing begins on the log file. If the log spans mul‐
tiple months, a separate HTML document is created for each
month.
o After main processing, the main index.html page is created,
which has totals by month and links to each months HTML docu‐
ment.
o A new history file is saved to disk, which includes totals gen‐
erated by The Webalizer during the current run.
o If incremental processing was specified, a data file is written
that contains the 'internal state' data at the end of this run.
INCREMENTAL PROCESSING
The Webalizer supports incremental run capability. Simply put, this
allows processing large log files by breaking them up into smaller
pieces, and processing these pieces instead. What this means in real
terms is that you can now rotate your log files as often as you want,
and still be able to produce monthly usage statistics without the loss
of any detail. Basically, The Webalizer saves and restores all inter‐
nal data in a file named webalizer.current. This allows the program to
'start where it left off' so to speak, and allows the preservation of
detail from one run to the next. The data file is placed in the cur‐
rent output directory, and is a plain ASCII text file that can be
viewed with any standard text editor. It's location and name may be
changed using the IncrementalName configuration keyword.
Some special precautions need to be taken when using the incremental
run capability of The Webalizer. Configuration options should not be
changed between runs, as that could cause corruption of the internal
data stored. For example, changing the MangleAgents level will cause
different representations of user agents to be stored, producing
invalid results in the user agents section of the report. If you need
to change configuration options, do it at the end of the month after
normal processing of the previous month and before processing the cur‐
rent month. You may also want to delete the webalizer.current file as
well.
The Webalizer also attempts to prevent data duplication by keeping
track of the timestamp of the last record processed. This timestamp is
then compared to current records being processed, and any records that
were logged previous to that timestamp are ignored. This, in theory,
should allow you to re-process logs that have already been processed,
or process logs that contain a mix of processed/not yet processed
records, and not produce duplication of statistics. The only time this
may break is if you have duplicate timestamps in two separate log
files... any records in the second log file that do have the same time‐
stamp as the last record in the previous log file processed, will be
discarded as if they had already been processed. There are lots of
ways to prevent this however, for example, stopping the web server
before rotating logs will prevent this situation. This setup also
necessitates that you always process logs in chronological order, oth‐
erwise data loss will occur as a result of the timestamp compare.
REVERSE DNS LOOKUPS
The Webalizer fully supports IPv4 and IPv6 DNS lookups, and maintains a
cache of those lookups to reduce processing the same addresses in sub‐
sequent runs. The cache file can be created at run-time, or may be
created before running the webalizer using either the stand alone
'webazolver' program, or The Webalizer (DNS) Cache file manager program
'wcmgr'. In order to perform reverse lookups, a DNSCache file must be
specified, either on the command line or in a configuration file. In
order to create/update the cache file at run-time, the number of
DNSChildren must also be specified, and can be anything between 1 and
100. This specifies the number of child processes to be forked, each
of which will perform network DNS queries in order to lookup up the
addresses and update the cache. Cached entries that are older than a
specified TTL (time to live) will be expired, and if encountered again
in a log, will be looked up at that time in order to 'freshen' them
(verify the name is still the same and update its timestamp). The
default TTL is 7 days, however may be set to anything between 1 and 100
days. Using the 'wcmgr' program, entries may also be marked as 'perma‐
nent', in which case they will persist (with an infinite TTL) in the
cache until manually removed. See the file DNS.README for additional
information and examples.
GEOLOCATION LOOKUPS
The Webalizer has the ability to perform geolocation lookups on IP
addresses using either it's own internal GeoDB database, or optionally
the GeoIP database from MaxMind, Inc. (www.maxmind.com). If used,
unresolved addresses will be searched for in the database and its coun‐
try of origin will be returned if found. This actually produces more
accurate Country information than DNS lookups, since the DNS address
space has additional gcTLDs that do not necessarily map to a specific
country (such as .net and .com). It is possible to use both DNS
lookups and geolocation lookups at the same time, which will cause any
addresses that could not be resolved using DNS lookups to then be
looked up in the database, greatly reducing the number of Unknown/Unre‐
solved entries in the generated reports. The native GeoDB geolocation
database provided by The Webalizer fully supports both IPv4 and IPv6
lookups, is updated regularly and is the preferred geolocation method
for use with The Webalizer. The most current version of the database
can be obtained from our ftp site (ftp://ftp.mrunix.net/).
COMMAND LINE OPTIONS
The Webalizer supports many different configuration options that will
alter the way the program behaves and generates output. Most of these
can be specified on the command line, while some can only be specified
in a configuration file. The command line options are listed below,
with references to the corresponding configuration file keywords.
General Options
-h Display all available command line options and exit program.
-v Be verbose. Will cause the program to output informational and
Debug messages at run-time.
-V Display the program version and exit. Additional program spe‐
cific information will be displayed if verbose mode is also
used (e.g. '-vV'), which can be useful when submitting bug
reports.
-d Debug. Display debugging information for errors and warnings.
-i IgnoreHist. Ignore history. USE WITH CAUTION. This will cause
The Webalizer to ignore any previous monthly history file only.
Incremental data (if present) is still processed.
-b IgnoreState. Ignore incremental data file. USE WITH CAUTION.
This will cause The Webalizer to ignore any existing incremen‐
tal data file. By ignoring the incremental data file, all pre‐
vious processing for the current month will be lost and those
logs must be re-processed.
-p Incremental. Preserve internal data between runs.
-q Quiet. Suppress informational messages. Does not suppress
warnings or errors.
-Q ReallyQuiet. Suppress all messages including warnings and
errors.
-T TimeMe. Force display of timing information at end of process‐
ing.
-c file Use configuration file file.
-n name HostName. Use the hostname name.
-o dir OutputDir. Use output directory dir.
-t name ReportTitle. Use name for report title.
-F ( clf | ftp | squid | w3c )
LogType. Specify log type to be processed. Value can be
either clf, ftp, squid or w3c format. If not specified, will
default to CLF format. FTP logs must be in standard wu-ftpd
xferlog format.
-f FoldSeqErr. Fold out of sequence log records back into analy‐
sis, by treating as if they were the same date/time as the last
good record. Normally, out of sequence log records are simply
ignored.
-Y CountryGraph. Suppress country graph.
-G HourlyGraph. Suppress hourly graph.
-x name HTMLExtension. Defines HTML file extension to use. If not
specified, defaults to html. Do not include the leading
period.
-H HourlyStats. Suppress hourly statistics.
-K num IndexMonths. Specify how many months should be displayed in
the main index (yearly summary) table. Default is 12 months.
Can be set to anything between 12 and 120 months (1 to 10
years).
-k num GraphMonths. Specify how many months should be displayed in
the main index (yearly summary) graph. Default is 12 months.
Can be set to anything between 12 and 72 months (1 to 6 years).
-L GraphLegend. Suppress color coded graph legends.
-l num GraphLines. Specify number of background lines. Default is 2.
Use zero ('0') to disable the lines.
-P name PageType. Specify file extensions that are considered pages.
Sometimes referred to as pageviews.
-O name OmitPage. Specify URLs to exclude from being counted as pages.
-m num VisitTimeout. Specify the Visit timeout period. Specified in
number of seconds. Default is 1800 seconds (30 minutes).
-I name IndexAlias. Use the filename name as an additional alias for
index..
-M num MangleAgents. Mangle user agent names according to the mangle
level specified by num. Mangle levels are:
5 Browser name and major version.
4 Browser name, major and minor version.
3 Browser name, major version, minor version to two
decimal places.
2 Browser name, major and minor versions and sub-ver‐
sion.
1 Browser name, version and machine type if possible.
0 All information (left unchanged).
-g num GroupDomains. Automatically group sites by domain. The group‐
ing level specified by num can be thought of as 'the number of
dots' to display in the grouping. The default value of 0 dis‐
ables any domain grouping.
-D name DNSCache. Use the DNS cache file name.
-N num DNSChildren. Use num DNS children processes to perform DNS
lookups, either creating or updating the DNS cache file. Spec‐
ify zero (0) to disable cache file creation/updates. If given,
a DNS cache filename must be specified.
-j Enable GeoDB. This enables the internal GeoDB geolocation ser‐
vices provided by The Webalizer.
-J name GeoDBDatabase. Use the alternate GeoDB database name.
-w Enable GeoIP. Enables GeoIP (by MaxMind Inc.) geolocation ser‐
vices. If native GeoDB services are also enabled, then this
option will have no effect.
-W name GeoIPDatabase. Use the alternate GeoIP database name.
-z name FlagDir. Specify location of the country flag graphics and
enable their display in the top country table. The directory
name is relative to the output directory being used unless an
absolute path is given (ie: starts with a leading '/').
Hide Options
-a name HideAgent. Hide user agents matching name.
-r name HideReferrer. Hide referrer matching name.
-s name HideSite. Hide site matching name.
-X HideAllSites. Hide all individual sites (only display groups).
-u name HideURL. Hide URL matching name.
Table size options
-A num TopAgents. Display the top num user agents table.
-R num TopReferrers. Display the top num referrers table.
-S num TopSites. Display the top num sites table.
-U num TopURLs. Display the top num URLs table.
-C num TopCountries. Display the top num countries table.
-e num TopEntry. Display the top num entry pages table.
-E num TopExit. Display the top num exit pages table.
CONFIGURATION FILES
Configuration files are standard ASCII(7) text files that may be cre‐
ated or edited using any standard editor. Blank lines and lines that
begin with a pound sign ('#') are ignored. Any other lines are consid‐
ered to be configuration lines, and have the form "Keyword Value",
where the ´Keyword´ is one of the currently available configuration
keywords defined below, and 'Value' is the value to assign to that par‐
ticular option. Any text found after the keyword up to the end of the
line is considered the keyword's value, so you should not include any‐
thing after the actual value on the line that is not actually part of
the value being assigned. The file sample.conf provided with the dis‐
tribution contains lots of useful documentation and examples as well.
General Configuration Keywords
LogFile name
Use log file named name. If none specified, STDIN will be
used.
LogType name
Specify log file type as name. Values can be either clf, squid,
ftp or w3c, with the default being clf.
OutputDir dir
Create output in the directory dir. If none specified, the
current directory will be used.
HistoryName name
Filename to use for history file. Relative to output directory
unless absolute name is given (ie: starts with '/'). Defaults
to ´webalizer.hist' in the standard output directory.
ReportTitle name
Use the title string name for the report title. If none speci‐
fied, use the default of (in english) "Usage Statistics for ".
HostName name
Set the hostname for the report as name. If none specified, an
attempt will be made to gather the hostname via a uname(2) sys‐
tem call. If that fails, localhost will be used.
UseHTTPS ( yes | no )
Use https:// on links to URLS, instead of the default http://,
in the 'Top URLs' table.
HTAccess ( yes | no )
Enables the creation of a default .htaccess file in the output
directory.
Quiet ( yes | no )
Suppress informational messages. Warning and Error messages
will not be suppressed.
ReallyQuiet ( yes | no )
Suppress all messages, including Warning and Error messages.
Debug ( yes | no )
Print extra debugging information on Warnings and Errors.
TimeMe ( yes | no )
Force timing information at end of processing.
GMTTime ( yes | no )
Use GMT (UTC) time instead of local timezone for reports.
IgnoreHist ( yes | no )
Ignore previous monthly history file. USE WITH CAUTION. Does
not prevent Incremental file processing.
IgnoreState ( yes | no )
Ignore incremental data file. USE WITH CAUTION. By ignoring
the incremental data file, all previous processing for the cur‐
rent month will be lost and those logs must be re-processed.
FoldSeqErr ( yes | no )
Fold out of sequence log records back into analysis by treating
them as if they had the same date/time as the last good record.
Normally, out of sequence log records are ignored.
CountryGraph ( yes | no )
Display Country Usage Graph in output report.
CountryFlags ( yes | no )
Enable or disable the display of flags in the top country ta‐
ble.
FlagDir name
Specifies the directory name where the flag graphics are
located. If not specified, the default is in the flags direc‐
tory directly under the output directory being used. If speci‐
fied, the display of country flags will be enabled by default.
Using 'FlagDir flags' is identical to using 'CountryFlags yes'.
DailyGraph ( yes | no )
Display Daily Graph in output report.
DailyStats ( yes | no )
Display Daily Statistics in output report.
HourlyGraph ( yes | no )
Display Hourly Graph in output report.
HourlyStats ( yes | no )
Display Hourly Statistics in output report.
PageType name
Define the file extensions to consider as a page. If a file is
found to have the same extension as name, it will be counted as
a page (sometimes called a pageview).
PagePrefix name
Allows URLs with the prefix name to be counted as a page type
regardless of actual file type. This allows you to treat con‐
tents under specified directories as pages no matter what their
extension is.
OmitPage name
Specifies URLs which should not be counted as pages, regardless
of their extension (or lack thereof).
GraphLegend ( yes | no )
Allows the color coded graph legends to be enabled/disabled.
GraphLines num
Specify the number of background reference lines displayed on
the graphs produced. Disable by using zero ('0'), default is
2.
IndexMonths num
Specify the number of months to display in the main index
(yearly summary) table. Default is 12 months. Can be set to
anything between 12 and 120 months (1 to 10 years).
YearHeaders ( yes | no )
Enable/disable the display of year headers in the main index
(yearly summary) table. If enabled, year headers will be shown
when the table is displaying more than 16 months worth of data.
Values can be 'yes' or 'no'. Default is 'yes'.
YearTotals ( yes | no )
Enable/disable the display of year totals in the main index
(yearly summary) table. If enabled, year totals will be shown
when the table is displaying more than 16 months worth of data.
Values can be 'yes' or 'no'. Default is 'yes'.
GraphMonths num
Specify the number of months to display in the main index
(yearly summary) graph. Default is 12 months. Can be set to
anything between 12 and 72 months (1 to 6 years).
VisitTimeout num
Specifies the visit timeout value. Default is 1800 seconds (30
minutes). A visit is determined by looking at the difference
in time between the current and last request from a specific
site. If the difference is greater or equal to the timeout
value, the request is counted as a new visit. Specified in
seconds.
IndexAlias name
Use name as an additional alias for index.*.
DefaultIndex ( yes | no )
Enables or disables the use of 'index.' as a default index name
to be stripped from the end of URLs. This does not effect any
index names that may be defined with the IndexAlias option.
MangleAgents num
Mangle user agent names based on mangle level num. See the -M
command line switch for mangle levels and their meaning. The
default is 0, which doesn't mangle user agents at all.
StripCGI ( yes | no )
Determines if URL CGI variables should be stripped from the end
of URLs. Values may be 'yes' or 'no', with the default being
'yes'.
TrimSquidURL num
Allows squid log URLs to be reduced in granularity by truncat‐
ing them after num slashes ('/') after the http:// prefix. A
setting of one (1) will cause all URLs to be summarized by
domain only. The default value is zero (0), which will disable
any URL modifications and leave them exactly as found in the
log file.
SearchEngine name variable
Allows the specification of search engines and their query
strings. The name is the name to match against the referrer
string for a given search engine. The variable is the cgi
variable that the search engine uses for queries. See the sam‐
ple.conf file for example usage with common search engines.
SearchCaseI ( yes | no )
Determines if search strings should be treated case insensitive
or not. The default is 'yes', which lowercases all search
strings (treat as case insensitive).
Incremental ( yes | no )
Enable Incremental mode processing.
IncrementalName name
Filename to use for incremental data. Relative to output
directory unless an absolute name is given (ie: starts with
'/'). Defaults to ´webalizer.current' in the standard output
directory.
DNSCache name
Filename to use for the DNS cache. Relative to output direc‐
tory unless an absolute name is given (ie: starts with '/').
DNSChildren num
Number of children DNS processes to run in order to cre‐
ate/update the DNS cache file. Specify zero (0) to disable.
CacheIPs ( yes | no )
Cache unresolved IP addresses in the DNS database. Default is
'no'.
CacheTTL num
DNS cache entry time to live (TTL) in days. Default is 7 days.
May be any value between 1 and 100.
GeoDB ( yes | no )
Allows native GeoDB geolocation services to be enabled or dis‐
abled. Default value is 'no'.
GeoDBDatabase name
Allows the use of an alternate GeoDB database name. If not
specified, the default database will be used.
GeoIP ( yes | no )
Allows GeoIP (by MaxMind Inc.) geolocation services to be
enabled or disabled. Default is 'no'. If native GeoDB geolo‐
cation services are also enabled, then this option will have no
effect (and the native GeoDB services will be used).
GeoIPDatabase name
Allows the use of an alternate GeoIP database name. If not
specified, the default database will be used.
Top Table Keywords
TopAgents num
Display the top num User Agents table. Use zero to disable.
AllAgents ( yes | no )
Create separate HTML page with All User Agents.
TopReferrers num
Display the top num Referrers table. Use zero to disable.
AllReferrers ( yes | no )
Create separate HTML page with All Referrers.
TopSites num
Display the top num Sites table. Use zero to disable.
TopKSites num
Display the top num Sites (by KByte) table. Use zero to dis‐
able.
AllSites ( yes | no )
Create separate HTML page with All Sites.
TopURLs num
Display the top num URLs table. Use zero to disable.
TopKURLs num
Display the top num URLs (by KByte) table. Use zero to dis‐
able.
AllURLs ( yes | no )
Create separate HTML page with All URLs.
TopCountries num
Display the top num Countries in the table. Use zero to dis‐
able.
TopEntry num
Display the top num Entry Pages in the table. Use zero to dis‐
able.
TopExit num
Display the top num Exit Pages in the table. Use zero to dis‐
able.
TopSearch num
Display the top num Search Strings in the table. Use zero to
disable.
AllSearchStr ( yes | no )
Create separate HTML page with All Search Strings.
TopUsers num
Display the top num Usernames in the table. Use zero to dis‐
able. Usernames are only available if using http based authen‐
tication.
AllUsers ( yes | no )
Create separate HTML page with All Usernames.
Hide/Ignore/Group/Include Keywords
HideAgent name
Hide User Agents that match name.
HideReferrer name
Hide Referrers that match name.
HideSite name
Hide Sites that match name.
HideAllSites ( yes | no )
Hide all individual sites. This causes only grouped sites to
be displayed.
HideURL name
Hide URLs that match name.
HideUser name
Hide Usernames that match name.
IgnoreAgent name
Ignore User Agents that match name.
IgnoreReferrer name
Ignore Referrers that match name.
IgnoreSite name
Ignore Sites that match name.
IgnoreURL name
Ignore URLs that match name.
IgnoreUser name
Ignore Usernames that match name.
GroupAgent name [Label]
Group User Agents that match name. Display Label in 'Top
Agent' table if given (instead of name). name may be enclosed
in quotes.
GroupReferrer name [Label]
Group Referrers that match name. Display Label in 'Top Refer‐
rer' table if given (instead of name). name may be enclosed in
quotes.
GroupSite name [Label]
Group Sites that match name. Display Label in 'Top Site' table
if given (instead of name). name may be enclosed in quotes.
GroupDomains num
Automatically group sites by domain. The value num specifies
the level of grouping, and can be thought of as the 'number of
dots' to be displayed. The default value of 0 disables domain
grouping.
GroupURL name [Label]
Group URLs that match name. Display Label in 'Top URL' table
if given (instead of name). name may be enclosed in quotes.
GroupUser name [Label]
Group Usernames that match name. Display Label in 'Top User‐
names' table if given (instead of name). name may be enclosed
in quotes.
IncludeSite name
Force inclusion of sites that match name. Takes precedence
over Ignore* keywords.
IncludeURL name
Force inclusion of URLs that match name. Takes precedence over
Ignore* keywords.
IncludeReferrer name
Force inclusion of Referrers that match name. Takes precedence
over Ignore* keywords.
IncludeAgent name
Force inclusion of User Agents that match name. Takes prece‐
dence over Ignore* keywords.
IncludeUser name
Force inclusion of Usernames that match name. Takes precedence
over Ignore* keywords.
HTML Generation Keywords
HTMLExtension text
Defines the HTML file extension to use. Default is html. Do
not include the leading period!
HTMLPre text
Insert text at the very beginning of the generated HTML file.
Defaults to a standard html 3.2 DOCTYPE record.
HTMLHead text
Insert text within the <HEAD></HEAD> block of the HTML file.
HTMLBody text
Insert text in HTML page, starting with the <BODY> tag. If
used, the first line must be a <BODY ...> tag. Multiple lines
may be specified.
HTMLPost text
Insert text at top (before horiz. rule) of HTML pages. Multi‐
ple lines may be specified.
HTMLTail text
Insert text at bottom of the HTML page. The text is top and
right aligned within a table column at the end of the report.
HTMLEnd text
Insert text at the very end of the HTML page. If not speci‐
fied, the default is to insert the ending </BODY> and </HTML>
tags. If used, you must supply these tags yourself.
LinkReferrer ( yes | no )
Determines if the referrers listed in the top referrers table
should be displayed as plain text, or as a link to the referrer
URL.
ColorHit ( rrggbb | 00805c )
Sets the graph's hit-color to the specified html color (no
'#').
ColorFile ( rrggbb | 0040ff )
Sets the graph's file-color to the specified html color (no
'#').
ColorSite ( rrggbb | ff8000 )
Sets the graph's site-color to the specified html color (no
'#').
ColorKbyte ( rrggbb | ff0000 )
Sets the graph's kilobyte-color to the specified html color (no
'#').
ColorPage ( rrggbb | 00e0ff )
Sets the graph's page-color to the specified html color (no
'#').
ColorVisit ( rrggbb | ffff00 )
Sets the graph's visit-color to the specified html color (no
'#').
ColorMisc ( rrggbb | 00e0ff )
Sets the 'miscellaneous' color for table headers (not graphs)
to the specified html color (no '#').
PieColor1 ( rrggbb | 800080 )
Sets the pie's first optional color to the specified html color
(no '#').
PieColor2 ( rrggbb | 80ffc0 )
Sets the pie's second optional color to the specified html
color (no '#').
PieColor3 ( rrggbb | ff00ff )
Sets the pie's third optional color to the specified html color
(no '#').
PieColor4 ( rrggbb | ffc480 )
Sets the pie's fourth optional color to the specified html
color (no '#').
Dump Object Keywords
The Webalizer allows you to export processed data to other programs by
using tab delimited text files. The Dump* commands specify which files
are to be written, and where.
DumpPath name
Save dump files in directory name. If not specified, the
default output directory will be used. Do not specify a trail‐
ing slash ('/').
DumpExtension name
Use name as the filename extension for dump files. If not
given, the default of tab will be used.
DumpHeader ( yes | no )
Print a column header as the first record of the file.
DumpSites ( yes | no )
Dump the sites data to a tab delimited file.
DumpURLs ( yes | no )
Dump the url data to a tab delimited file.
DumpReferrers ( yes | no )
Dump the referrer data to a tab delimited file. This data is
only available if using a log that contains referrer informa‐
tion (ie: a combined format web log).
DumpAgents ( yes | no )
Dump the user agent data to a tab delimited file. This data is
only available if using a log that contains user agent informa‐
tion (ie: a combined format web log).
DumpUsers ( yes | no )
Dump the username data to a tab delimited file. This data is
only available if processing a wu-ftpd xferlog or a web log
that contains http authentication information.
DumpSearchStr ( yes | no )
Dump the search string data to a tab delimited file. This data
is only available if processing a web log that contains refer‐
rer information and had search string information present.
FILES
webalizer.conf Default configuration file. Is searched for in the
current directory and if not found, in the
/usr/local/etc/ directory.
webalizer.hist Monthly history file for previous months. (can be
changed)
webalizer.current Current state data file (Incremental processing).
(can be changed)
xxxxx_YYYYMM.html Various monthly HTML output files produced. (exten‐
sion can be changed)
xxxxx_YYYYMM.png Various monthly image files used in the reports.
xxxxx_YYYYMM.tab Monthly tab delimited text files. (extension can
be changed)
BUGS
Please report bugs to the author.
COPYRIGHT
Copyright (C) 1997-2013 by Bradford L. Barrett. Distributed under the
GNU GPL. See the files "COPYING" and "Copyright", supplied with all
distributions for additional information.
AUTHOR
Bradford L. Barrett <brad at mrunix dot net>
Version 2.23 26-Feb-2013 webalizer(1)
