packages icon



 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



 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

      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.



                                    - 1 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



      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.




                                    - 2 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



 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



                                    - 3 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



      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



                                    - 4 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



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



                                    - 5 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



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




                                    - 6 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



              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.




                                    - 7 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



      -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



                                    - 8 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



              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



                                    - 9 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



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



                                   - 10 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



      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),



                                   - 11 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



              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.



                                   - 12 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



      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



                                   - 13 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



              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.




                                   - 14 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



      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



                                   - 15 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



              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
              '#').



                                   - 16 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



      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



                                   - 17 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



              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)



                                   - 18 -           Formatted:  May 24, 2022






 webalizer(1)                   Version 2.23                    webalizer(1)
 The Webalizer                                                 The Webalizer

                                 26-Feb-2013



      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>





































                                   - 19 -           Formatted:  May 24, 2022