AWSTATS(1)                           General Commands Manual                           AWSTATS(1)

NAME
       awstats - a free web server logfile analyzer to show you advanced web statistics

SYNOPSIS
       awstats -config virtualhostname [ options ]

DESCRIPTION
       This  runs  awstats  in  command line to update statistics (-update option) of a web site,
       from the log file defined in AWStats config file, or build a HTML report (-output option).
       First,  awstats  tries  to  read  awstats.virtualhostname.conf as the config file.  If not
       found, awstats tries to read awstats.conf, and finally the full path passed to -config op‐
       tion.

       Config  files  (awstats.virtualhostname.conf  or  awstats.conf)  must  be in /etc/awstats,
       /usr/local/etc/awstats or /etc.

OPTIONS
       A summary of options is included below.

       -update
              to update statistics (default)

       -output
              to output main HTML report (no update made except with -update)

       -h     Display usage information.

ENVIRONMENT VARIABLES
       AWStats checks environment variable AWSTATS_FORCE_CONFIG; if defined, AWStats will use  it
       as the "config" value, whatever is the value on command line.

SEE ALSO
       For   more   complete   description   of   AWStats   on  the  Debian  system,  look  here:
       /usr/share/doc/awstats/

AUTHOR
       AWStats was written by Laurent Destailleur <eldy@users.sourceforge.net>.

       This manual page was written by Sergey B Kirpichev <skirpichev@gmail.com>, for the  Debian
       project (but may be used by others).

                                   web server logfile analyzer                         AWSTATS(1)

----- awstats 7.6 (build 20161204) (c) 2000-2016 Laurent Destailleur -----
AWStats is a free web server logfile analyzer to show you advanced web
statistics.
AWStats comes with ABSOLUTELY NO WARRANTY. It's a free software distributed
with a GNU General Public License (See LICENSE file for details).

Syntax: awstats.awstats -config=virtualhostname [options]

  This runs awstats in command line to update statistics (-update option) of a
   web site, from the log file defined in AWStats config file, or build a HTML
   report (-output option).
  First, awstats tries to read awstats.virtualhostname.conf as the config file.
  If not found, awstats tries to read awstats.conf, and finally the full path passed to -config=
  Note 1: Config files (awstats.virtualhostname.conf or awstats.conf) must be
   in /etc/awstats, /usr/local/etc/awstats, /etc or same directory than
   awstats.pl script file.
  Note 2: If AWSTATS_FORCE_CONFIG environment variable is defined, AWStats will
   use it as the "config" value, whatever is the value on command line or URL.
   See AWStats documentation for all setup instrutions.

Options to update statistics:
  -update        to update statistics (default)
  -showsteps     to add benchmark information every 8192 lines processed
  -showcorrupted to add output for each corrupted lines found, with reason
  -showdropped   to add output for each dropped lines found, with reason
  -showunknownorigin  to output referer when it can't be parsed
  -showdirectorigin   to output log line when origin is a direct access
  -updatefor=n   to stop the update process after parsing n lines
  -LogFile=x     to change log to analyze whatever is 'LogFile' in config file
  Be care to process log files in chronological order when updating statistics.

Options to show statistics:
  -output      to output main HTML report (no update made except with -update)
  -output=x    to output other report pages where x is:
               alldomains       to build page of all domains/countries
               allhosts         to build page of all hosts
               lasthosts        to build page of last hits for hosts
               unknownip        to build page of all unresolved IP
               allemails        to build page of all email senders (maillog)
               lastemails       to build page of last email senders (maillog)
               allemailr        to build page of all email receivers (maillog)
               lastemailr       to build page of last email receivers (maillog)
               alllogins        to build page of all logins used
               lastlogins       to build page of last hits for logins
               allrobots        to build page of all robots/spider visits
               lastrobots       to build page of last hits for robots
               urldetail        to list most often viewed pages 
               urldetail:filter to list most often viewed pages matching filter
               urlentry         to list entry pages
               urlentry:filter  to list entry pages matching filter
               urlexit          to list exit pages
               urlexit:filter   to list exit pages matching filter
               osdetail         to build page with os detailed versions
               browserdetail    to build page with browsers detailed versions
               unknownbrowser   to list 'User Agents' with unknown browser
               unknownos        to list 'User Agents' with unknown OS
               refererse        to build page of all refering search engines
               refererpages     to build page of all refering pages
               keyphrases       to list all keyphrases used on search engines
               keywords         to list all keywords used on search engines
               errors404        to list 'Referers' for 404 errors
               allextraX        to build page of all values for ExtraSection X
  -staticlinks           to have static links in HTML report page
  -staticlinksext=xxx    to have static links with .xxx extension instead of .html
  -lang=LL     to output a HTML report in language LL (en,de,es,fr,it,nl,...)
  -month=MM    to output a HTML report for an old month MM
  -year=YYYY   to output a HTML report for an old year YYYY
  The 'date' options doesn't allow you to process old log file. They only
  allow you to see a past report for a chosen month/year period instead of
  current month/year.

Other options:
  -debug=X     to add debug informations lesser than level X (speed reduced)
  -version     show AWStats version

Now supports/detects:
  Web/Ftp/Mail/streaming server log analyzis (and load balanced log files)
  Reverse DNS lookup (IPv4 and IPv6) and GeoIP lookup
  Number of visits, number of unique visitors
  Visits duration and list of last visits
  Authenticated users
  Days of week and rush hours
  Hosts list and unresolved IP addresses list
  Most viewed, entry and exit pages
  Files type and Web compression (mod_gzip, mod_deflate stats)
  Screen size
  Ratio of Browsers with support of: Java, Flash, RealG2 reader,
                        Quicktime reader, WMA reader, PDF reader
  Configurable personalized reports
  279 domains/countries
  1068 robots
  5 worm's families
  88 operating systems
  212 browsers (592 with phone browsers database)
  1284 search engines (and keyphrases/keywords used from them)
  All HTTP errors with last referrer
  Report by day/month/year
  Dynamic or static HTML or XHTML reports, static PDF reports
  Indexed text or XML monthly database
  And a lot of other advanced features and options...
New versions and FAQ at http://www.awstats.org