Man Pages

webazolver(1) - phpMan webazolver(1) - phpMan

Command: man perldoc info search(apropos)  


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 sup-
       ports  xferlog formatted (FTP) log files, squid proxy logs and W3C extended format logs.  Logs may also be com-
       pressed, 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  cre-
       ation/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  cur-
               rent directory, and if found, and is owned by the invoking user, then its 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  cur-
               rent 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 statis-
       tics  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.  Configu-
       ration 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 pro-
       duce duplication of statistics.  The only time this may break is if you have duplicate timestamps in two  sepa-
       rate  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 pro-
       cessing 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 num-
       ber 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  any-
       thing  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 actu-
       ally 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  sup-
       ports 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 configura-
       tion 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 sec-
               onds (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  file-
               name 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 ta-
               ble.   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 coun-
               try  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 con-
               tains 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 con-
               tains 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)