GNU.WIKI: The GNU/Linux Knowledge Base

  [HOME] [PHP Manual] [HowTo] [ABS] [MAN1] [MAN2] [MAN3] [MAN4] [MAN5] [MAN6] [MAN7] [MAN8] [MAN9]

  [0-9] [Aa] [Bb] [Cc] [Dd] [Ee] [Ff] [Gg] [Hh] [Ii] [Jj] [Kk] [Ll] [Mm] [Nn] [Oo] [Pp] [Qq] [Rr] [Ss] [Tt] [Uu] [Vv] [Ww] [Xx] [Yy] [Zz]


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



  All copyrights belong to their respective owners. Other content (c) 2014-2018, GNU.WIKI. Please report site errors to webmaster@gnu.wiki.
Page load time: 0.117 seconds. Last modified: November 04 2018 12:49:43.