Provided by: webalizer_2.23.08-1_amd64 bug

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 processes 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 /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 output.  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 processed, creating or updating the specified DNS cache file.

       o       If no hostname was given, the program attempts to get the hostname 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 previous months, which is used in the main index.html  HTML  document.
               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  multiple  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 document.

       o       A new history file is saved to disk, which includes totals generated 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
       internal 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
       current 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 current 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 timestamp 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, otherwise 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 subsequent 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 'permanent', 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  country  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/Unresolved 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 specific 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 incremental data file.  By ignoring the incremental data file,  all  previous
               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 processing.

       -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 analysis, 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-version.

               1           Browser name, version and machine type if possible.

               0           All information (left unchanged).

       -g num  GroupDomains.  Automatically  group  sites by domain.  The grouping level specified by num can be
               thought of as 'the number of dots' to display in the grouping.  The default value of  0  disables
               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.  Specify 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 services provided by The Webalizer.

       -J name GeoDBDatabase.  Use the alternate GeoDB database name.

       -w      Enable  GeoIP.   Enables  GeoIP (by MaxMind Inc.) geolocation services.  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 created or  edited  using  any  standard
       editor.   Blank  lines  and  lines  that  begin with a pound sign ('#') are ignored.  Any other lines are
       considered 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
       particular 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  anything after the actual value on the line that is not
       actually part of the value being assigned.  The file sample.conf provided with the distribution  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 specified, 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) system 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 current 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 table.

       FlagDir name
               Specifies the directory name where the flag graphics are located.  If not specified, the  default
               is  in  the  flags  directory  directly under the output directory being used.  If specified, 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 contents 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 truncating 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 sample.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 directory unless an absolute name is given
               (ie: starts with '/').

       DNSChildren num
               Number  of  children  DNS processes to run in order to create/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 disabled.  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 geolocation 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 disable.

       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 disable.

       AllURLs ( yes | no )
               Create separate HTML page with All URLs.

       TopCountries num
               Display the top num Countries in the table. Use zero to disable.

       TopEntry num
               Display the top num Entry Pages in the table.  Use zero to disable.

       TopExit num
               Display the top num Exit Pages in the table.  Use zero to disable.

       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 disable.  Usernames are only available
               if using http based authentication.

       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 Referrer' 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 Usernames' 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 precedence 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.  Multiple 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 specified, 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 trailing 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 information (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 information (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 referrer 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 /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. (extension 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)