]> git.ipfire.org Git - thirdparty/AWStats.git/commitdiff
New parameter: Added OnlyHosts parameter.
authoreldy <>
Mon, 28 Oct 2002 19:44:08 +0000 (19:44 +0000)
committereldy <>
Mon, 28 Oct 2002 19:44:08 +0000 (19:44 +0000)
docs/awstats_changelog.txt
docs/awstats_config.html
wwwroot/cgi-bin/awstats.model.conf
wwwroot/cgi-bin/awstats.pl

index 837eb0431c19002369f16eb55b1947d0eae3be14..37e8c8c93455cd30f93de0c1a9d3f4409ce7378b 100644 (file)
@@ -7,7 +7,7 @@ AWStats Changelog
 - Added total and average row at bottom of day data array.
 - Removed "Bytes" text when values is 0.
 - Reduced main page size.
-
+- New parameter: Added OnlyHosts parameter.
 
 
 
index ee7f5de60c780cf45c7ad7a71a9c4e1ba74447ec..4e295f09ed2f9c0ef7ea8b7612d667979fe9f7d4 100644 (file)
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
-<html>\r
-<head>\r
-<meta name="description" content="AWStats Documentation - Configuration directives and parameters">\r
-<meta name="keywords" content="awstats, awstat, config, parameters, configuration, conf">\r
-<meta name="robots" content="index,follow">\r
-<meta name="title" content="AWStats Documentation - Configuration directives and parameters">\r
-<title>AWStats Documentation - Configuration directives and parameters</title>\r
-<link rel="stylesheet" href="styles.css" type="text/css">\r
-<!-- $Revision$ - $Author$ - $Date$ -->\r
-</head>\r
-\r
-<body topmargin=10 leftmargin=5>\r
-\r
-\r
-<table style="font: 10pt arial,helvetica,verdana" cellpadding=0 cellspacing=0 border=0 bgcolor=#FFFFFF width=100%>\r
-\r
-<!-- Large -->\r
-<tr style="font: 10pt arial,helvetica,verdana">\r
-<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>\r
-<td bgcolor=#9999cc align=center>\r
-<br>\r
-<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 5.1 Documentation</b></font><br>\r
-<br>\r
-</td>\r
-<td bgcolor=#9999cc align=center>\r
-&nbsp;\r
-</td>\r
-</tr>\r
-\r
-</table>\r
-\r
-\r
-<br><br><H1 style="font: 26px arial,helvetica,sanserif">AWStats configuration directives/options</H1>\r
-<!-- -------------------------------------------------------------------------------------- -->\r
-\r
-<br>Each directives available in the AWStats config file (.conf) is listed here.<br>\r
-They are described using a consistent format.<br>\r
-<br>\r
-<b>Notes</b>\r
-To include an environment variable in any parameter (AWStats will replace it with its value\r
-when reading it), follow the example:<br>\r
-<i>Parameter="__ENVNAME__"</i>\r
-<br>\r
-<br>\r
-<br>\r
-<br><b>MAIN SETUP SECTION (Required to make AWStats work)</b><br>\r
-<ul>\r
-<li><a href="#LogFile">LogFile</a>\r
-<li><a href="#LogFormat">LogFormat</a>\r
-<li><a href="#LogSeparator">LogSeparator</a>\r
-<li><a href="#DNSLookup">DNSLookup</a>\r
-<li><a href="#DirData">DirData</a>\r
-<li><a href="#DirCgi">DirCgi</a>\r
-<li><a href="#DirIcons">DirIcons</a>\r
-<li><a href="#SiteDomain">SiteDomain</a>\r
-<li><a href="#HostAliases">HostAliases</a>\r
-<li><a href="#AllowToUpdateStatsFromBrowser">AllowToUpdateStatsFromBrowser</a>\r
-</ul>\r
-\r
-\r
-<br><b>OPTIONAL SETUP SECTION (Not required but increase AWStats features)</b><br>\r
-<ul>\r
-<li><a href="#EnableLockForUpdate">EnableLockForUpdate</a>\r
-<li><a href="#DNSStaticCacheFile">DNSStaticCacheFile</a>\r
-<li><a href="#DNSLastUpdateCacheFile">DNSLastUpdateCacheFile</a>\r
-<li><a href="#SkipDNSLookupFor">SkipDNSLookupFor</a>\r
-<li><a href="#AllowAccessFromWebToAuthenticatedUsersOnly">AllowAccessFromWebToAuthenticatedUsersOnly</a>\r
-<li><a href="#AllowAccessFromWebToFollowingAuthenticatedUsers">AllowAccessFromWebToFollowingAuthenticatedUsers</a>\r
-<li><a href="#AllowAccessFromWebToFollowingIPAddresses">AllowAccessFromWebToFollowingIPAddresses</a>\r
-<li><a href="#CreateDirDataIfNotExists">CreateDirDataIfNotExists</a>\r
-<li><a href="#SaveDatabaseFilesWithPermissionsForEveryone">SaveDatabaseFilesWithPermissionsForEveryone</a>\r
-<li><a href="#PurgeLogFile">PurgeLogFile</a>\r
-<li><a href="#ArchiveLogRecords">ArchiveLogRecords</a>\r
-<li><a href="#KeepBackupOfHistoricFiles">KeepBackupOfHistoricFiles</a>\r
-<li><a href="#DefaultFile">DefaultFile</a>\r
-<li><a href="#SkipHosts">SkipHosts</a>\r
-<li><a href="#SkipUserAgents">SkipUserAgents</a>\r
-<li><a href="#SkipFiles">SkipFiles</a>\r
-<li><a href="#OnlyFiles">OnlyFiles</a>\r
-<li><a href="#NotPageList">NotPageList</a>\r
-<li><a href="#ValidHTTPCodes">ValidHTTPCodes</a>\r
-<li><a href="#URLNotCaseSensitive">URLNotCaseSensitive</a>\r
-<li><a href="#URLWithQuery">URLWithQuery</a>\r
-<li><a href="#URLWithQueryWithoutFollowingParameters">URLWithQueryWithoutFollowingParameters</a>\r
-<li><a href="#URLReferrerWithQuery">URLReferrerWithQuery</a>\r
-<li><a href="#WarningMessages">WarningMessages</a>\r
-<li><a href="#NbOfLinesForCorruptedLog">NbOfLinesForCorruptedLog</a>\r
-<li><a href="#SplitSearchString">SplitSearchString</a>\r
-<li><a href="#WrapperScript">WrapperScript</a>\r
-<li><a href="#DecodeUA">DecodeUA</a>\r
-</ul>\r
-\r
-<br><b>OPTIONAL ACCURACY SETUP SECTION (Not required but increase AWStats features)</b><br>\r
-<ul>\r
-<li><a href="#LevelFor">LevelForRobotsDetection</a>\r
-<li><a href="#LevelFor">LevelForBrowsersDetection</a>\r
-<li><a href="#LevelFor">LevelForOSDetection</a>\r
-<li><a href="#LevelFor">LevelForRefererAnalyze</a>\r
-</ul>\r
-\r
-<br><b>OPTIONAL APPEARANCE SETUP SECTION (Not required but increase AWStats features)</b><br>\r
-<ul>\r
-<li><a href="#UseFramesWhenCGI">UseFramesWhenCGI</a>\r
-<li><a href="#DetailedReportsOnNewWindows">DetailedReportsOnNewWindows</a>\r
-<li><a href="#Expires">Expires</a>\r
-<li><a href="#MaxRowsInHTMLOutput">MaxRowsInHTMLOutput</a>\r
-<li><a href="#Lang">Lang</a>\r
-<li><a href="#DirLang">DirLang</a>\r
-<li><a href="#Show">ShowHeader</a>\r
-<li><a href="#Show">ShowMenu</a>\r
-<li><a href="#Show">ShowMonthDayStats</a>\r
-<li><a href="#Show">ShowDaysOfWeekStats</a>\r
-<li><a href="#Show">ShowHoursStats</a>\r
-<li><a href="#Show">ShowDomainsStats</a>\r
-<li><a href="#Show">ShowHostsStats</a>\r
-<li><a href="#Show">ShowAuthenticatedUsers</a>\r
-<li><a href="#Show">ShowRobotsStats</a>\r
-<li><a href="#Show">ShowSessionsStats</a>\r
-<li><a href="#Show">ShowPagesStats</a>\r
-<li><a href="#Show">ShowCompressionStats</a>\r
-<li><a href="#Show">ShowFileTypesStats</a>\r
-<li><a href="#Show">ShowFileSizesStats</a>\r
-<li><a href="#Show">ShowBrowsersStats</a>\r
-<li><a href="#Show">ShowOSStats</a>\r
-<li><a href="#Show">ShowOriginStats</a>\r
-<li><a href="#Show">ShowKeyphrasesStats</a>\r
-<li><a href="#Show">ShowKeywordsStats</a>\r
-<li><a href="#Show">ShowHTTPErrorsStats</a>\r
-<li><a href="#Max">MaxNbOfDomain</a>\r
-<li><a href="#Max">MaxNbOfHostsShown</a>\r
-<li><a href="#Max">MinHitHost</a>\r
-<li><a href="#Max">MaxNbOfLoginShown</a>\r
-<li><a href="#Max">MinHitLogin</a>\r
-<li><a href="#Max">MaxNbOfRobotShown</a>\r
-<li><a href="#Max">MinHitRobot</a>\r
-<li><a href="#Max">MaxNbOfPageShown</a>\r
-<li><a href="#Max">MinHitFile</a>\r
-<li><a href="#Max">MaxNbOfRefererShown</a>\r
-<li><a href="#Max">MinHitRefer</a>\r
-<li><a href="#Max">MaxNbOfKeywordsShown</a>\r
-<li><a href="#Max">MinHitKeyword</a>\r
-<li><a href="#FirstDayOfWeek">FirstDayOfWeek</a>\r
-<li><a href="#ShowFlagLinks">ShowFlagLinks</a>\r
-<li><a href="#ShowLinksOnUrl">ShowLinksOnUrl</a>\r
-<li><a href="#MaxLengthOfURL">MaxLengthOfURL</a>\r
-<li><a href="#ShowLinksToWhoIs">ShowLinksToWhoIs</a>\r
-<li><a href="#LinksToWhoIs">LinksToWhoIs</a>\r
-<li><a href="#LinksToIPWhoIs">LinksToIPWhoIs</a>\r
-<li><a href="#HTMLHeadSection">HTMLHeadSection</a>\r
-<li><a href="#HTMLEndSection">HTMLEndSection</a>\r
-<li><a href="#Bar">BarWidth</a>\r
-<li><a href="#Bar">BarHeight</a>\r
-<li><a href="#Logo">Logo</a>\r
-<li><a href="#Logo">LogoLink</a>\r
-<li><a href="#StyleSheet">StyleSheet</a>\r
-<li><a href="#color_">color_Background</a>\r
-<li><a href="#color_">color_TableBGTitle</a>\r
-<li><a href="#color_">color_TableTitle</a>\r
-<li><a href="#color_">color_TableBG</a>\r
-<li><a href="#color_">color_TableRowTitle</a>\r
-<li><a href="#color_">color_TableBGRowTitle</a>\r
-<li><a href="#color_">color_TableBorder</a>\r
-<li><a href="#color_">color_text</a>\r
-<li><a href="#color_">color_titletext</a>\r
-<li><a href="#color_">color_weekend</a>\r
-<li><a href="#color_">color_link</a>\r
-<li><a href="#color_">color_hover</a>\r
-<li><a href="#color_">color_u</a>\r
-<li><a href="#color_">color_v</a>\r
-<li><a href="#color_">color_p</a>\r
-<li><a href="#color_">color_h</a>\r
-<li><a href="#color_">color_k</a>\r
-<li><a href="#color_">color_s</a>\r
-<li><a href="#color_">color_e</a>\r
-<li><a href="#color_">color_x</a>\r
-</ul>\r
-\r
-<br><b>PLUGINS</b><br>\r
-<ul>\r
-<li><a href="#LoadPlugin">LoadPlugin</a>\r
-</ul>\r
-\r
-<br><b>INLUDES</b><br>\r
-<ul>\r
-<li><a href="#include">#include</a>\r
-</ul>\r
-\r
-\r
-\r
-<br><br><hr>\r
-\r
-<a name="LogFile"><b>LogFile</b></a><br>\r
-<b>Version : </b>1.0 +<br>\r
-3.1+ for tags %YYYY-n,%YY-n,%MM-n,%DD-n,%HH-n<br>\r
-3.2+ for tag %WM-n<br>\r
-4.0+ for tag %DW-n<br>\r
-4.1+ for tag %NS-n<br>\r
-5.0+ for tag %WY-n<br>\r
-5.1+ for tag %Wm-n, %Wy-n, %Dw-n<br>\r
-<br># "LogFile" contains the web server logfile to analyze.\r
-<br># You can use a full path or relative path from awstats.pl directory.\r
-<br># Example: "/var/log/apache/access.log"\r
-<br># Example: "../logs/mycombinedlog.log"\r
-<br># You can also use tags in this filename if you need a dynamic file name\r
-<br># depending on date or time (Replacement is made by AWStats at the beginning\r
-<br># of its execution). This is available tags :\r
-<br>#   %YYYY-n  is replaced with 4 digits year we were n hours ago\r
-<br>#   %YY-n    is replaced with 2 digits year we were n hours ago\r
-<br>#   %MM-n    is replaced with month we were n hours ago\r
-<br>#   %DD-n    is replaced with day we were n hours ago\r
-<br>#   %HH-n    is replaced with hour we were n hours ago\r
-<br>#   %NS-n    is replaced with number of seconds at 00:00 since 1970\r
-<br>#   %WM-n    is replaced with the week number in month (1-5)\r
-<br>#   %Wm-n    is replaced with the week number in month (0-4)\r
-<br>#   %WY-n    is replaced with the week number in year (1-52)\r
-<br>#   %Wy-n    is replaced with the week number in year (0-51)\r
-<br>#   %DW-n    is replaced with the day number in week (1-7, 1=sunday)\r
-<br>#                              use n=24 if you need (1-7, 1=monday)\r
-<br>#   %Dw-n    is replaced with the day number in week (0-6, 0=sunday)\r
-<br>#                              use n=24 if you need (0-6, 0=monday)\r
-<br>#   Use 0 for n if you need current year, month, day, hour...\r
-<br># Example: "/var/log/access_log.%YYYY-0%MM-0%DD-0.log"\r
-<br># Example: "C:/WINNT/system32/LogFiles/W3SVC1/ex%YY-24%MM-24%DD-24.log"\r
-<br># You can also use a pipe if log file come from a pipe.\r
-<br># Example: "gzip -d &lt;/var/log/apache/access.log.gz |"\r
-<br>#\r
-<br>LogFile="/var/log/httpd/mylog.log"\r
-\r
-<br><br><hr>\r
-\r
-<a name="LogFormat"><b>LogFormat</b></a><br>\r
-<b>Version : </b>2.1 +<br>\r
-3.1+ for tags %host,%logname,%time1,%time2,%methodurl,%methodurlnoprot,%method,%url,\r
-%query,%code,%bytesd,%refererquot,%referer,%uaquot,%ua,%other<br>\r
-3.2+ for tags %gzipin,%gzipout<br>\r
-4.0+ for tags %gzipratio,%syslog<br>\r
-4.1+ for tag  %virtualname<br>\r
-<br># Enter here your log format (Must agree with your web server. See setup\r
-<br># instructions in README.txt to know how to configure your web server to have\r
-<br># the required log format).\r
-<br># Possible values: 1,2,3,4,5,6 or "your_own_personalized_log_format"\r
-<br># 1 - Apache native combined log format (NCSA combined/XLF/ELF log format)\r
-<br># 2 - IIS log format (W3C log format)\r
-<br># 3 - Webstar native log format\r
-<br># 4 - Apache or Squid native common log format (NCSA common log format)\r
-<br>#     With LogFormat=4, some features (browsers, os, keywords...) can't work.\r
-<br># 5 - ISA server standard log format\r
-<br># 6 - Lotus Notes combined log format\r
-<br># "your_own_personalized_log_format" = If your log is a personalized format,\r
-<br>#   you must use the following syntax keys to define the log format string:\r
-<br>#   %host             Host client name or IP address\r
-<br>#   %logname          Authenticated login/user used on protected pages\r
-<br>#   %time1            Date and time with format: [dd/mmm/yyyy:hh:mm:ss +0000]\r
-<br>#   %time1b           Date and time with format: [dd/mmm/yyyy:hh:mm:ss]\r
-<br>#   %time2            Date and time with format: yyyy-mm-dd hh-mm-ss\r
-<br>#   %methodurl        Method and URL with format: "GET /index.html HTTP/x.x"\r
-<br>#   %methodurlnoprot  Method and URL with format: "GET /index.html"\r
-<br>#   %method           Method with format: GET\r
-<br>#   %url              URL only with format: /index.html\r
-<br>#   %query            Query string (used by URLWithQuery option)\r
-<br>#   %code             Return code status (with format for web log: 999)\r
-<br>#   %bytesd           Size of document in bytes\r
-<br>#   %refererquot      Referer page with format: "http://from.com/from.htm"\r
-<br>#   %referer          Referer page with format: http://from.com/from.htm\r
-<br>#   %uaquot           User agent with format: "Mozilla/4.0 (compatible, ...)"\r
-<br>#   %ua               User agent with format: Mozilla/4.0_(compatible...)\r
-<br>#   %gzipin           Mod_gzip compression input bytes: In:XXX\r
-<br>#   %gzipout          Mod_gzip compression output bytes & ratio: Out:YYY:ZZZpct.\r
-<br>#   %gzipratio        Mod_gzip compression ratio: ZZZpct.\r
-<br>#   %email            EMail sender (for mail log)\r
-<br>#   %email_r          EMail receiver (for mail log)\r
-<br>#   %syslog           Syslog-specific time and host stamp with format: Mon dd hh:mm:ss hostname\r
-<br>#   %virtualname      Web sever virtual hostname. Use this tag when same log\r
-<br>#                     file contains data of several virtual web servers. The\r
-<br>#                     SiteDomain will be used to filter the one you want.\r
-<br>#   If your log format has some fields not included in this list, use\r
-<br>#   %other            Means another field\r
-<br>#\r
-<br># Examples for Apache combined logs (following two examples are equivalent):\r
-<br># LogFormat = 1\r
-<br># LogFormat = "%host %other %logname %time1 %methodurl %code %bytesd %refererquot %uaquot"\r
-<br>#\r
-<br># Examples for IIS (following two examples are equivalent):\r
-<br># LogFormat = 2\r
-<br># LogFormat = "%time2 %host %logname %method %url %code %bytesd %other %ua %referer"\r
-<br>#\r
-<br>LogFormat=1\r
-\r
-<br><br><hr>\r
-\r
-<a name="LogSeparator"><b>LogSeparator</b></a><br>\r
-<b>Version : </b>5.0 +<br>\r
-<br># If your log field's separator is not a space, you can change this parameter.\r
-<br># Example: " "\r
-<br># Example: "\t"\r
-<br># Example: "|"\r
-<br># Default: " "\r
-<br>#\r
-\r
-<br><br><hr>\r
-\r
-<a name="DNSLookup"><b>DNSLookup</b></a><br>\r
-<b>Version : </b>1.0 + (5.0 + for value 2) <br>\r
-<br># If you want to have information on domains/countries visitors, you must ask\r
-<br># AWStats to make reverse DNS lookup (if not already done in your log file).\r
-<br># With DNSLookup to 0, all hosts will be reported by their IP addresses and\r
-<br># not by the full hostname of visitors. Domain/Country chart will also report\r
-<br># all visitors from a domain/country "Unknown".\r
-<br># If you need to set DNSLookup to 1, don't forget that this will reduce\r
-<br># dramatically AWStats update process speed. Do not use on large web sites.\r
-<br># Possible values:\r
-<br>#  0 No DNS Lookup\r
-<br>#  1 DNS Lookup is fully enabled\r
-<br>#  2 DNS Lookup is made only from DNS cache files\r
-<br># Default: 2\r
-<br># \r
-<br>DNSLookup=2\r
-\r
-<br><br><hr>\r
-\r
-<a name="DirData"><b>DirData</b></a><br>\r
-<b>Version : </b>1.0 +<br>\r
-<br># When AWStats updates its statistics, it stores results of its analysis in \r
-<br># files (AWStats database). All those files are written in the directory\r
-<br># defined by the "DirData" parameter. Set this value to the directory where\r
-<br># you want AWStats to save its database and working files into.\r
-<br># Warning: If you want to be able to use the "AllowToUpdateStatsFromBrowser"\r
-<br># feature (see later), you need write permissions by webserver user on this\r
-<br># directory.\r
-<br># Example: "/var/cache/awstats"\r
-<br># Example: "../data"\r
-<br># Example: "C:/awstats_data_dir"\r
-<br># Default: "."          (means same directory as awstats.pl)\r
-<br>#\r
-<br>DirData="."\r
-\r
-<br><br><hr>\r
-\r
-<a name="DirCgi"><b>DirCgi</b></a><br>\r
-<b>Version : </b>1.0 +<br>\r
-<br># Relative or absolute web URL of your awstats.pl directory.\r
-<br># This parameter is used only when AWStats is ran from command line\r
-<br># with -output option (to generate links in HTML reported page).\r
-<br># Default: "/cgi-bin"   (means awstats.pl is in "/mywwwroot/cgi-bin")\r
-<br>#\r
-<br>DirCgi="/cgi-bin"\r
-\r
-<br><br><hr>\r
-\r
-<a name="DirIcons"><b>DirIcons</b></a><br>\r
-<b>Version : </b>1.0 +<br>\r
-<br># If AWStats used as a CGI, enter relative or absolute web URL of all icons\r
-<br># subdirectories.\r
-<br># If you build static reports ("... -output > outputpath/output.html"), enter\r
-<br># path of icon directory relative to the directory outputpath.\r
-<br># Example: "/icon"\r
-<br># Example: "../icon"\r
-<br># Default: "/icon" (means you must copy icon directories in "/mywwwroot/icon")\r
-<br>#\r
-<br>DirIcons="/icon"\r
-\r
-<br><br><hr>\r
-\r
-<a name="SiteDomain"><b>SiteDomain</b></a><br>\r
-<b>Version : </b>3.2 +<br>\r
-<br># "SiteDomain" must contain the main domain name or the main intranet web\r
-<br># server name used to reach the web site.\r
-<br># If you share the same log file for several virtual web servers, this\r
-<br># parameter is used to tell AWStats to filter record that contains records for\r
-<br># this virtual host name only (So check that this virtual hostname can be\r
-<br># found in your log file and use a personalized log format that include the\r
-<br># %virtualname tag).\r
-<br># But for multi hosting a better solution is to have one log file for each\r
-<br># virtual web server. In this case, this parameter is only used to generate\r
-<br># full URL's links when ShowLinksOnUrl option is set to 1.\r
-<br># Example: "www.mysite.com"\r
-<br># Example: "user.mydomain.com"\r
-<br># Example: "myintranetserver"\r
-<br>#\r
-<br>SiteDomain=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="HostAliases"><b>HostAliases</b></a><br>\r
-<b>Version : </b>1.0 +<br>\r
-<br># Enter here all other possible domain names, addresses or virtual host\r
-<br># aliases someone can use to access your site. Try to keep only the minimum\r
-<br># number of possible names/adresses to have the best performances.\r
-<br># You can repeat the "SiteDomain" value in this list.\r
-<br># Use space between each value and put a backslash before each dot.\r
-<br># This parameter is used to analyze referer field in log file and to help\r
-<br># AWStats to know if a referer URL is a local URL of same site or an URL of\r
-<br># another site.\r
-<br># Example: "www.myserver.com x.y.z.w localhost 127.0.0.1"\r
-<br>#\r
-<br>HostAliases="www.myserver.com x.y.z.w localhost 127.0.0.1"\r
-\r
-<br><br><hr>\r
-\r
-<a name="AllowToUpdateStatsFromBrowser"><b>AllowToUpdateStatsFromBrowser</b></a><br>\r
-<b>Version : </b>3.0 +<br>\r
-<br># When this parameter is set to 1, AWStats add a button on report page to\r
-<br># allow to "update" statistics from a web browser. Warning, when "update" is\r
-<br># made from a browser, AWStats is ran as a CGI by the web server user\r
-<br># defined in your web server (user "nobody" by default with Apache, "IUSR_XXX"\r
-<br># with IIS), so the "DirData" directory and all already existing history files\r
-<br># (awstatsMMYYYY[.xxx].txt) must be writable by this user. Change permissions\r
-<br># if required.\r
-<br># Warning: Update process can be long so you might experience "time out"\r
-<br># browser errors if you don't launch AWStats enough frequently.\r
-<br># When set to 0, update is only made when AWStats is ran from the command\r
-<br># line interface (or a task scheduler).\r
-<br># Possible values: 0 or 1\r
-<br># Default: 0\r
-<br>#\r
-<br>AllowToUpdateStatsFromBrowser=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="EnableLockForUpdate"><b>EnableLockForUpdate</b></a><br>\r
-<b>Version : </b>5.0 +<br>\r
-<br># When the update process run, AWStats can set a lock file in TEMP or TMP\r
-<br># directory. This lock is to avoid to have 2 update processes running at the\r
-<br># same time to prevent unknown conflicts problems and avoid DoS attacks when\r
-<br># AllowToUpdateStatsFromBrowser is set to 1.\r
-<br># Because, when you use lock file, you can experience sometimes problems in\r
-<br># lock file not correctly removed (when process is killed for example, this\r
-<br># requires that you remove the file manualy), this option is not enabled by\r
-<br># default (Do not enable this option with no consol server access).\r
-<br># Possible values: 0 or 1\r
-<br># Default: 0\r
-<br>#\r
-<br>EnableLockForUpdate=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="DNSStaticCacheFile"><b>DNSStaticCacheFile</b></a><br>\r
-<b>Version : </b>5.0 +<br>\r
-<br># AWStats can do reverse DNS lookups through a static DNS cache file that was\r
-<br># previously created manually. If no path is given in static DNS cache file\r
-<br># name, AWStats will search DirData directory. This file is never changed.\r
-<br># This option is not used if DNSLookup=0.\r
-<br># Note: DNS cache file format is 'minsince1970 ipaddress resolved_hostname'\r
-<br># or just 'ipaddress resolved_hostname'\r
-<br># Example: "/mydnscachedir/dnscache"\r
-<br># Default: "dnscache.txt"\r
-<br>#\r
-<br>DNSStaticCacheFile="dnscache.txt"\r
-\r
-<br><br><hr>\r
-\r
-<a name="DNSLastUpdateCacheFile"><b>DNSLastUpdateCacheFile</b></a><br>\r
-<b>Version : </b>5.0 +<br>\r
-<br># AWStats can do reverse DNS lookups through a DNS cache file that was created\r
-<br># by a previous run of AWStats. This file is erased and recreated after each\r
-<br># statistics update process. You don't need to create and/or edit it.\r
-<br># AWStats will read and save this file in DirData directory.\r
-<br># This option is not used if DNSLookup=0.\r
-<br># Example: "/mydnscachedir/dnscachelastupdate"\r
-<br># Default: "dnscachelastupdate.txt"\r
-<br>#\r
-<br>DNSLastUpdateCacheFile="dnscachelastupdate.txt"\r
-\r
-<br><br><hr>\r
-\r
-<a name="SkipDNSLookupFor"><b>SkipDNSLookupFor</b></a><br>\r
-<b>Version : </b>3.0 +<br>\r
-<br># You can specify specific IP addresses that should NOT be looked up in\r
-<br>#  the DNS. You may specify partial addresses (ie 163.85. for everything\r
-<br>#  behind the usual firewall setup, etc)...\r
-<br># This option is used only if DNSLookup=1.\r
-<br># Note: Use space between each value.\r
-<br># Example: "163.85. 201.101.51.2"\r
-<br># Default: ""\r
-<br>#\r
-<br>SkipDNSLookupFor=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="AllowAccessFromWebToAuthenticatedUsersOnly"><b>AllowAccessFromWebToAuthenticatedUsersOnly</b></a><br>\r
-<b>Version : </b>4.0 +<br>\r
-<br># The following two parameters allow you to protect a config file to be used\r
-<br># by your AWStats program called from a browser only if web user has been\r
-<br># authenticated. Your AWStats program must be in a web protected "realm" (With\r
-<br># Apache, you can use .htaccess files to do so. With other web servers, see\r
-<br># your server setup manual).\r
-<br># Possible values: 0 or 1\r
-<br># Default: 0\r
-<br>#\r
-<br>AllowAccessFromWebToAuthenticatedUsersOnly=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="AllowAccessFromWebToFollowingAuthenticatedUsers"><b>AllowAccessFromWebToFollowingAuthenticatedUsers</b></a><br>\r
-<b>Version : </b>4.0 +<br>\r
-<br># This parameter gives the list of all authorized authenticated users to view\r
-<br># statistics for this domain/config file. This parameter is used only if\r
-<br># AllowAccessToAuthenticatedUsersOnly is set to 1.\r
-<br># Example: "user1 user2"\r
-<br># Default: ""\r
-<br>#\r
-<br>AllowAccessFromWebToFollowingAuthenticatedUsers=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="AllowAccessFromWebToFollowingIPAddresses"><b>AllowAccessFromWebToFollowingIPAddresses</b></a><br>\r
-<b>Version : </b>5.0 +<br>\r
-<br># When this parameter is define to something, the IP address of the user that\r
-<br># read its statistics from a browser (when AWStats is used as a CGI) is\r
-<br># checked and must match the IP address range defined by this parameter.\r
-<br># Example: "123.123.123.10-123.123.123.255"\r
-<br># Default: ""\r
-<br>#\r
-<br>AllowAccessFromWebToFollowingIPAddresses=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="CreateDirDataIfNotExists"><b>CreateDirDataIfNotExists</b></a><br>\r
-<b>Version : </b>4.0 +<br>\r
-<br># If the "DirData" directory (see above) does not exists, AWStats return an\r
-<br># error. However, you can ask AWStats to create it. This option can be used by\r
-<br># some Web Hosting Providers that has defined a dynamic value for DirData (for\r
-<br># example DirData="/home/__REMOTE_USER__").\r
-<br># Possible values: 0 or 1\r
-<br># Default: 0\r
-<br>#\r
-<br>CreateDirDataIfNotExists=1\r
-\r
-<br><br><hr>\r
-\r
-<a name="SaveDatabaseFilesWithPermissionsForEveryone"><b>SaveDatabaseFilesWithPermissionsForEveryone</b></a><br>\r
-<b>Version : </b>4.0 +<br>\r
-<br># In most case, AWStats is used as a cgi program. So AWStats process is ran\r
-<br># by default web server user (nobody for Unix, IUSR_xxx for IIS/Windows,...).\r
-<br># To make use easier and avoid permission problems between update process \r
-<br># (run by an admin user) and CGI process (ran by a low level user), AWStats\r
-<br># save its database files with read and write for everyone.\r
-<br># If you have experience on managing security policies (Web Hosting Provider),\r
-<br># you should set this parameter to 0. AWStats will keep default process user\r
-<br># permissions on its files.\r
-<br># Possible values: 0 or 1\r
-<br># Default: 1\r
-<br>#\r
-<br>SaveDatabaseFilesWithPermissionsForEveryone=1\r
-\r
-<br><br><hr>\r
-\r
-<a name="PurgeLogFile"><b>PurgeLogFile</b></a><br>\r
-<b>Version : </b>2.23 +<br>\r
-<br># AWStats can purge log after processing it. By this way, the next time you\r
-<br># launch AWStats, log file will be smaller and processing time will be better.\r
-<br># IMPORTANT !!!\r
-<br># AWStats is able to detect new lines in log file, to process only them, so\r
-<br># you can launch AWStats as soon as you want, even with this parameter to 0.\r
-<br># With 0, no purge is made, so you must use a scheduled task or a web server\r
-<br># that make this purge frequently.\r
-<br># With 1, the purge of the log file is made each time AWStats is ran.\r
-<br># This parameter doesn't work with IIS (This web server doesn't let its log\r
-<br># file to be purged).\r
-<br># Possible values: 0 or 1\r
-<br># Default: 0\r
-<br>#\r
-<br>PurgeLogFile=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="ArchiveLogRecords"><b>ArchiveLogRecords</b></a><br>\r
-<b>Version : </b>2.1 +<br>\r
-<br># When PurgeLogFile is setup to 1, AWStats will clean your log file after\r
-<br># processing it. You can however keep an archive file (saved in "DirData") of\r
-<br># all processed log records by setting this to 1 (For example if you want to\r
-<br># use another log analyzer).\r
-<br># This parameter is not used if PurgeLogFile=0\r
-<br># Possible values: 0 or 1\r
-<br># Default: 0\r
-<br>#\r
-<br>ArchiveLogRecords=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="KeepBackupOfHistoricFiles"><b>KeepBackupOfHistoricFiles</b></a><br>\r
-<b>Version : </b>3.2 +<br>\r
-<br># Each time you run the update process, AWStats overwrite the 'historic file'\r
-<br># for the month (awstatsMMYYYY[.*].txt) with the updated one.\r
-<br># When write errors occurs (IO, disk full,...), this historic file can be\r
-<br># corrupted and must be deleted. Because this file contains information of all\r
-<br># past processed log files, you will loose old stats if removed. So you can\r
-<br># ask AWStats to save last non corrupted file in a .bak file. This file is\r
-<br># stored in "DirData" directory with other 'historic files'.\r
-<br># Possible values: 0 or 1\r
-<br># Default: 0\r
-<br>#\r
-<br>KeepBackupOfHistoricFiles=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="DefaultFile"><b>DefaultFile</b></a><br>\r
-<b>Version : </b>1.0 + (5.0 + can accept several values)<br>\r
-<br># Default index page name for your web server.\r
-<br># Example: "default.htm default.html"\r
-<br># Default: "index.html"\r
-<br>#\r
-<br>DefaultFile="index.html"\r
-\r
-<br><br><hr>\r
-\r
-<a name="SkipHosts"><b>SkipHosts</b></a><br>\r
-<b>Version : </b>1.0 +<br>\r
-<br># Do not include access from clients that match following criteria.\r
-<br># If your log file contains IP adresses in host field, you must enter here\r
-<br># matching IP adresses criteria.\r
-<br># If DNS lookup is already done in your log file, you must enter here hostname\r
-<br># criteria.\r
-<br># Note: Use space between each value.\r
-<br># Example: "127.0.0.1 163.84. 201.101.51.1"\r
-<br># Example: "localhost abcxyz"\r
-<br># Default: ""\r
-<br>#\r
-<br>SkipHosts=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="SkipUserAgents"><b>SkipUserAgents</b></a><br>\r
-<b>Version : </b>5.1 +<br>\r
-<br># Do not include access from clients with a user agent that match following\r
-<br># criteria. If you want to exclude a robot, you should update the robots.pm\r
-<br># file instead of this parameter.\r
-<br># Note: Use space between each value. This parameter is not case sensitive.\r
-<br># Example: "konqueror"\r
-<br># Default: ""\r
-<br>#\r
-<br>SkipUserAgents=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="SkipFiles"><b>SkipFiles</b></a><br>\r
-<b>Version : </b>1.0 +<br>\r
-<br># Use SkipFiles to ignore access to URLs that match one of following entries.\r
-<br># You can, with this option, add a list of not important frame pages (like \r
-<br># menus, etc...) to exclude them from statistics.\r
-<br># For example, to ignore a whole directory tree, just add "directorytoignore",\r
-<br># to ignore "users" pages in your stats, you can add "/~".\r
-<br># The opposite parameter of "SkipFiles" is "OnlyFiles".\r
-<br># Note: This parameter is not case sensitive.\r
-<br># Note: Use space between each value and do not remove default values.\r
-<br># Note: xxx$ means URL ending with xxx.\r
-<br># Example: "robots.txt$ favicon.ico$ badpage.html /~"\r
-<br># Default: "robots.txt$ favicon.ico$"\r
-<br>#\r
-<br>SkipFiles="robots.txt$ favicon.ico$"\r
-\r
-<br><br><hr>\r
-\r
-<a name="OnlyFiles"><b>OnlyFiles</b></a><br>\r
-<b>Version : </b>3.0 +<br>\r
-<br># Include in stats, only accesses to URLs that match one of following entries.\r
-<br># For example, if you want AWStats to filter access to keep only stats that\r
-<br># match a particular string, like a particular directory, you can add this\r
-<br># directory name in this parameter.\r
-<br># The opposite parameter of "OnlyFiles" is "SkipFiles".\r
-<br># Note: This parameter is not case sensitive.\r
-<br># Note: Use space between each value and do not remove default values\r
-<br># Note: \. means . and xxx$ means URL ending by xxx.\r
-<br># Example: "marketing_directory"\r
-<br># Default: ""\r
-<br>#\r
-<br>OnlyFiles=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="NotPageList"><b>NotPageList</b></a><br>\r
-<b>Version : </b>3.2 +<br>\r
-<br># Add here a list of kind of url (file extension) that must be counted as\r
-<br># "Hit only" and not as a "Hit" and "Page/Download". You can set here all\r
-<br># images extensions as they are hit downloaded that must be counted but they\r
-<br># are not viewed pages. URLs with such extensions are not included in the TOP\r
-<br># Pages/URL report.\r
-<br># Note: If you want to exclude your own URLs from stats (No Pages and no Hits\r
-<br># reported), you should use SkipFiles parameter instead.\r
-<br># Example: ""\r
-<br># Example: "css js class gif jpg jpeg png bmp zip arj gz z wav mp3 wma mpg"\r
-<br># Default: "css js class gif jpg jpeg png bmp"\r
-<br>#\r
-<br>NotPageList="css js class gif jpg jpeg png bmp"\r
-\r
-<br><br><hr>\r
-\r
-<a name="ValidHTTPCodes"><b>ValidHTTPCodes</b></a><br>\r
-<b>Version : </b>4.0 +<br>\r
-<br># By default, AWStats considers that records found in log file are successful\r
-<br># hits if HTTP code returned by server is a valid HTTP code (200 and 304).\r
-<br># Any other code are reported in HTTP error chart.\r
-<br># However in some specific environment, with web server HTTP redirection,\r
-<br># you can choose to also accept other codes.\r
-<br># Example: "200 304 302 305"\r
-<br># Default: "200 304"\r
-<br>#\r
-<br>ValidHTTPCodes="200 304"\r
-<br>\r
-<br><u>This is examples of current HTTP codes</u>\r
-<br><i>\r
-<br>#[Miscellaneous successes]\r
-<br>"2xx", "[Miscellaneous successes]",\r
-<br>"200", "OK",                                                               # HTTP request OK\r
-<br>"201", "Created",\r
-<br>"202", "Request recorded, will be executed later",\r
-<br>"203", "Non-authoritative information",\r
-<br>"204", "Request executed",\r
-<br>"205", "Reset document",\r
-<br>"206", "Partial Content",\r
-<br>#[Miscellaneous redirections]\r
-<br>"3xx", "[Miscellaneous redirections]",\r
-<br>"300", "Multiple documents available",\r
-<br>"301", "Moved Permanently",\r
-<br>"302", "Found",\r
-<br>"303", "See other document",\r
-<br>"304", "Not Modified since last retrieval",        # HTTP request OK\r
-<br>"305", "Use proxy",\r
-<br>"306", "Switch proxy",\r
-<br>"307", "Document moved temporarily",\r
-<br>#[Miscellaneous client/user errors]\r
-<br>"4xx", "[Miscellaneous client/user errors]",\r
-<br>"400", "Bad Request",\r
-<br>"401", "Unauthorized",\r
-<br>"402", "Payment required",\r
-<br>"403", "Forbidden",\r
-<br>"404", "Document Not Found",\r
-<br>"405", "Method not allowed",\r
-<br>"406", "ocument not acceptable to client",\r
-<br>"407", "Proxy authentication required",\r
-<br>"408", "Request Timeout",\r
-<br>"409", "Request conflicts with state of resource",\r
-<br>"410", "Document gone permanently",\r
-<br>"411", "Length required",\r
-<br>"412", "Precondition failed",\r
-<br>"413", "Request too long",\r
-<br>"414", "Requested filename too long",\r
-<br>"415", "Unsupported media type",\r
-<br>"416", "Requested range not valid",\r
-<br>"417", "Failed",\r
-<br>#[Miscellaneous server errors]\r
-<br>"5xx", "[Miscellaneous server errors]",\r
-<br>"500", "Internal server Error",\r
-<br>"501", "Not implemented",\r
-<br>"502", "Received bad response from real server",\r
-<br>"503", "Server busy",\r
-<br>"504", "Gateway timeout",\r
-<br>"505", "HTTP version not supported",\r
-<br>"506", "Redirection failed",\r
-<br>#[Unknown]\r
-<br>"xxx" ,"[Unknown]"\r
-</i>\r
-\r
-<br><br><hr>\r
-\r
-<a name="URLNotCaseSensitive"><b>URLNotCaseSensitive</b></a><br>\r
-<b>Version : </b>5.1 +<br>\r
-<br># Some web servers on some Operating systems (IIS-Windows) considers that two\r
-<br># URLs with same value but different case are the same URL. To tell AWStats to\r
-<br># also considers them as one, set this parameter to 1.\r
-<br># Possible values: 0 or 1\r
-<br># Default: 0\r
-<br># \r
-<br>URLNotCaseSensitive=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="URLWithQuery"><b>URLWithQuery</b></a><br>\r
-<b>Version : </b>3.2 +<br>\r
-<br># Keep or remove the query string to the URL in the statistics for individual\r
-<br># pages. This is primarily used to differentiate between the URLs of dynamic\r
-<br># pages. If set to 1, mypage.html?id=x and mypage.html?id=y are counted as two\r
-<br># different pages.\r
-<br># Warning, when set to 1, memory required to run AWStats is dramatically\r
-<br># increased if you have a lot of changing URLs (for example URLs with a random\r
-<br># id inside). Such web sites should not set this option to 1 or use seriously\r
-<br># the next parameter URLWithQueryWithoutFollowingParameters.\r
-<br># Possible values:\r
-<br># 0 - URLs are cleaned from the query string (ie: "/mypage.html")\r
-<br># 1 - Full URL with query string is used     (ie: "/mypage.html?p=x&q=y")\r
-<br># Default: 0\r
-<br># \r
-<br>URLWithQuery=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="URLWithQueryWithoutFollowingParameters"><b>URLWithQueryWithoutFollowingParameters</b></a><br>\r
-<b>Version : </b>5.1 +<br>\r
-<br># When URLWithQuery is on, you will get the full URL with all parameters in\r
-<br># URL reports. But among thoose parameters, sometimes you don't need a\r
-<br># particular parameter because it does not identify the page or because it's\r
-<br># a random ID changing for each access even if URL points to same page. In\r
-<br># such cases, it is higly recommanded to ask AWStats to remove such parameters\r
-<br># from the URL before counting, manipulating and storing it. Enter here list\r
-<br># of all non wanted parameters. For example if you enter "id", one hit on\r
-<br># /mypage.cgi?p=abc&id=Yo4UomP9d and /mypage.cgi?p=abc&id=Mu8fdxl3r\r
-<br># will be reported as 2 hits on /mypage.cgi?p=abc\r
-<br># This parameter is not used when URLWithQuery is 0.\r
-<br># Example: "PHPSESSID"\r
-<br># Default: ""\r
-<br># \r
-<br>URLWithQueryWithoutFollowingParameters=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="URLReferrerWithQuery"><b>URLReferrerWithQuery</b></a><br>\r
-<b>Version : </b>5.1 +<br>\r
-<br># Keep or remove the query string to the referrer URL in the statistics for\r
-<br># external referrer pages. This is used to differentiate between the URLs of\r
-<br># dynamic referrer pages. If set to 1, mypage.html?id=x and mypage.html?id=y\r
-<br># are counted as two different referrer pages.\r
-<br># Possible values:\r
-<br># 0 - Referrer URLs are cleaned from the query string (ie: "/mypage.html")\r
-<br># 1 - Full URL with query string is used      (ie: "/mypage.html?p=x&q=y")\r
-<br># Default: 0\r
-<br># \r
-<br>URLReferrerWithQuery=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="WarningMessages"><b>WarningMessages</b></a><br>\r
-<b>Version : </b>1.0 +<br>\r
-<br># AWStats can detect setup problems or show you important informations to have\r
-<br># a better use. Keep this to 1, except if AWStats says you can change it.\r
-<br># Possible values: 0 or 1\r
-<br># Default: 1\r
-<br>#\r
-<br>WarningMessages=1\r
-\r
-<br><br><hr>\r
-\r
-<a name="NbOfLinesForCorruptedLog"><b>NbOfLinesForCorruptedLog</b></a><br>\r
-<b>Version : </b>3.2 +<br>\r
-<br># To help you to detect if your log format is good, AWStats report an error\r
-<br># if all the first NbOfLinesForCorruptedLog lines have a format that does not\r
-<br># match the LogFormat parameter.\r
-<br># However, some worm virus attack on your web server can result in a very high\r
-<br># number of corrupted lines in your log. So if you experience awstats stop\r
-<br># because of bad virus records at the beginning of your log file, you can\r
-<br># increase this parameter (very rare).\r
-<br># Default: 50\r
-<br>#\r
-<br>NbOfLinesForCorruptedLog=50\r
-\r
-<br><br><hr>\r
-\r
-<a name="SplitSearchString"><b>SplitSearchString</b></a><br>\r
-<b>Version : </b>2.24 - 4.0 (deprecated since 4.1)<br>\r
-AWStats 4.1+ supports both keywords AND keyphrases by default with no need of any parameter.<br>\r
-<font color="#808080">\r
-<br># Search engines keywords reported are full search string or separate keywords\r
-<br># Possible values:\r
-<br># 0 - Search keywords reported are full search string (ie: "town maps")\r
-<br># 1 - Search keywords reported are separated words (ie: "town" and "maps")\r
-<br># Default: 0\r
-<br>#\r
-<br>SplitSearchString=0\r
-</font>\r
-\r
-<br><br><hr>\r
-\r
-<a name="WrapperScript"><b>WrapperScript</b></a><br>\r
-<b>Version : </b>4.0 +<br>\r
-<br># For some particular integration needs, you may want to have CGI links to\r
-<br># point to another script than awstats.pl.\r
-<br># Use the name of this script in WrapperScript parameter.\r
-<br># Example: "awstatslauncher.pl"\r
-<br># Default: ""\r
-<br>#\r
-<br>WrapperScript=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="DecodeUA"><b>DecodeUA</b></a><br>\r
-<b>Version : </b>5.0 +<br>\r
-<br># DecodeUA must be set to 1 if you use Roxen web server. This server converts\r
-<br># all spaces in user agent field into %20. This make the AWStats robots, os\r
-<br># and browsers detection fail in some cases. Just change it to 1 if and only\r
-<br># if your web server is Roxen.\r
-<br># Possible values: 0 or 1\r
-<br># Default: 0\r
-<br>#\r
-<br>DecodeUA=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="LevelFor"><b>LevelFor</b></a><br>\r
-<b>Version : </b>4.0 +<br>\r
-<br># Following values allows you to disable/enable some AWStats features.\r
-<br># Possible values: 0, 1 (or 2 for LevelForRobotsDetection)\r
-<br># Default: 1 (2 for LevelForRobotsDetection)\r
-<br>#\r
-<br>LevelForRobotsDetection=2                  # 0 will increase AWStats speed by 1%.\r
-<br>LevelForBrowsersDetection=1                        # 0 disables Browsers detection. No speed gain.\r
-<br>LevelForOSDetection=1                              # 0 disables OS detection. No speed gain.\r
-<br>LevelForRefererAnalyze=1                   # 0 will increase AWStats speed by 5%.\r
-\r
-<br><br><hr>\r
-\r
-<a name="UseFramesWhenCGI"><b>UseFramesWhenCGI</b></a><br>\r
-<b>Version : </b>5.0 +<br>\r
-<br># When you use AWStats as a CGI, you can have the reports shown in HTML views.\r
-<br># Frames are only available for report viewed dynamically. When you build\r
-<br># pages from command line, this option is not used and no frames are built.\r
-<br># Possible values: 0 or 1\r
-<br># Default: 1\r
-<br>#\r
-<br>UseFramesWhenCGI=1\r
-\r
-<br><br><hr>\r
-\r
-<a name="DetailedReportsOnNewWindows"><b>DetailedReportsOnNewWindows</b></a><br>\r
-<b>Version : </b>4.1 + (5.0 + for value 2)<br>\r
-<br># This parameter ask your browser to open detailed reports into a different\r
-<br># window than the main page.\r
-<br># Possible values:\r
-<br># 0 - Open all in same browser window\r
-<br># 1 - Open detailed reports in another window except if using frames\r
-<br># 2 - Open always in a different window even if reports are framed\r
-<br># Default: 1\r
-<br>#\r
-<br>DetailedReportsOnNewWindows=1\r
-\r
-<br><br><hr>\r
-\r
-<a name="Expires"><b>Expires</b></a><br>\r
-<b>Version : </b>3.1 +<br>\r
-<br># You can add in the HTML report page a delay to force browsers to not use cache\r
-<br># if page is loaded a second time after this delay (in seconds).\r
-<br># This parameter is not used when report are built with -staticlinks option.\r
-<br># Example: 3600\r
-<br># Default: 0\r
-<br>#\r
-<br>Expires=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="MaxRowsInHTMLOutput"><b>MaxRowsInHTMLOutput</b></a><br>\r
-<b>Version : </b>4.0 +<br>\r
-<br># To avoid too large web pages, you can ask AWStats to limit number of rows of\r
-<br># all reported charts to this number when no other limit apply.\r
-<br># Default: 1000\r
-<br>#\r
-<br>MaxRowsInHTMLOutput=1000\r
-\r
-<br><br><hr>\r
-\r
-<a name="Lang"><b>Lang</b></a><br>\r
-<b>Version : </b>2.1 +<br>\r
-<br># Set your primary language.\r
-<br># Possible value:\r
-<br>#  Bosnian=ba, Chinese (Taiwan)=tw, Chinese (Traditional)=cn, Czech=cz,\r
-<br>#  Danish=dk, Dutch=nl, English=en, Finnish=fi, French=fr, German=de,\r
-<br>#  Greek=gr, Hungarian=hu, Indonesian=id, Italian=it, Japanese=jp, Korean=kr,\r
-<br>#  Latvian=lv, Norwegian (Nynorsk)=nn, Norwegian (Bokmal)=nb, Polish=pl,\r
-<br>#  Portuguese=pt, Portuguese (Brazilian)=br, Romanian=ro, Russian=ru,\r
-<br>#  Slovak=sk, Spanish=es, Swedish=se, Turkish=tr, Ukrainian=ua\r
-<br># Default: "en"\r
-<br>#\r
-<br>Lang="en"\r
-\r
-<br><br><hr>\r
-\r
-<a name="DirLang"><b>DirLang</b></a><br>\r
-<b>Version : </b>2.1 +<br>\r
-<br># Set the location of language files.\r
-<br># Example: "/opt/awstats/lang"\r
-<br># Default: "./lang" (means lang directory is in same location than awstats.pl)\r
-<br>#\r
-<br>DirLang="./lang"\r
-\r
-<br><br><hr>\r
-\r
-<a name="Show"><b>Show...</b></a><br>\r
-<b>Version : </b><br>\r
-3.2 for ShowHeader,ShowMenu,ShowMonthDayStats,ShowDaysOfWeekStats,ShowHoursStats,\r
-ShowDomainsStats,ShowHostsStats,ShowAuthenticatedUsers,ShowRobotsStats,\r
-ShowPagesStats,ShowFileTypesStats,ShowFileSizesStats,ShowBrowsersStats,\r
-ShowOSStats,ShowOriginStats,ShowKeyphrasesStats,ShowKeywordsStats,ShowHTTPErrorsStats<br>\r
-3.2 - 5.0 for ShowCompressionStats (deprecated since 5.1, use code C with ShowFileTypesStats instead)<br>\r
-4.1 for ShowSessionsStats, ShowKeywordsStats<br>\r
-5.1 for all letters codes<br>\r
-<br># You choose here which reports you want to see in the main page and what you\r
-<br># want to see in those reports.\r
-<br># Possible values:\r
-<br>#  0  - Topic is not shown at all\r
-<br>#  1  - Report is shown with default informations\r
-<br># XYZ - Report is shown with only informations defined by code X,Y,Z\r
-<br>#       X,Y,Z are code letters among the following:\r
-<br>#        U = Unique visitors\r
-<br>#        V = Visits\r
-<br>#        P = Number of pages\r
-<br>#        H = Number of hits\r
-<br>#        B = Bandwith\r
-<br>#        L = Last access date\r
-<br>#        E = Entry pages\r
-<br>#        X = Exit pages\r
-<br>#        C = Web compression (mod_gzip)\r
-<br>#        M = Average mail size (mail logs)\r
-<br>#\r
-<br># Show AWStats head title and icon\r
-<br># Default: 1, Possible codes: None\r
-<br>ShowHeader=1                               \r
-<br># Show menu header with links on detailed reports\r
-<br># Default: 1, Possible codes: None\r
-<br>ShowMenu=1                                 \r
-<br># Show monthly and daily chart\r
-<br># Default: UVPHB, Possible codes: UVPHB\r
-<br>ShowMonthDayStats=UVPHB\r
-<br># Show days of week chart\r
-<br># Default: PHB, Possible codes: PHB\r
-<br>ShowDaysOfWeekStats=PHB\r
-<br># Show hourly chart\r
-<br># Default: PHB, Possible codes: PHB\r
-<br>ShowHoursStats=PHB\r
-<br># Show domains/country chart\r
-<br># Default: 1, Possible codes: None\r
-<br>ShowDomainsStats=1\r
-<br># Show hosts chart\r
-<br># Default: PHBL, Possible codes: PHBL\r
-<br>ShowHostsStats=PHBL\r
-<br># Show authenticated users chart\r
-<br># Default: 0, Possible codes: PHBL\r
-<br>ShowAuthenticatedUsers=0\r
-<br># Show robots chart\r
-<br># Default: 1, Possible codes: None\r
-<br>ShowRobotsStats=1\r
-<br># Show EMail senders chart (For use when analyzing mail log files)\r
-<br># Default: HBML, Possible codes: HBML\r
-<br>ShowEMailSenders=HBML\r
-<br># Show EMail receiver chart (For use when analyzing mail log files)\r
-<br># Default: HBML, Possible codes: HBML\r
-<br>ShowEMailReceivers=HBML\r
-<br># Show session chart\r
-<br># Default: 1, Possible codes: None\r
-<br>ShowSessionsStats=1\r
-<br># Show pages-url chart.\r
-<br># Default: HBEX, Possible codes: HBEX\r
-<br>ShowPagesStats=HBEX        \r
-<br># Show file types chart.\r
-<br># Default: HB, Possible codes: HBC\r
-<br>ShowFileTypesStats=HB\r
-<br># Show file size chart (Not yet available)\r
-<br># Default: 1, Possible codes: None\r
-<br>ShowFileSizesStats=0               \r
-<br># Show browsers chart\r
-<br># Default: 1, Possible codes: None\r
-<br>ShowBrowsersStats=1\r
-<br># Show Operating systems chart\r
-<br># Default: 1, Possible codes: None\r
-<br>ShowOSStats=1\r
-<br># Show Origin chart\r
-<br># Default: PH, Possible codes: HB\r
-<br>ShowOriginStats=PH\r
-<br># Show keyphrases chart\r
-<br># Default: 1, Possible codes: None\r
-<br>ShowKeyphrasesStats=1\r
-<br># Show keywords chart\r
-<br># Default: 1, Possible codes: None\r
-<br>ShowKeywordsStats=1\r
-<br># Show HTTP errors chart\r
-<br># Default: 1, Possible codes: None\r
-<br>ShowHTTPErrorsStats=1\r
-\r
-<br><br><hr>\r
-\r
-<a name="Max"><b>Max...</b></a><br>\r
-<b>Version : </b>1.0 +<br>\r
-<br># This value can be used to choose maximum number of lines shown for each \r
-<br># particular reporting.\r
-<br>#\r
-<br># Stats by domains\r
-<br>MaxNbOfDomain = 25\r
-<br># Stats by hosts\r
-<br>MaxNbOfHostsShown = 25\r
-<br>MinHitHost    = 1\r
-<br># Stats by authenticated users\r
-<br>MaxNbOfLoginShown = 10\r
-<br>MinHitLogin   = 1\r
-<br># Stats by robots\r
-<br>MaxNbOfRobotShown = 25\r
-<br>MinHitRobot   = 1\r
-<br># Stats by pages\r
-<br>MaxNbOfPageShown = 25\r
-<br>MinHitFile    = 1\r
-<br># Stats by referers\r
-<br>MaxNbOfRefererShown = 25\r
-<br>MinHitRefer   = 1\r
-<br># Stats for keywords\r
-<br>MaxNbOfKeywordsShown = 25\r
-<br>MinHitKeyword  = 1\r
-\r
-<br><br><hr>\r
-\r
-<a name="FirstDayOfWeek"><b>FirstDayOfWeek</b></a><br>\r
-<b>Version : </b>3.2 +<br>\r
-<br># Choose if you want week to start on sunday or monday\r
-<br># Possible values:\r
-<br># 0 - Week start on sunday\r
-<br># 1 - Week start on monday\r
-<br># Default: 1\r
-<br>#\r
-<br>FirstDayOfWeek=1\r
-\r
-<br><br><hr>\r
-\r
-<a name="ShowFlagLinks"><b>ShowFlagLinks</b></a><br>\r
-<b>Version : </b>3.2 +<br>\r
-<br># List of visible flags with link to other language translations.\r
-<br># See Lang parameter for list of allowed flag/language codes.\r
-<br># If you don't want any flag link, set ShowFlagLinks to "".\r
-<br># This parameter is used only if ShowHeader parameter is set to 1.\r
-<br># Possible values: "" or "language_codes_separated_by_space"\r
-<br># Default: "en es fr it nl es"\r
-<br>#\r
-<br>ShowFlagLinks="en fr de it nl es"\r
-\r
-<br><br><hr>\r
-\r
-<a name="ShowLinksOnUrl"><b>ShowLinksOnUrl</b></a><br>\r
-<b>Version : </b>3.1 +<br>\r
-<br># Each URL shown in stats report views are links you can click.\r
-<br># Possible values: 0 or 1\r
-<br># Default: 1\r
-<br>#\r
-<br>ShowLinksOnUrl=1\r
-\r
-<br><br><hr>\r
-\r
-<a name="MaxLengthOfURL"><b>MaxLengthOfURL</b></a><br>\r
-<b>Version : </b>1.0 +<br>\r
-<br># Maximum length of URL shown on stats page (number of characters). This\r
-<br># affects only URL visible text, link still work.\r
-<br># Default: 72\r
-<br>#\r
-<br>MaxLengthOfURL=72\r
-\r
-<br><br><hr>\r
-\r
-<a name="ShowLinksToWhoIs"><b>ShowLinksToWhoIs</b></a><br>\r
-<b>Version : </b>4.0 +<br>\r
-<br># AWStats can include a link to WhoIs database on all hostnames/ip. For this, you\r
-<br># must set ShowLinksToWhoIs to 1. Warning, a such feature depends on two next\r
-<br># parameter (LinksToWhoIs and LinksToIPWhoIs) and on WhoIs server\r
-<br># exhaustivity and availability.\r
-<br># For this reason, this feature can't be a reliable feature.\r
-<br># Possible values: 0 or 1\r
-<br># Default: 0\r
-<br>#\r
-<br>ShowLinksToWhoIs=0\r
-\r
-<br><br><hr>\r
-\r
-<a name="LinksToWhoIs"><b>LinksToWhoIs</b></a><br>\r
-<b>Version : </b>4.0 +<br>\r
-<br># Set here the link used to point to Internet WhoIs database for hostnames.\r
-<br># This parameter is not used if ShowLinksToWhoIs is 0.\r
-<br># Default: "http://www.whois.net/search.cgi2?str="\r
-<br># Example: "http://www.netsol.com/cgi-bin/whois/whois?SearchType=all&STRING="\r
-<br># Example: "http://www.ripe.net/perl/whois?form_type=simple&searchtext="\r
-<br># Example: "http://www.arin.net/cgi-bin/whois.pl?queryinput="\r
-<br>#\r
-<br>LinksToWhoIs="http://www.whois.net/search.cgi2?str="\r
-\r
-<br><br><hr>\r
-\r
-<a name="LinksToIPWhoIs"><b>LinksToIPWhoIs</b></a><br>\r
-<b>Version : </b>5.0 +<br>\r
-<br># Set here the link used to point to Internet WhoIs database for ip addresses.\r
-<br># This parameter is not used if ShowLinksToWhoIs is 0.\r
-<br># Default: "http://ws.arin.net/cgi-bin/whois.pl?queryinput="\r
-<br># Example: "http://ws.arin.net/cgi-bin/whois.pl?queryinput="\r
-<br>#\r
-<br>LinksToIPWhoIs="http://ws.arin.net/cgi-bin/whois.pl?queryinput="\r
-\r
-<br><br><hr>\r
-\r
-<a name="HTMLHeadSection"><b>HTMLHeadSection</b></a><br>\r
-<b>Version : </b>3.2 +<br>\r
-<br># You can enter HTML code that will be added at the top of AWStats reports.\r
-<br># Default: ""\r
-<br>#\r
-<br>HTMLHeadSection=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="HTMLEndSection"><b>HTMLEndSection</b></a><br>\r
-<b>Version : </b>3.2 +<br>\r
-<br># You can enter HTML code that will be added at the end of AWStats reports.\r
-<br># Great to add advert ban.\r
-<br># Default: ""\r
-<br>#\r
-<br>HTMLEndSection=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="Bar"><b>Bar...</b></a><br>\r
-<b>Version : </b>1.0 +<br>\r
-<br># Value of maximum bar width/heigth for horizontal/vertical graphics bar\r
-<br># Default: 260/90\r
-<br>#\r
-<br>BarWidth   = 260\r
-<br>BarHeight  = 90\r
-\r
-<br><br><hr>\r
-\r
-<a name="Logo"><b>Logo...</b></a><br>\r
-<b>Version : </b>3.1 +<br>\r
-<br># You can set Logo and LogoLink to use your own logo.\r
-<br># Logo must be the name of image file (must be in $DirIcons/other directory).\r
-<br># LogoLink is the expected URL when clicking on Logo.\r
-<br># Default: "awstats_logo1.png"\r
-<br>#\r
-<br>Logo="awstats_logo1.png"\r
-<br>LogoLink="http://awstats.sourceforge.net"\r
-\r
-<br><br><hr>\r
-\r
-<a name="StyleSheet"><b>StyleSheet</b></a><br>\r
-<b>Version : </b>4.0 +<br>\r
-<br># You can ask AWStats to use a particular CSS (Cascading Style Sheet) to\r
-<br># change its look.\r
-<br># Example: "/css/awstats.css"\r
-<br># Default: ""\r
-<br>#\r
-<br>StyleSheet=""\r
-\r
-<br><br><hr>\r
-\r
-<a name="color_"><b>color_...</b></a><br>\r
-<b>Version : </b><br>\r
-3.1 for color_Background,color_TableBGTitle,color_TableTitle,color_TableBG,\r
-color_TableRowTitle,color_TableBGRowTitle,color_TableBorder,color_text,\r
-color_textpercent,color_titletext,color_weekend,color_link,color_hover,\r
-color_u,color_v,color_p,color_h,color_k,color_s<br>\r
-4.1 for color_e,color_x<br>\r
-5.0 for color_other<br>\r
-<br># Those colors parameters can be used (if StyleSheet parameter is not used)\r
-<br># to change AWStats look.\r
-<br># Example: color_name="RRGGBB"     # RRGGBB is Red Green Blue components in Hex\r
-<br>#\r
-<br>color_Background="FFFFFF"          # Background color for main page (Default = "FFFFFF")\r
-<br>color_TableBGTitle="CCCCDD"                # Background color for table title (Default = "CCCCDD")\r
-<br>color_TableTitle="000000"          # Table title font color (Default = "000000")\r
-<br>color_TableBG="CCCCDD"                     # Background color for table (Default = "CCCCDD")\r
-<br>color_TableRowTitle="FFFFFF"       # Table row title font color (Default = "FFFFFF")\r
-<br>color_TableBGRowTitle="ECECEC"     # Background color for row title (Default = "ECECEC")\r
-<br>color_TableBorder="ECECEC"         # Table border color (Default = "ECECEC")\r
-<br>color_text="000000"                                # Color of text (Default = "000000")\r
-<br>color_textpercent="606060"         # Color of text for percent values (Default = "606060")\r
-<br>color_titletext="000000"           # Color of text title within colored Title Rows (Default = "000000")\r
-<br>color_weekend="EAEAEA"                     # Color for week-end days (Default = "EAEAEA")\r
-<br>color_link="0011BB"                                # Color of HTML links (Default = "0011BB")\r
-<br>color_hover="605040"                       # Color of HTML on-mouseover links (Default = "605040") \r
-<br>color_other="666688"                       # Color of text for 'other' record in charts (Default = "666688") \r
-<br>color_u="FFB055"                           # Background color for number of unique visitors (Default = "FFB055")\r
-<br>color_v="F8E880"                           # Background color for number of visites (Default = "F8E880")\r
-<br>color_p="4477DD"                           # Background color for number of pages (Default = "4477DD")\r
-<br>color_h="66F0FF"                           # Background color for number of hits (Default = "66F0FF")\r
-<br>color_k="2EA495"                           # Background color for number of bytes (Default = "2EA495")\r
-<br>color_s="8888DD"                           # Background color for number of search (Default = "8888DD")\r
-<br>color_e="CEC2E8"                           # Background color for number of entry pages (Default = "CEC2E8")\r
-<br>color_x="C1B2E2"                           # Background color for number of exit pages (Default = "C1B2E2")\r
-\r
-<br><br><hr>\r
-\r
-<a name="LoadPlugin"><b>LoadPlugin</b></a><br>\r
-<b>Version : </b>5.0 +<br>\r
-<br># Add here all plugins file you want to load.\r
-<br># Plugin files must be .pm files stored in 'plugins' directory.\r
-<br># Uncomment LoadPlugin lines to enable a plugin after checking that plugin\r
-<br># required perl modules are installed.\r
-<br>\r
-<br># Plugin: PluginName\r
-<br># PluginName description\r
-<br># Perl modules required: ...\r
-<br>#\r
-<br>LoadPlugin="pluginname"\r
-\r
-<br><br><hr>\r
-\r
-<a name="include"><b>#include</b></a><br>\r
-<b>Version : </b>5.1 +<br>\r
-<br># You can include other config files using the directive with the name of the\r
-<br># config file (like Apache, so you must keep the '#' before 'include').\r
-<br># This is particularly usefull for users who have a lot of virtual servers, so\r
-<br># a lot of config files and want to maintain common values in only one file.\r
-<br># Note that when a variable is defined both in a config file and in an\r
-<br># included file, AWStats will use the last value read.\r
-<br>#\r
-<br>#include ""\r
-\r
-\r
-<!-- -------------------------------------------------------------------------------------- -->\r
-\r
-<br><br><hr>\r
-\r
-<script language=javascript>\r
-       var lastmod = new Date(document.lastModified);\r
-       if (lastmod.getDate() > 0) {\r
-               if (lastmod.getDate()<10) zerod="0"\r
-               else zerod="";\r
-               if (lastmod.getMonth()<9) zerom="0"\r
-               else zerom=""\r
-               year2kok=lastmod.getYear();\r
-               if (year2kok<100) year2kok+=2000;\r
-               if ((year2kok>=100) && (year2kok < 1970)) year2kok+=1900;\r
-               document.writeln("Last revision: "+year2kok+"-"+zerom+(lastmod.getMonth()+1)+"-"+zerod+lastmod.getDate());\r
-       }\r
-</script>\r
-\r
-</body>\r
-</html>\r
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta name="description" content="AWStats Documentation - Configuration directives and parameters">
+<meta name="keywords" content="awstats, awstat, config, parameters, configuration, conf">
+<meta name="robots" content="index,follow">
+<meta name="title" content="AWStats Documentation - Configuration directives and parameters">
+<title>AWStats Documentation - Configuration directives and parameters</title>
+<link rel="stylesheet" href="styles.css" type="text/css">
+<!-- $Revision$ - $Author$ - $Date$ -->
+</head>
+
+<body topmargin=10 leftmargin=5>
+
+
+<table style="font: 10pt arial,helvetica,verdana" cellpadding=0 cellspacing=0 border=0 bgcolor=#FFFFFF width=100%>
+
+<!-- Large -->
+<tr style="font: 10pt arial,helvetica,verdana">
+<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
+<td bgcolor=#9999cc align=center>
+<br>
+<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 5.1 Documentation</b></font><br>
+<br>
+</td>
+<td bgcolor=#9999cc align=center>
+&nbsp;
+</td>
+</tr>
+
+</table>
+
+
+<br><br><H1 style="font: 26px arial,helvetica,sanserif">AWStats configuration directives/options</H1>
+<!-- -------------------------------------------------------------------------------------- -->
+
+<br>Each directives available in the AWStats config file (.conf) is listed here.<br>
+They are described using a consistent format.<br>
+<br>
+<b>Notes</b>
+To include an environment variable in any parameter (AWStats will replace it with its value
+when reading it), follow the example:<br>
+<i>Parameter="__ENVNAME__"</i>
+<br>
+<br>
+<br>
+<br><b>MAIN SETUP SECTION (Required to make AWStats work)</b><br>
+<ul>
+<li><a href="#LogFile">LogFile</a>
+<li><a href="#LogFormat">LogFormat</a>
+<li><a href="#LogSeparator">LogSeparator</a>
+<li><a href="#DNSLookup">DNSLookup</a>
+<li><a href="#DirData">DirData</a>
+<li><a href="#DirCgi">DirCgi</a>
+<li><a href="#DirIcons">DirIcons</a>
+<li><a href="#SiteDomain">SiteDomain</a>
+<li><a href="#HostAliases">HostAliases</a>
+<li><a href="#AllowToUpdateStatsFromBrowser">AllowToUpdateStatsFromBrowser</a>
+</ul>
+
+
+<br><b>OPTIONAL SETUP SECTION (Not required but increase AWStats features)</b><br>
+<ul>
+<li><a href="#EnableLockForUpdate">EnableLockForUpdate</a>
+<li><a href="#DNSStaticCacheFile">DNSStaticCacheFile</a>
+<li><a href="#DNSLastUpdateCacheFile">DNSLastUpdateCacheFile</a>
+<li><a href="#SkipDNSLookupFor">SkipDNSLookupFor</a>
+<li><a href="#AllowAccessFromWebToAuthenticatedUsersOnly">AllowAccessFromWebToAuthenticatedUsersOnly</a>
+<li><a href="#AllowAccessFromWebToFollowingAuthenticatedUsers">AllowAccessFromWebToFollowingAuthenticatedUsers</a>
+<li><a href="#AllowAccessFromWebToFollowingIPAddresses">AllowAccessFromWebToFollowingIPAddresses</a>
+<li><a href="#CreateDirDataIfNotExists">CreateDirDataIfNotExists</a>
+<li><a href="#SaveDatabaseFilesWithPermissionsForEveryone">SaveDatabaseFilesWithPermissionsForEveryone</a>
+<li><a href="#PurgeLogFile">PurgeLogFile</a>
+<li><a href="#ArchiveLogRecords">ArchiveLogRecords</a>
+<li><a href="#KeepBackupOfHistoricFiles">KeepBackupOfHistoricFiles</a>
+<li><a href="#DefaultFile">DefaultFile</a>
+<li><a href="#SkipHosts">SkipHosts</a>
+<li><a href="#SkipUserAgents">SkipUserAgents</a>
+<li><a href="#SkipFiles">SkipFiles</a>
+<li><a href="#OnlyHosts">OnlyHosts</a>
+<li><a href="#OnlyFiles">OnlyFiles</a>
+<li><a href="#NotPageList">NotPageList</a>
+<li><a href="#ValidHTTPCodes">ValidHTTPCodes</a>
+<li><a href="#URLNotCaseSensitive">URLNotCaseSensitive</a>
+<li><a href="#URLWithQuery">URLWithQuery</a>
+<li><a href="#URLWithQueryWithoutFollowingParameters">URLWithQueryWithoutFollowingParameters</a>
+<li><a href="#URLReferrerWithQuery">URLReferrerWithQuery</a>
+<li><a href="#WarningMessages">WarningMessages</a>
+<li><a href="#NbOfLinesForCorruptedLog">NbOfLinesForCorruptedLog</a>
+<li><a href="#SplitSearchString">SplitSearchString</a>
+<li><a href="#WrapperScript">WrapperScript</a>
+<li><a href="#DecodeUA">DecodeUA</a>
+</ul>
+
+<br><b>OPTIONAL ACCURACY SETUP SECTION (Not required but increase AWStats features)</b><br>
+<ul>
+<li><a href="#LevelFor">LevelForRobotsDetection</a>
+<li><a href="#LevelFor">LevelForBrowsersDetection</a>
+<li><a href="#LevelFor">LevelForOSDetection</a>
+<li><a href="#LevelFor">LevelForRefererAnalyze</a>
+</ul>
+
+<br><b>OPTIONAL APPEARANCE SETUP SECTION (Not required but increase AWStats features)</b><br>
+<ul>
+<li><a href="#UseFramesWhenCGI">UseFramesWhenCGI</a>
+<li><a href="#DetailedReportsOnNewWindows">DetailedReportsOnNewWindows</a>
+<li><a href="#Expires">Expires</a>
+<li><a href="#MaxRowsInHTMLOutput">MaxRowsInHTMLOutput</a>
+<li><a href="#Lang">Lang</a>
+<li><a href="#DirLang">DirLang</a>
+<li><a href="#Show">ShowHeader</a>
+<li><a href="#Show">ShowMenu</a>
+<li><a href="#Show">ShowMonthDayStats</a>
+<li><a href="#Show">ShowDaysOfWeekStats</a>
+<li><a href="#Show">ShowHoursStats</a>
+<li><a href="#Show">ShowDomainsStats</a>
+<li><a href="#Show">ShowHostsStats</a>
+<li><a href="#Show">ShowAuthenticatedUsers</a>
+<li><a href="#Show">ShowRobotsStats</a>
+<li><a href="#Show">ShowSessionsStats</a>
+<li><a href="#Show">ShowPagesStats</a>
+<li><a href="#Show">ShowCompressionStats</a>
+<li><a href="#Show">ShowFileTypesStats</a>
+<li><a href="#Show">ShowFileSizesStats</a>
+<li><a href="#Show">ShowBrowsersStats</a>
+<li><a href="#Show">ShowOSStats</a>
+<li><a href="#Show">ShowOriginStats</a>
+<li><a href="#Show">ShowKeyphrasesStats</a>
+<li><a href="#Show">ShowKeywordsStats</a>
+<li><a href="#Show">ShowHTTPErrorsStats</a>
+<li><a href="#Max">MaxNbOfDomain</a>
+<li><a href="#Max">MaxNbOfHostsShown</a>
+<li><a href="#Max">MinHitHost</a>
+<li><a href="#Max">MaxNbOfLoginShown</a>
+<li><a href="#Max">MinHitLogin</a>
+<li><a href="#Max">MaxNbOfRobotShown</a>
+<li><a href="#Max">MinHitRobot</a>
+<li><a href="#Max">MaxNbOfPageShown</a>
+<li><a href="#Max">MinHitFile</a>
+<li><a href="#Max">MaxNbOfRefererShown</a>
+<li><a href="#Max">MinHitRefer</a>
+<li><a href="#Max">MaxNbOfKeywordsShown</a>
+<li><a href="#Max">MinHitKeyword</a>
+<li><a href="#FirstDayOfWeek">FirstDayOfWeek</a>
+<li><a href="#ShowFlagLinks">ShowFlagLinks</a>
+<li><a href="#ShowLinksOnUrl">ShowLinksOnUrl</a>
+<li><a href="#MaxLengthOfURL">MaxLengthOfURL</a>
+<li><a href="#ShowLinksToWhoIs">ShowLinksToWhoIs</a>
+<li><a href="#LinksToWhoIs">LinksToWhoIs</a>
+<li><a href="#LinksToIPWhoIs">LinksToIPWhoIs</a>
+<li><a href="#HTMLHeadSection">HTMLHeadSection</a>
+<li><a href="#HTMLEndSection">HTMLEndSection</a>
+<li><a href="#Bar">BarWidth</a>
+<li><a href="#Bar">BarHeight</a>
+<li><a href="#Logo">Logo</a>
+<li><a href="#Logo">LogoLink</a>
+<li><a href="#StyleSheet">StyleSheet</a>
+<li><a href="#color_">color_Background</a>
+<li><a href="#color_">color_TableBGTitle</a>
+<li><a href="#color_">color_TableTitle</a>
+<li><a href="#color_">color_TableBG</a>
+<li><a href="#color_">color_TableRowTitle</a>
+<li><a href="#color_">color_TableBGRowTitle</a>
+<li><a href="#color_">color_TableBorder</a>
+<li><a href="#color_">color_text</a>
+<li><a href="#color_">color_titletext</a>
+<li><a href="#color_">color_weekend</a>
+<li><a href="#color_">color_link</a>
+<li><a href="#color_">color_hover</a>
+<li><a href="#color_">color_u</a>
+<li><a href="#color_">color_v</a>
+<li><a href="#color_">color_p</a>
+<li><a href="#color_">color_h</a>
+<li><a href="#color_">color_k</a>
+<li><a href="#color_">color_s</a>
+<li><a href="#color_">color_e</a>
+<li><a href="#color_">color_x</a>
+</ul>
+
+<br><b>PLUGINS</b><br>
+<ul>
+<li><a href="#LoadPlugin">LoadPlugin</a>
+</ul>
+
+<br><b>INLUDES</b><br>
+<ul>
+<li><a href="#include">#include</a>
+</ul>
+
+
+
+<br><br><hr>
+
+<a name="LogFile"><b>LogFile</b></a><br>
+<b>Version : </b>1.0 +<br>
+3.1+ for tags %YYYY-n,%YY-n,%MM-n,%DD-n,%HH-n<br>
+3.2+ for tag %WM-n<br>
+4.0+ for tag %DW-n<br>
+4.1+ for tag %NS-n<br>
+5.0+ for tag %WY-n<br>
+5.1+ for tag %Wm-n, %Wy-n, %Dw-n<br>
+<br># "LogFile" contains the web server logfile to analyze.
+<br># You can use a full path or relative path from awstats.pl directory.
+<br># Example: "/var/log/apache/access.log"
+<br># Example: "../logs/mycombinedlog.log"
+<br># You can also use tags in this filename if you need a dynamic file name
+<br># depending on date or time (Replacement is made by AWStats at the beginning
+<br># of its execution). This is available tags :
+<br>#   %YYYY-n  is replaced with 4 digits year we were n hours ago
+<br>#   %YY-n    is replaced with 2 digits year we were n hours ago
+<br>#   %MM-n    is replaced with month we were n hours ago
+<br>#   %DD-n    is replaced with day we were n hours ago
+<br>#   %HH-n    is replaced with hour we were n hours ago
+<br>#   %NS-n    is replaced with number of seconds at 00:00 since 1970
+<br>#   %WM-n    is replaced with the week number in month (1-5)
+<br>#   %Wm-n    is replaced with the week number in month (0-4)
+<br>#   %WY-n    is replaced with the week number in year (1-52)
+<br>#   %Wy-n    is replaced with the week number in year (0-51)
+<br>#   %DW-n    is replaced with the day number in week (1-7, 1=sunday)
+<br>#                              use n=24 if you need (1-7, 1=monday)
+<br>#   %Dw-n    is replaced with the day number in week (0-6, 0=sunday)
+<br>#                              use n=24 if you need (0-6, 0=monday)
+<br>#   Use 0 for n if you need current year, month, day, hour...
+<br># Example: "/var/log/access_log.%YYYY-0%MM-0%DD-0.log"
+<br># Example: "C:/WINNT/system32/LogFiles/W3SVC1/ex%YY-24%MM-24%DD-24.log"
+<br># You can also use a pipe if log file come from a pipe.
+<br># Example: "gzip -d &lt;/var/log/apache/access.log.gz |"
+<br>#
+<br>LogFile="/var/log/httpd/mylog.log"
+
+<br><br><hr>
+
+<a name="LogFormat"><b>LogFormat</b></a><br>
+<b>Version : </b>2.1 +<br>
+3.1+ for tags %host,%logname,%time1,%time2,%methodurl,%methodurlnoprot,%method,%url,
+%query,%code,%bytesd,%refererquot,%referer,%uaquot,%ua,%other<br>
+3.2+ for tags %gzipin,%gzipout<br>
+4.0+ for tags %gzipratio,%syslog<br>
+4.1+ for tag  %virtualname<br>
+<br># Enter here your log format (Must agree with your web server. See setup
+<br># instructions in README.txt to know how to configure your web server to have
+<br># the required log format).
+<br># Possible values: 1,2,3,4,5,6 or "your_own_personalized_log_format"
+<br># 1 - Apache native combined log format (NCSA combined/XLF/ELF log format)
+<br># 2 - IIS log format (W3C log format)
+<br># 3 - Webstar native log format
+<br># 4 - Apache or Squid native common log format (NCSA common log format)
+<br>#     With LogFormat=4, some features (browsers, os, keywords...) can't work.
+<br># 5 - ISA server standard log format
+<br># 6 - Lotus Notes combined log format
+<br># "your_own_personalized_log_format" = If your log is a personalized format,
+<br>#   you must use the following syntax keys to define the log format string:
+<br>#   %host             Host client name or IP address
+<br>#   %logname          Authenticated login/user used on protected pages
+<br>#   %time1            Date and time with format: [dd/mmm/yyyy:hh:mm:ss +0000]
+<br>#   %time1b           Date and time with format: [dd/mmm/yyyy:hh:mm:ss]
+<br>#   %time2            Date and time with format: yyyy-mm-dd hh-mm-ss
+<br>#   %methodurl        Method and URL with format: "GET /index.html HTTP/x.x"
+<br>#   %methodurlnoprot  Method and URL with format: "GET /index.html"
+<br>#   %method           Method with format: GET
+<br>#   %url              URL only with format: /index.html
+<br>#   %query            Query string (used by URLWithQuery option)
+<br>#   %code             Return code status (with format for web log: 999)
+<br>#   %bytesd           Size of document in bytes
+<br>#   %refererquot      Referer page with format: "http://from.com/from.htm"
+<br>#   %referer          Referer page with format: http://from.com/from.htm
+<br>#   %uaquot           User agent with format: "Mozilla/4.0 (compatible, ...)"
+<br>#   %ua               User agent with format: Mozilla/4.0_(compatible...)
+<br>#   %gzipin           Mod_gzip compression input bytes: In:XXX
+<br>#   %gzipout          Mod_gzip compression output bytes & ratio: Out:YYY:ZZZpct.
+<br>#   %gzipratio        Mod_gzip compression ratio: ZZZpct.
+<br>#   %email            EMail sender (for mail log)
+<br>#   %email_r          EMail receiver (for mail log)
+<br>#   %syslog           Syslog-specific time and host stamp with format: Mon dd hh:mm:ss hostname
+<br>#   %virtualname      Web sever virtual hostname. Use this tag when same log
+<br>#                     file contains data of several virtual web servers. The
+<br>#                     SiteDomain will be used to filter the one you want.
+<br>#   If your log format has some fields not included in this list, use
+<br>#   %other            Means another field
+<br>#
+<br># Examples for Apache combined logs (following two examples are equivalent):
+<br># LogFormat = 1
+<br># LogFormat = "%host %other %logname %time1 %methodurl %code %bytesd %refererquot %uaquot"
+<br>#
+<br># Examples for IIS (following two examples are equivalent):
+<br># LogFormat = 2
+<br># LogFormat = "%time2 %host %logname %method %url %code %bytesd %other %ua %referer"
+<br>#
+<br>LogFormat=1
+
+<br><br><hr>
+
+<a name="LogSeparator"><b>LogSeparator</b></a><br>
+<b>Version : </b>5.0 +<br>
+<br># If your log field's separator is not a space, you can change this parameter.
+<br># Example: " "
+<br># Example: "\t"
+<br># Example: "|"
+<br># Default: " "
+<br>#
+
+<br><br><hr>
+
+<a name="DNSLookup"><b>DNSLookup</b></a><br>
+<b>Version : </b>1.0 + (5.0 + for value 2) <br>
+<br># If you want to have information on domains/countries visitors, you must ask
+<br># AWStats to make reverse DNS lookup (if not already done in your log file).
+<br># With DNSLookup to 0, all hosts will be reported by their IP addresses and
+<br># not by the full hostname of visitors. Domain/Country chart will also report
+<br># all visitors from a domain/country "Unknown".
+<br># If you need to set DNSLookup to 1, don't forget that this will reduce
+<br># dramatically AWStats update process speed. Do not use on large web sites.
+<br># Possible values:
+<br>#  0 No DNS Lookup
+<br>#  1 DNS Lookup is fully enabled
+<br>#  2 DNS Lookup is made only from DNS cache files
+<br># Default: 2
+<br># 
+<br>DNSLookup=2
+
+<br><br><hr>
+
+<a name="DirData"><b>DirData</b></a><br>
+<b>Version : </b>1.0 +<br>
+<br># When AWStats updates its statistics, it stores results of its analysis in 
+<br># files (AWStats database). All those files are written in the directory
+<br># defined by the "DirData" parameter. Set this value to the directory where
+<br># you want AWStats to save its database and working files into.
+<br># Warning: If you want to be able to use the "AllowToUpdateStatsFromBrowser"
+<br># feature (see later), you need write permissions by webserver user on this
+<br># directory.
+<br># Example: "/var/cache/awstats"
+<br># Example: "../data"
+<br># Example: "C:/awstats_data_dir"
+<br># Default: "."          (means same directory as awstats.pl)
+<br>#
+<br>DirData="."
+
+<br><br><hr>
+
+<a name="DirCgi"><b>DirCgi</b></a><br>
+<b>Version : </b>1.0 +<br>
+<br># Relative or absolute web URL of your awstats.pl directory.
+<br># This parameter is used only when AWStats is ran from command line
+<br># with -output option (to generate links in HTML reported page).
+<br># Default: "/cgi-bin"   (means awstats.pl is in "/mywwwroot/cgi-bin")
+<br>#
+<br>DirCgi="/cgi-bin"
+
+<br><br><hr>
+
+<a name="DirIcons"><b>DirIcons</b></a><br>
+<b>Version : </b>1.0 +<br>
+<br># If AWStats used as a CGI, enter relative or absolute web URL of all icons
+<br># subdirectories.
+<br># If you build static reports ("... -output > outputpath/output.html"), enter
+<br># path of icon directory relative to the directory outputpath.
+<br># Example: "/icon"
+<br># Example: "../icon"
+<br># Default: "/icon" (means you must copy icon directories in "/mywwwroot/icon")
+<br>#
+<br>DirIcons="/icon"
+
+<br><br><hr>
+
+<a name="SiteDomain"><b>SiteDomain</b></a><br>
+<b>Version : </b>3.2 +<br>
+<br># "SiteDomain" must contain the main domain name or the main intranet web
+<br># server name used to reach the web site.
+<br># If you share the same log file for several virtual web servers, this
+<br># parameter is used to tell AWStats to filter record that contains records for
+<br># this virtual host name only (So check that this virtual hostname can be
+<br># found in your log file and use a personalized log format that include the
+<br># %virtualname tag).
+<br># But for multi hosting a better solution is to have one log file for each
+<br># virtual web server. In this case, this parameter is only used to generate
+<br># full URL's links when ShowLinksOnUrl option is set to 1.
+<br># Example: "www.mysite.com"
+<br># Example: "user.mydomain.com"
+<br># Example: "myintranetserver"
+<br>#
+<br>SiteDomain=""
+
+<br><br><hr>
+
+<a name="HostAliases"><b>HostAliases</b></a><br>
+<b>Version : </b>1.0 +<br>
+<br># Enter here all other possible domain names, addresses or virtual host
+<br># aliases someone can use to access your site. Try to keep only the minimum
+<br># number of possible names/adresses to have the best performances.
+<br># You can repeat the "SiteDomain" value in this list.
+<br># Use space between each value and put a backslash before each dot.
+<br># This parameter is used to analyze referer field in log file and to help
+<br># AWStats to know if a referer URL is a local URL of same site or an URL of
+<br># another site.
+<br># Example: "www.myserver.com x.y.z.w localhost 127.0.0.1"
+<br>#
+<br>HostAliases="www.myserver.com x.y.z.w localhost 127.0.0.1"
+
+<br><br><hr>
+
+<a name="AllowToUpdateStatsFromBrowser"><b>AllowToUpdateStatsFromBrowser</b></a><br>
+<b>Version : </b>3.0 +<br>
+<br># When this parameter is set to 1, AWStats add a button on report page to
+<br># allow to "update" statistics from a web browser. Warning, when "update" is
+<br># made from a browser, AWStats is ran as a CGI by the web server user
+<br># defined in your web server (user "nobody" by default with Apache, "IUSR_XXX"
+<br># with IIS), so the "DirData" directory and all already existing history files
+<br># (awstatsMMYYYY[.xxx].txt) must be writable by this user. Change permissions
+<br># if required.
+<br># Warning: Update process can be long so you might experience "time out"
+<br># browser errors if you don't launch AWStats enough frequently.
+<br># When set to 0, update is only made when AWStats is ran from the command
+<br># line interface (or a task scheduler).
+<br># Possible values: 0 or 1
+<br># Default: 0
+<br>#
+<br>AllowToUpdateStatsFromBrowser=0
+
+<br><br><hr>
+
+<a name="EnableLockForUpdate"><b>EnableLockForUpdate</b></a><br>
+<b>Version : </b>5.0 +<br>
+<br># When the update process run, AWStats can set a lock file in TEMP or TMP
+<br># directory. This lock is to avoid to have 2 update processes running at the
+<br># same time to prevent unknown conflicts problems and avoid DoS attacks when
+<br># AllowToUpdateStatsFromBrowser is set to 1.
+<br># Because, when you use lock file, you can experience sometimes problems in
+<br># lock file not correctly removed (when process is killed for example, this
+<br># requires that you remove the file manualy), this option is not enabled by
+<br># default (Do not enable this option with no consol server access).
+<br># Possible values: 0 or 1
+<br># Default: 0
+<br>#
+<br>EnableLockForUpdate=0
+
+<br><br><hr>
+
+<a name="DNSStaticCacheFile"><b>DNSStaticCacheFile</b></a><br>
+<b>Version : </b>5.0 +<br>
+<br># AWStats can do reverse DNS lookups through a static DNS cache file that was
+<br># previously created manually. If no path is given in static DNS cache file
+<br># name, AWStats will search DirData directory. This file is never changed.
+<br># This option is not used if DNSLookup=0.
+<br># Note: DNS cache file format is 'minsince1970 ipaddress resolved_hostname'
+<br># or just 'ipaddress resolved_hostname'
+<br># Example: "/mydnscachedir/dnscache"
+<br># Default: "dnscache.txt"
+<br>#
+<br>DNSStaticCacheFile="dnscache.txt"
+
+<br><br><hr>
+
+<a name="DNSLastUpdateCacheFile"><b>DNSLastUpdateCacheFile</b></a><br>
+<b>Version : </b>5.0 +<br>
+<br># AWStats can do reverse DNS lookups through a DNS cache file that was created
+<br># by a previous run of AWStats. This file is erased and recreated after each
+<br># statistics update process. You don't need to create and/or edit it.
+<br># AWStats will read and save this file in DirData directory.
+<br># This option is not used if DNSLookup=0.
+<br># Example: "/mydnscachedir/dnscachelastupdate"
+<br># Default: "dnscachelastupdate.txt"
+<br>#
+<br>DNSLastUpdateCacheFile="dnscachelastupdate.txt"
+
+<br><br><hr>
+
+<a name="SkipDNSLookupFor"><b>SkipDNSLookupFor</b></a><br>
+<b>Version : </b>3.0 +<br>
+<br># You can specify specific IP addresses that should NOT be looked up in
+<br>#  the DNS. You may specify partial addresses (ie 163.85. for everything
+<br>#  behind the usual firewall setup, etc)...
+<br># This option is used only if DNSLookup=1.
+<br># Note: Use space between each value.
+<br># Example: "163.85. 201.101.51.2"
+<br># Default: ""
+<br>#
+<br>SkipDNSLookupFor=""
+
+<br><br><hr>
+
+<a name="AllowAccessFromWebToAuthenticatedUsersOnly"><b>AllowAccessFromWebToAuthenticatedUsersOnly</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># The following two parameters allow you to protect a config file to be used
+<br># by your AWStats program called from a browser only if web user has been
+<br># authenticated. Your AWStats program must be in a web protected "realm" (With
+<br># Apache, you can use .htaccess files to do so. With other web servers, see
+<br># your server setup manual).
+<br># Possible values: 0 or 1
+<br># Default: 0
+<br>#
+<br>AllowAccessFromWebToAuthenticatedUsersOnly=0
+
+<br><br><hr>
+
+<a name="AllowAccessFromWebToFollowingAuthenticatedUsers"><b>AllowAccessFromWebToFollowingAuthenticatedUsers</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># This parameter gives the list of all authorized authenticated users to view
+<br># statistics for this domain/config file. This parameter is used only if
+<br># AllowAccessToAuthenticatedUsersOnly is set to 1.
+<br># Example: "user1 user2"
+<br># Default: ""
+<br>#
+<br>AllowAccessFromWebToFollowingAuthenticatedUsers=""
+
+<br><br><hr>
+
+<a name="AllowAccessFromWebToFollowingIPAddresses"><b>AllowAccessFromWebToFollowingIPAddresses</b></a><br>
+<b>Version : </b>5.0 +<br>
+<br># When this parameter is define to something, the IP address of the user that
+<br># read its statistics from a browser (when AWStats is used as a CGI) is
+<br># checked and must match the IP address range defined by this parameter.
+<br># Example: "123.123.123.10-123.123.123.255"
+<br># Default: ""
+<br>#
+<br>AllowAccessFromWebToFollowingIPAddresses=""
+
+<br><br><hr>
+
+<a name="CreateDirDataIfNotExists"><b>CreateDirDataIfNotExists</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># If the "DirData" directory (see above) does not exists, AWStats return an
+<br># error. However, you can ask AWStats to create it. This option can be used by
+<br># some Web Hosting Providers that has defined a dynamic value for DirData (for
+<br># example DirData="/home/__REMOTE_USER__").
+<br># Possible values: 0 or 1
+<br># Default: 0
+<br>#
+<br>CreateDirDataIfNotExists=1
+
+<br><br><hr>
+
+<a name="SaveDatabaseFilesWithPermissionsForEveryone"><b>SaveDatabaseFilesWithPermissionsForEveryone</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># In most case, AWStats is used as a cgi program. So AWStats process is ran
+<br># by default web server user (nobody for Unix, IUSR_xxx for IIS/Windows,...).
+<br># To make use easier and avoid permission problems between update process 
+<br># (run by an admin user) and CGI process (ran by a low level user), AWStats
+<br># save its database files with read and write for everyone.
+<br># If you have experience on managing security policies (Web Hosting Provider),
+<br># you should set this parameter to 0. AWStats will keep default process user
+<br># permissions on its files.
+<br># Possible values: 0 or 1
+<br># Default: 1
+<br>#
+<br>SaveDatabaseFilesWithPermissionsForEveryone=1
+
+<br><br><hr>
+
+<a name="PurgeLogFile"><b>PurgeLogFile</b></a><br>
+<b>Version : </b>2.23 +<br>
+<br># AWStats can purge log after processing it. By this way, the next time you
+<br># launch AWStats, log file will be smaller and processing time will be better.
+<br># IMPORTANT !!!
+<br># AWStats is able to detect new lines in log file, to process only them, so
+<br># you can launch AWStats as soon as you want, even with this parameter to 0.
+<br># With 0, no purge is made, so you must use a scheduled task or a web server
+<br># that make this purge frequently.
+<br># With 1, the purge of the log file is made each time AWStats is ran.
+<br># This parameter doesn't work with IIS (This web server doesn't let its log
+<br># file to be purged).
+<br># Possible values: 0 or 1
+<br># Default: 0
+<br>#
+<br>PurgeLogFile=0
+
+<br><br><hr>
+
+<a name="ArchiveLogRecords"><b>ArchiveLogRecords</b></a><br>
+<b>Version : </b>2.1 +<br>
+<br># When PurgeLogFile is setup to 1, AWStats will clean your log file after
+<br># processing it. You can however keep an archive file (saved in "DirData") of
+<br># all processed log records by setting this to 1 (For example if you want to
+<br># use another log analyzer).
+<br># This parameter is not used if PurgeLogFile=0
+<br># Possible values: 0 or 1
+<br># Default: 0
+<br>#
+<br>ArchiveLogRecords=0
+
+<br><br><hr>
+
+<a name="KeepBackupOfHistoricFiles"><b>KeepBackupOfHistoricFiles</b></a><br>
+<b>Version : </b>3.2 +<br>
+<br># Each time you run the update process, AWStats overwrite the 'historic file'
+<br># for the month (awstatsMMYYYY[.*].txt) with the updated one.
+<br># When write errors occurs (IO, disk full,...), this historic file can be
+<br># corrupted and must be deleted. Because this file contains information of all
+<br># past processed log files, you will loose old stats if removed. So you can
+<br># ask AWStats to save last non corrupted file in a .bak file. This file is
+<br># stored in "DirData" directory with other 'historic files'.
+<br># Possible values: 0 or 1
+<br># Default: 0
+<br>#
+<br>KeepBackupOfHistoricFiles=0
+
+<br><br><hr>
+
+<a name="DefaultFile"><b>DefaultFile</b></a><br>
+<b>Version : </b>1.0 + (5.0 + can accept several values)<br>
+<br># Default index page name for your web server.
+<br># Example: "default.htm default.html"
+<br># Default: "index.html"
+<br>#
+<br>DefaultFile="index.html"
+
+<br><br><hr>
+
+<a name="SkipHosts"><b>SkipHosts</b></a><br>
+<b>Version : </b>1.0 +<br>
+<br># Do not include access from clients that match following criteria.
+<br># If your log file contains IP adresses in host field, you must enter here
+<br># matching IP adresses criteria.
+<br># If DNS lookup is already done in your log file, you must enter here hostname
+<br># criteria, else enter ip address criteria.
+<br># The opposite parameter of "SkipHosts" is "OnlyHosts".
+<br># Note: Use space between each value.
+<br># Note: ^xxx means hosts starting with xxx.
+<br># Note: xxx$ means hosts ending with xxx.
+<br># Example: "^127.0.0.1$ ^163.84."
+<br># Example: "localhost abcxyz"
+<br># Default: ""
+<br>#
+<br>SkipHosts=""
+
+<br><br><hr>
+
+<a name="SkipUserAgents"><b>SkipUserAgents</b></a><br>
+<b>Version : </b>5.1 +<br>
+<br># Do not include access from clients with a user agent that match following
+<br># criteria. If you want to exclude a robot, you should update the robots.pm
+<br># file instead of this parameter.
+<br># Note: Use space between each value. This parameter is not case sensitive.
+<br># Example: "konqueror"
+<br># Default: ""
+<br>#
+<br>SkipUserAgents=""
+
+<br><br><hr>
+
+<a name="SkipFiles"><b>SkipFiles</b></a><br>
+<b>Version : </b>1.0 +<br>
+<br># Use SkipFiles to ignore access to URLs that match one of following entries.
+<br># You can, with this option, add a list of not important frame pages (like 
+<br># menus, etc...) to exclude them from statistics.
+<br># For example, to ignore a whole directory tree, just add "directorytoignore",
+<br># to ignore "users" pages in your stats, you can add "/~".
+<br># The opposite parameter of "SkipFiles" is "OnlyFiles".
+<br># Note: This parameter is not case sensitive.
+<br># Note: Use space between each value and do not remove default values.
+<br># Note: ^xxx means url starting with xxx.
+<br># Note: xxx$ means url ending with xxx.
+<br># Example: "robots.txt$ favicon.ico$ badpage.html /~"
+<br># Default: "robots.txt$ favicon.ico$"
+<br>#
+<br>SkipFiles="robots.txt$ favicon.ico$"
+
+<br><br><hr>
+
+<a name="OnlyHosts"><b>OnlyHosts</b></a><br>
+<b>Version : </b>5.2 +<br>
+<br># Include in stats, only accesses from hosts that match one of following
+<br># entries. For example, if you want AWStats to filter access to keep only
+<br># stats for visits from particular hosts, you can add thoose hosts names
+<br># in this parameter.
+<br># If DNS lookup is already done in your log file, you must enter here hostname
+<br># criteria, else enter ip address criteria.
+<br># The opposite parameter of "OnlyHosts" is "SkipHosts".
+<br># Note: This parameter is not case sensitive.
+<br># Note: Use space between each value.
+<br># Note: ^xxx means hosts starting with xxx.
+<br># Note: xxx$ means hosts ending with xxx.
+<br># Example: "^123.123.123.123$ ^10.0."
+<br># Default: ""
+<br>#
+<br>OnlyHosts=""
+
+<br><br><hr>
+
+<a name="OnlyFiles"><b>OnlyFiles</b></a><br>
+<b>Version : </b>3.0 +<br>
+<br># Include in stats, only accesses to URLs that match one of following entries.
+<br># For example, if you want AWStats to filter access to keep only stats that
+<br># match a particular string, like a particular directory, you can add this
+<br># directory name in this parameter.
+<br># The opposite parameter of "OnlyFiles" is "SkipFiles".
+<br># Note: This parameter is not case sensitive.
+<br># Note: Use space between each value and do not remove default values
+<br># Note: ^xxx means url starting with xxx.
+<br># Note: xxx$ means url ending with xxx.
+<br># Example: "marketing_directory"
+<br># Default: ""
+<br>#
+<br>OnlyFiles=""
+
+<br><br><hr>
+
+<a name="NotPageList"><b>NotPageList</b></a><br>
+<b>Version : </b>3.2 +<br>
+<br># Add here a list of kind of url (file extension) that must be counted as
+<br># "Hit only" and not as a "Hit" and "Page/Download". You can set here all
+<br># images extensions as they are hit downloaded that must be counted but they
+<br># are not viewed pages. URLs with such extensions are not included in the TOP
+<br># Pages/URL report.
+<br># Note: If you want to exclude your own URLs from stats (No Pages and no Hits
+<br># reported), you should use SkipFiles parameter instead.
+<br># Example: ""
+<br># Example: "css js class gif jpg jpeg png bmp zip arj gz z wav mp3 wma mpg"
+<br># Default: "css js class gif jpg jpeg png bmp"
+<br>#
+<br>NotPageList="css js class gif jpg jpeg png bmp"
+
+<br><br><hr>
+
+<a name="ValidHTTPCodes"><b>ValidHTTPCodes</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># By default, AWStats considers that records found in log file are successful
+<br># hits if HTTP code returned by server is a valid HTTP code (200 and 304).
+<br># Any other code are reported in HTTP error chart.
+<br># However in some specific environment, with web server HTTP redirection,
+<br># you can choose to also accept other codes.
+<br># Example: "200 304 302 305"
+<br># Default: "200 304"
+<br>#
+<br>ValidHTTPCodes="200 304"
+<br>
+<br><u>This is examples of current HTTP codes</u>
+<br><i>
+<br>#[Miscellaneous successes]
+<br>"2xx", "[Miscellaneous successes]",
+<br>"200", "OK",                                                               # HTTP request OK
+<br>"201", "Created",
+<br>"202", "Request recorded, will be executed later",
+<br>"203", "Non-authoritative information",
+<br>"204", "Request executed",
+<br>"205", "Reset document",
+<br>"206", "Partial Content",
+<br>#[Miscellaneous redirections]
+<br>"3xx", "[Miscellaneous redirections]",
+<br>"300", "Multiple documents available",
+<br>"301", "Moved Permanently",
+<br>"302", "Found",
+<br>"303", "See other document",
+<br>"304", "Not Modified since last retrieval",        # HTTP request OK
+<br>"305", "Use proxy",
+<br>"306", "Switch proxy",
+<br>"307", "Document moved temporarily",
+<br>#[Miscellaneous client/user errors]
+<br>"4xx", "[Miscellaneous client/user errors]",
+<br>"400", "Bad Request",
+<br>"401", "Unauthorized",
+<br>"402", "Payment required",
+<br>"403", "Forbidden",
+<br>"404", "Document Not Found",
+<br>"405", "Method not allowed",
+<br>"406", "ocument not acceptable to client",
+<br>"407", "Proxy authentication required",
+<br>"408", "Request Timeout",
+<br>"409", "Request conflicts with state of resource",
+<br>"410", "Document gone permanently",
+<br>"411", "Length required",
+<br>"412", "Precondition failed",
+<br>"413", "Request too long",
+<br>"414", "Requested filename too long",
+<br>"415", "Unsupported media type",
+<br>"416", "Requested range not valid",
+<br>"417", "Failed",
+<br>#[Miscellaneous server errors]
+<br>"5xx", "[Miscellaneous server errors]",
+<br>"500", "Internal server Error",
+<br>"501", "Not implemented",
+<br>"502", "Received bad response from real server",
+<br>"503", "Server busy",
+<br>"504", "Gateway timeout",
+<br>"505", "HTTP version not supported",
+<br>"506", "Redirection failed",
+<br>#[Unknown]
+<br>"xxx" ,"[Unknown]"
+</i>
+
+<br><br><hr>
+
+<a name="URLNotCaseSensitive"><b>URLNotCaseSensitive</b></a><br>
+<b>Version : </b>5.1 +<br>
+<br># Some web servers on some Operating systems (IIS-Windows) considers that two
+<br># URLs with same value but different case are the same URL. To tell AWStats to
+<br># also considers them as one, set this parameter to 1.
+<br># Possible values: 0 or 1
+<br># Default: 0
+<br># 
+<br>URLNotCaseSensitive=0
+
+<br><br><hr>
+
+<a name="URLWithQuery"><b>URLWithQuery</b></a><br>
+<b>Version : </b>3.2 +<br>
+<br># Keep or remove the query string to the URL in the statistics for individual
+<br># pages. This is primarily used to differentiate between the URLs of dynamic
+<br># pages. If set to 1, mypage.html?id=x and mypage.html?id=y are counted as two
+<br># different pages.
+<br># Warning, when set to 1, memory required to run AWStats is dramatically
+<br># increased if you have a lot of changing URLs (for example URLs with a random
+<br># id inside). Such web sites should not set this option to 1 or use seriously
+<br># the next parameter URLWithQueryWithoutFollowingParameters.
+<br># Possible values:
+<br># 0 - URLs are cleaned from the query string (ie: "/mypage.html")
+<br># 1 - Full URL with query string is used     (ie: "/mypage.html?p=x&q=y")
+<br># Default: 0
+<br># 
+<br>URLWithQuery=0
+
+<br><br><hr>
+
+<a name="URLWithQueryWithoutFollowingParameters"><b>URLWithQueryWithoutFollowingParameters</b></a><br>
+<b>Version : </b>5.1 +<br>
+<br># When URLWithQuery is on, you will get the full URL with all parameters in
+<br># URL reports. But among thoose parameters, sometimes you don't need a
+<br># particular parameter because it does not identify the page or because it's
+<br># a random ID changing for each access even if URL points to same page. In
+<br># such cases, it is higly recommanded to ask AWStats to remove such parameters
+<br># from the URL before counting, manipulating and storing it. Enter here list
+<br># of all non wanted parameters. For example if you enter "id", one hit on
+<br># /mypage.cgi?p=abc&id=Yo4UomP9d and /mypage.cgi?p=abc&id=Mu8fdxl3r
+<br># will be reported as 2 hits on /mypage.cgi?p=abc
+<br># This parameter is not used when URLWithQuery is 0.
+<br># Example: "PHPSESSID"
+<br># Default: ""
+<br># 
+<br>URLWithQueryWithoutFollowingParameters=""
+
+<br><br><hr>
+
+<a name="URLReferrerWithQuery"><b>URLReferrerWithQuery</b></a><br>
+<b>Version : </b>5.1 +<br>
+<br># Keep or remove the query string to the referrer URL in the statistics for
+<br># external referrer pages. This is used to differentiate between the URLs of
+<br># dynamic referrer pages. If set to 1, mypage.html?id=x and mypage.html?id=y
+<br># are counted as two different referrer pages.
+<br># Possible values:
+<br># 0 - Referrer URLs are cleaned from the query string (ie: "/mypage.html")
+<br># 1 - Full URL with query string is used      (ie: "/mypage.html?p=x&q=y")
+<br># Default: 0
+<br># 
+<br>URLReferrerWithQuery=0
+
+<br><br><hr>
+
+<a name="WarningMessages"><b>WarningMessages</b></a><br>
+<b>Version : </b>1.0 +<br>
+<br># AWStats can detect setup problems or show you important informations to have
+<br># a better use. Keep this to 1, except if AWStats says you can change it.
+<br># Possible values: 0 or 1
+<br># Default: 1
+<br>#
+<br>WarningMessages=1
+
+<br><br><hr>
+
+<a name="NbOfLinesForCorruptedLog"><b>NbOfLinesForCorruptedLog</b></a><br>
+<b>Version : </b>3.2 +<br>
+<br># To help you to detect if your log format is good, AWStats report an error
+<br># if all the first NbOfLinesForCorruptedLog lines have a format that does not
+<br># match the LogFormat parameter.
+<br># However, some worm virus attack on your web server can result in a very high
+<br># number of corrupted lines in your log. So if you experience awstats stop
+<br># because of bad virus records at the beginning of your log file, you can
+<br># increase this parameter (very rare).
+<br># Default: 50
+<br>#
+<br>NbOfLinesForCorruptedLog=50
+
+<br><br><hr>
+
+<a name="SplitSearchString"><b>SplitSearchString</b></a><br>
+<b>Version : </b>2.24 - 4.0 (deprecated since 4.1)<br>
+AWStats 4.1+ supports both keywords AND keyphrases by default with no need of any parameter.<br>
+<font color="#808080">
+<br># Search engines keywords reported are full search string or separate keywords
+<br># Possible values:
+<br># 0 - Search keywords reported are full search string (ie: "town maps")
+<br># 1 - Search keywords reported are separated words (ie: "town" and "maps")
+<br># Default: 0
+<br>#
+<br>SplitSearchString=0
+</font>
+
+<br><br><hr>
+
+<a name="WrapperScript"><b>WrapperScript</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># For some particular integration needs, you may want to have CGI links to
+<br># point to another script than awstats.pl.
+<br># Use the name of this script in WrapperScript parameter.
+<br># Example: "awstatslauncher.pl"
+<br># Default: ""
+<br>#
+<br>WrapperScript=""
+
+<br><br><hr>
+
+<a name="DecodeUA"><b>DecodeUA</b></a><br>
+<b>Version : </b>5.0 +<br>
+<br># DecodeUA must be set to 1 if you use Roxen web server. This server converts
+<br># all spaces in user agent field into %20. This make the AWStats robots, os
+<br># and browsers detection fail in some cases. Just change it to 1 if and only
+<br># if your web server is Roxen.
+<br># Possible values: 0 or 1
+<br># Default: 0
+<br>#
+<br>DecodeUA=0
+
+<br><br><hr>
+
+<a name="LevelFor"><b>LevelFor</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># Following values allows you to disable/enable some AWStats features.
+<br># Possible values: 0, 1 (or 2 for LevelForRobotsDetection)
+<br># Default: 1 (2 for LevelForRobotsDetection)
+<br>#
+<br>LevelForRobotsDetection=2                  # 0 will increase AWStats speed by 1%.
+<br>LevelForBrowsersDetection=1                        # 0 disables Browsers detection. No speed gain.
+<br>LevelForOSDetection=1                              # 0 disables OS detection. No speed gain.
+<br>LevelForRefererAnalyze=1                   # 0 will increase AWStats speed by 5%.
+
+<br><br><hr>
+
+<a name="UseFramesWhenCGI"><b>UseFramesWhenCGI</b></a><br>
+<b>Version : </b>5.0 +<br>
+<br># When you use AWStats as a CGI, you can have the reports shown in HTML views.
+<br># Frames are only available for report viewed dynamically. When you build
+<br># pages from command line, this option is not used and no frames are built.
+<br># Possible values: 0 or 1
+<br># Default: 1
+<br>#
+<br>UseFramesWhenCGI=1
+
+<br><br><hr>
+
+<a name="DetailedReportsOnNewWindows"><b>DetailedReportsOnNewWindows</b></a><br>
+<b>Version : </b>4.1 + (5.0 + for value 2)<br>
+<br># This parameter ask your browser to open detailed reports into a different
+<br># window than the main page.
+<br># Possible values:
+<br># 0 - Open all in same browser window
+<br># 1 - Open detailed reports in another window except if using frames
+<br># 2 - Open always in a different window even if reports are framed
+<br># Default: 1
+<br>#
+<br>DetailedReportsOnNewWindows=1
+
+<br><br><hr>
+
+<a name="Expires"><b>Expires</b></a><br>
+<b>Version : </b>3.1 +<br>
+<br># You can add in the HTML report page a delay to force browsers to not use cache
+<br># if page is loaded a second time after this delay (in seconds).
+<br># This parameter is not used when report are built with -staticlinks option.
+<br># Example: 3600
+<br># Default: 0
+<br>#
+<br>Expires=0
+
+<br><br><hr>
+
+<a name="MaxRowsInHTMLOutput"><b>MaxRowsInHTMLOutput</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># To avoid too large web pages, you can ask AWStats to limit number of rows of
+<br># all reported charts to this number when no other limit apply.
+<br># Default: 1000
+<br>#
+<br>MaxRowsInHTMLOutput=1000
+
+<br><br><hr>
+
+<a name="Lang"><b>Lang</b></a><br>
+<b>Version : </b>2.1 +<br>
+<br># Set your primary language.
+<br># Possible value:
+<br>#  Bosnian=ba, Chinese (Taiwan)=tw, Chinese (Traditional)=cn, Czech=cz,
+<br>#  Danish=dk, Dutch=nl, English=en, Finnish=fi, French=fr, German=de,
+<br>#  Greek=gr, Hungarian=hu, Indonesian=id, Italian=it, Japanese=jp, Korean=kr,
+<br>#  Latvian=lv, Norwegian (Nynorsk)=nn, Norwegian (Bokmal)=nb, Polish=pl,
+<br>#  Portuguese=pt, Portuguese (Brazilian)=br, Romanian=ro, Russian=ru,
+<br>#  Slovak=sk, Spanish=es, Swedish=se, Turkish=tr, Ukrainian=ua
+<br># Default: "en"
+<br>#
+<br>Lang="en"
+
+<br><br><hr>
+
+<a name="DirLang"><b>DirLang</b></a><br>
+<b>Version : </b>2.1 +<br>
+<br># Set the location of language files.
+<br># Example: "/opt/awstats/lang"
+<br># Default: "./lang" (means lang directory is in same location than awstats.pl)
+<br>#
+<br>DirLang="./lang"
+
+<br><br><hr>
+
+<a name="Show"><b>Show...</b></a><br>
+<b>Version : </b><br>
+3.2 for ShowHeader,ShowMenu,ShowMonthDayStats,ShowDaysOfWeekStats,ShowHoursStats,
+ShowDomainsStats,ShowHostsStats,ShowAuthenticatedUsers,ShowRobotsStats,
+ShowPagesStats,ShowFileTypesStats,ShowFileSizesStats,ShowBrowsersStats,
+ShowOSStats,ShowOriginStats,ShowKeyphrasesStats,ShowKeywordsStats,ShowHTTPErrorsStats<br>
+3.2 - 5.0 for ShowCompressionStats (deprecated since 5.1, use code C with ShowFileTypesStats instead)<br>
+4.1 for ShowSessionsStats, ShowKeywordsStats<br>
+5.1 for all letters codes<br>
+<br># You choose here which reports you want to see in the main page and what you
+<br># want to see in those reports.
+<br># Possible values:
+<br>#  0  - Topic is not shown at all
+<br>#  1  - Report is shown with default informations
+<br># XYZ - Report is shown with only informations defined by code X,Y,Z
+<br>#       X,Y,Z are code letters among the following:
+<br>#        U = Unique visitors
+<br>#        V = Visits
+<br>#        P = Number of pages
+<br>#        H = Number of hits
+<br>#        B = Bandwith
+<br>#        L = Last access date
+<br>#        E = Entry pages
+<br>#        X = Exit pages
+<br>#        C = Web compression (mod_gzip)
+<br>#        M = Average mail size (mail logs)
+<br>#
+<br># Show AWStats head title and icon
+<br># Default: 1, Possible codes: None
+<br>ShowHeader=1                               
+<br># Show menu header with links on detailed reports
+<br># Default: 1, Possible codes: None
+<br>ShowMenu=1                                 
+<br># Show monthly and daily chart
+<br># Default: UVPHB, Possible codes: UVPHB
+<br>ShowMonthDayStats=UVPHB
+<br># Show days of week chart
+<br># Default: PHB, Possible codes: PHB
+<br>ShowDaysOfWeekStats=PHB
+<br># Show hourly chart
+<br># Default: PHB, Possible codes: PHB
+<br>ShowHoursStats=PHB
+<br># Show domains/country chart
+<br># Default: 1, Possible codes: None
+<br>ShowDomainsStats=1
+<br># Show hosts chart
+<br># Default: PHBL, Possible codes: PHBL
+<br>ShowHostsStats=PHBL
+<br># Show authenticated users chart
+<br># Default: 0, Possible codes: PHBL
+<br>ShowAuthenticatedUsers=0
+<br># Show robots chart
+<br># Default: 1, Possible codes: None
+<br>ShowRobotsStats=1
+<br># Show EMail senders chart (For use when analyzing mail log files)
+<br># Default: HBML, Possible codes: HBML
+<br>ShowEMailSenders=HBML
+<br># Show EMail receiver chart (For use when analyzing mail log files)
+<br># Default: HBML, Possible codes: HBML
+<br>ShowEMailReceivers=HBML
+<br># Show session chart
+<br># Default: 1, Possible codes: None
+<br>ShowSessionsStats=1
+<br># Show pages-url chart.
+<br># Default: HBEX, Possible codes: HBEX
+<br>ShowPagesStats=HBEX        
+<br># Show file types chart.
+<br># Default: HB, Possible codes: HBC
+<br>ShowFileTypesStats=HB
+<br># Show file size chart (Not yet available)
+<br># Default: 1, Possible codes: None
+<br>ShowFileSizesStats=0               
+<br># Show browsers chart
+<br># Default: 1, Possible codes: None
+<br>ShowBrowsersStats=1
+<br># Show Operating systems chart
+<br># Default: 1, Possible codes: None
+<br>ShowOSStats=1
+<br># Show Origin chart
+<br># Default: PH, Possible codes: HB
+<br>ShowOriginStats=PH
+<br># Show keyphrases chart
+<br># Default: 1, Possible codes: None
+<br>ShowKeyphrasesStats=1
+<br># Show keywords chart
+<br># Default: 1, Possible codes: None
+<br>ShowKeywordsStats=1
+<br># Show HTTP errors chart
+<br># Default: 1, Possible codes: None
+<br>ShowHTTPErrorsStats=1
+
+<br><br><hr>
+
+<a name="Max"><b>Max...</b></a><br>
+<b>Version : </b>1.0 +<br>
+<br># This value can be used to choose maximum number of lines shown for each 
+<br># particular reporting.
+<br>#
+<br># Stats by domains
+<br>MaxNbOfDomain = 25
+<br># Stats by hosts
+<br>MaxNbOfHostsShown = 25
+<br>MinHitHost    = 1
+<br># Stats by authenticated users
+<br>MaxNbOfLoginShown = 10
+<br>MinHitLogin   = 1
+<br># Stats by robots
+<br>MaxNbOfRobotShown = 25
+<br>MinHitRobot   = 1
+<br># Stats by pages
+<br>MaxNbOfPageShown = 25
+<br>MinHitFile    = 1
+<br># Stats by referers
+<br>MaxNbOfRefererShown = 25
+<br>MinHitRefer   = 1
+<br># Stats for keywords
+<br>MaxNbOfKeywordsShown = 25
+<br>MinHitKeyword  = 1
+
+<br><br><hr>
+
+<a name="FirstDayOfWeek"><b>FirstDayOfWeek</b></a><br>
+<b>Version : </b>3.2 +<br>
+<br># Choose if you want week to start on sunday or monday
+<br># Possible values:
+<br># 0 - Week start on sunday
+<br># 1 - Week start on monday
+<br># Default: 1
+<br>#
+<br>FirstDayOfWeek=1
+
+<br><br><hr>
+
+<a name="ShowFlagLinks"><b>ShowFlagLinks</b></a><br>
+<b>Version : </b>3.2 +<br>
+<br># List of visible flags with link to other language translations.
+<br># See Lang parameter for list of allowed flag/language codes.
+<br># If you don't want any flag link, set ShowFlagLinks to "".
+<br># This parameter is used only if ShowHeader parameter is set to 1.
+<br># Possible values: "" or "language_codes_separated_by_space"
+<br># Default: "en es fr it nl es"
+<br>#
+<br>ShowFlagLinks="en fr de it nl es"
+
+<br><br><hr>
+
+<a name="ShowLinksOnUrl"><b>ShowLinksOnUrl</b></a><br>
+<b>Version : </b>3.1 +<br>
+<br># Each URL shown in stats report views are links you can click.
+<br># Possible values: 0 or 1
+<br># Default: 1
+<br>#
+<br>ShowLinksOnUrl=1
+
+<br><br><hr>
+
+<a name="MaxLengthOfURL"><b>MaxLengthOfURL</b></a><br>
+<b>Version : </b>1.0 +<br>
+<br># Maximum length of URL shown on stats page (number of characters). This
+<br># affects only URL visible text, link still work.
+<br># Default: 72
+<br>#
+<br>MaxLengthOfURL=72
+
+<br><br><hr>
+
+<a name="ShowLinksToWhoIs"><b>ShowLinksToWhoIs</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># AWStats can include a link to WhoIs database on all hostnames/ip. For this, you
+<br># must set ShowLinksToWhoIs to 1. Warning, a such feature depends on two next
+<br># parameter (LinksToWhoIs and LinksToIPWhoIs) and on WhoIs server
+<br># exhaustivity and availability.
+<br># For this reason, this feature can't be a reliable feature.
+<br># Possible values: 0 or 1
+<br># Default: 0
+<br>#
+<br>ShowLinksToWhoIs=0
+
+<br><br><hr>
+
+<a name="LinksToWhoIs"><b>LinksToWhoIs</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># Set here the link used to point to Internet WhoIs database for hostnames.
+<br># This parameter is not used if ShowLinksToWhoIs is 0.
+<br># Default: "http://www.whois.net/search.cgi2?str="
+<br># Example: "http://www.netsol.com/cgi-bin/whois/whois?SearchType=all&STRING="
+<br># Example: "http://www.ripe.net/perl/whois?form_type=simple&searchtext="
+<br># Example: "http://www.arin.net/cgi-bin/whois.pl?queryinput="
+<br>#
+<br>LinksToWhoIs="http://www.whois.net/search.cgi2?str="
+
+<br><br><hr>
+
+<a name="LinksToIPWhoIs"><b>LinksToIPWhoIs</b></a><br>
+<b>Version : </b>5.0 +<br>
+<br># Set here the link used to point to Internet WhoIs database for ip addresses.
+<br># This parameter is not used if ShowLinksToWhoIs is 0.
+<br># Default: "http://ws.arin.net/cgi-bin/whois.pl?queryinput="
+<br># Example: "http://ws.arin.net/cgi-bin/whois.pl?queryinput="
+<br>#
+<br>LinksToIPWhoIs="http://ws.arin.net/cgi-bin/whois.pl?queryinput="
+
+<br><br><hr>
+
+<a name="HTMLHeadSection"><b>HTMLHeadSection</b></a><br>
+<b>Version : </b>3.2 +<br>
+<br># You can enter HTML code that will be added at the top of AWStats reports.
+<br># Default: ""
+<br>#
+<br>HTMLHeadSection=""
+
+<br><br><hr>
+
+<a name="HTMLEndSection"><b>HTMLEndSection</b></a><br>
+<b>Version : </b>3.2 +<br>
+<br># You can enter HTML code that will be added at the end of AWStats reports.
+<br># Great to add advert ban.
+<br># Default: ""
+<br>#
+<br>HTMLEndSection=""
+
+<br><br><hr>
+
+<a name="Bar"><b>Bar...</b></a><br>
+<b>Version : </b>1.0 +<br>
+<br># Value of maximum bar width/heigth for horizontal/vertical graphics bar
+<br># Default: 260/90
+<br>#
+<br>BarWidth   = 260
+<br>BarHeight  = 90
+
+<br><br><hr>
+
+<a name="Logo"><b>Logo...</b></a><br>
+<b>Version : </b>3.1 +<br>
+<br># You can set Logo and LogoLink to use your own logo.
+<br># Logo must be the name of image file (must be in $DirIcons/other directory).
+<br># LogoLink is the expected URL when clicking on Logo.
+<br># Default: "awstats_logo1.png"
+<br>#
+<br>Logo="awstats_logo1.png"
+<br>LogoLink="http://awstats.sourceforge.net"
+
+<br><br><hr>
+
+<a name="StyleSheet"><b>StyleSheet</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># You can ask AWStats to use a particular CSS (Cascading Style Sheet) to
+<br># change its look.
+<br># Example: "/css/awstats.css"
+<br># Default: ""
+<br>#
+<br>StyleSheet=""
+
+<br><br><hr>
+
+<a name="color_"><b>color_...</b></a><br>
+<b>Version : </b><br>
+3.1 for color_Background,color_TableBGTitle,color_TableTitle,color_TableBG,
+color_TableRowTitle,color_TableBGRowTitle,color_TableBorder,color_text,
+color_textpercent,color_titletext,color_weekend,color_link,color_hover,
+color_u,color_v,color_p,color_h,color_k,color_s<br>
+4.1 for color_e,color_x<br>
+5.0 for color_other<br>
+<br># Those colors parameters can be used (if StyleSheet parameter is not used)
+<br># to change AWStats look.
+<br># Example: color_name="RRGGBB"     # RRGGBB is Red Green Blue components in Hex
+<br>#
+<br>color_Background="FFFFFF"          # Background color for main page (Default = "FFFFFF")
+<br>color_TableBGTitle="CCCCDD"                # Background color for table title (Default = "CCCCDD")
+<br>color_TableTitle="000000"          # Table title font color (Default = "000000")
+<br>color_TableBG="CCCCDD"                     # Background color for table (Default = "CCCCDD")
+<br>color_TableRowTitle="FFFFFF"       # Table row title font color (Default = "FFFFFF")
+<br>color_TableBGRowTitle="ECECEC"     # Background color for row title (Default = "ECECEC")
+<br>color_TableBorder="ECECEC"         # Table border color (Default = "ECECEC")
+<br>color_text="000000"                                # Color of text (Default = "000000")
+<br>color_textpercent="606060"         # Color of text for percent values (Default = "606060")
+<br>color_titletext="000000"           # Color of text title within colored Title Rows (Default = "000000")
+<br>color_weekend="EAEAEA"                     # Color for week-end days (Default = "EAEAEA")
+<br>color_link="0011BB"                                # Color of HTML links (Default = "0011BB")
+<br>color_hover="605040"                       # Color of HTML on-mouseover links (Default = "605040") 
+<br>color_other="666688"                       # Color of text for 'other' record in charts (Default = "666688") 
+<br>color_u="FFB055"                           # Background color for number of unique visitors (Default = "FFB055")
+<br>color_v="F8E880"                           # Background color for number of visites (Default = "F8E880")
+<br>color_p="4477DD"                           # Background color for number of pages (Default = "4477DD")
+<br>color_h="66F0FF"                           # Background color for number of hits (Default = "66F0FF")
+<br>color_k="2EA495"                           # Background color for number of bytes (Default = "2EA495")
+<br>color_s="8888DD"                           # Background color for number of search (Default = "8888DD")
+<br>color_e="CEC2E8"                           # Background color for number of entry pages (Default = "CEC2E8")
+<br>color_x="C1B2E2"                           # Background color for number of exit pages (Default = "C1B2E2")
+
+<br><br><hr>
+
+<a name="LoadPlugin"><b>LoadPlugin</b></a><br>
+<b>Version : </b>5.0 +<br>
+<br># Add here all plugins file you want to load.
+<br># Plugin files must be .pm files stored in 'plugins' directory.
+<br># Uncomment LoadPlugin lines to enable a plugin after checking that plugin
+<br># required perl modules are installed.
+<br>
+<br># Plugin: PluginName
+<br># PluginName description
+<br># Perl modules required: ...
+<br>#
+<br>LoadPlugin="pluginname"
+
+<br><br><hr>
+
+<a name="include"><b>#include</b></a><br>
+<b>Version : </b>5.1 +<br>
+<br># You can include other config files using the directive with the name of the
+<br># config file (like Apache, so you must keep the '#' before 'include').
+<br># This is particularly usefull for users who have a lot of virtual servers, so
+<br># a lot of config files and want to maintain common values in only one file.
+<br># Note that when a variable is defined both in a config file and in an
+<br># included file, AWStats will use the last value read.
+<br>#
+<br>#include ""
+
+
+<!-- -------------------------------------------------------------------------------------- -->
+
+<br><br><hr>
+
+<script language=javascript>
+       var lastmod = new Date(document.lastModified);
+       if (lastmod.getDate() > 0) {
+               if (lastmod.getDate()<10) zerod="0"
+               else zerod="";
+               if (lastmod.getMonth()<9) zerom="0"
+               else zerom=""
+               year2kok=lastmod.getYear();
+               if (year2kok<100) year2kok+=2000;
+               if ((year2kok>=100) && (year2kok < 1970)) year2kok+=1900;
+               document.writeln("Last revision: "+year2kok+"-"+zerom+(lastmod.getMonth()+1)+"-"+zerod+lastmod.getDate());
+       }
+</script>
+
+</body>
+</html>
index 9e4857eae4a90325317a19b2688a439fb5f14e01..67d51325650f7470943bb5769394256e6dd9790b 100644 (file)
@@ -363,9 +363,12 @@ DefaultFile="index.html"
 # If your log file contains IP adresses in host field, you must enter here
 # matching IP adresses criteria.
 # If DNS lookup is already done in your log file, you must enter here hostname
-# criteria.
+# criteria, else enter ip address criteria.
+# The opposite parameter of "SkipHosts" is "OnlyHosts".
 # Note: Use space between each value.
-# Example: "127.0.0.1 163.84. 201.101.51.1"
+# Note: ^xxx means hosts starting with xxx.
+# Note: xxx$ means hosts ending with xxx.
+# Example: "^127.0.0.1$ ^163.84."
 # Example: "localhost abcxyz"
 # Default: ""
 #
@@ -387,16 +390,34 @@ SkipUserAgents=""
 # menus, etc...) to exclude them from statistics.
 # For example, to ignore a whole directory tree, just add "directorytoignore",
 # to ignore "users" pages in your stats, you can add "/~".
-# The oposite parameter of "SkipFiles" is "OnlyFiles".
+# The opposite parameter of "SkipFiles" is "OnlyFiles".
 # Note: This parameter is not case sensitive.
 # Note: Use space between each value and do not remove default values.
-# Note: xxx$ means URL ending with xxx.
-# Example: "robots.txt$ favicon.ico$ badpage.html /~"
+# Note: ^xxx means url starting with xxx.
+# Note: xxx$ means url ending with xxx.
+# Example: "robots.txt$ favicon.ico$ badpage.html$ /~"
 # Default: "robots.txt$ favicon.ico$"
 #
 SkipFiles="robots.txt$ favicon.ico$"
 
 
+# Include in stats, only accesses from hosts that match one of following
+# entries. For example, if you want AWStats to filter access to keep only
+# stats for visits from particular hosts, you can add thoose hosts names
+# in this parameter.
+# If DNS lookup is already done in your log file, you must enter here hostname
+# criteria, else enter ip address criteria.
+# The opposite parameter of "OnlyHosts" is "SkipHosts".
+# Note: This parameter is not case sensitive.
+# Note: Use space between each value.
+# Note: ^xxx means hosts starting with xxx.
+# Note: xxx$ means hosts ending with xxx.
+# Example: "^123.123.123.123$ ^10.0."
+# Default: ""
+#
+OnlyHosts=""
+
+
 # Include in stats, only accesses to URLs that match one of following entries.
 # For example, if you want AWStats to filter access to keep only stats that
 # match a particular string, like a particular directory, you can add this
@@ -404,7 +425,8 @@ SkipFiles="robots.txt$ favicon.ico$"
 # The opposite parameter of "OnlyFiles" is "SkipFiles".
 # Note: This parameter is not case sensitive.
 # Note: Use space between each value and do not remove default values
-# Note: xxx$ means URL ending by xxx.
+# Note: ^xxx means url starting with xxx.
+# Note: xxx$ means url ending with xxx.
 # Example: "marketing_directory"
 # Default: ""
 #
index 307759b967fcac693b616d1fddbead35acd89bf9..b8b45cb87941701aa18f9bef46858b9d73aa58fc 100644 (file)
@@ -222,7 +222,9 @@ use vars qw/
 @keylist=();
 use vars qw/
 @SessionsRange @HostAliases @AllowAccessFromWebToFollowingAuthenticatedUsers
-@DefaultFile @OnlyFiles @SkipDNSLookupFor @SkipFiles @SkipHosts @SkipUserAgents
+@DefaultFile @SkipDNSLookupFor
+@SkipHosts @SkipUserAgents @SkipFiles
+@OnlyHosts @OnlyFiles 
 @URLWithQueryWithoutFollowingParameters
 @ExtraSectionName @ExtraSectionConditional @ExtraSectionStatTypes @MaxNbOfExtra @MinHitExtra
 @ExtraSectionFirstColumnTitle @ExtraSectionFirstColumnValues
@@ -231,7 +233,9 @@ use vars qw/
 @SessionsRange=("0s-30s","30s-2mn","2mn-5mn","5mn-15mn","15mn-30mn","30mn-1h","1h+");
 @HostAliases=();
 @AllowAccessFromWebToFollowingAuthenticatedUsers=();
-@DefaultFile = @OnlyFiles = @SkipDNSLookupFor = @SkipFiles = @SkipHosts = @SkipUserAgents = ();
+@DefaultFile = @SkipDNSLookupFor = ();
+@SkipHosts = @SkipUserAgents = @SkipFiles = ();
+@OnlyHosts = @OnlyFiles = ();
 @URLWithQueryWithoutFollowingParameters = ();
 @ExtraSectionName = @ExtraSectionConditional = @ExtraSectionStatTypes = @MaxNbOfExtra = @MinHitExtra = ();
 @ExtraSectionFirstColumnTitle = @ExtraSectionFirstColumnValues = ();
@@ -826,16 +830,6 @@ sub SkipDNSLookup {
        0; # Not in @SkipDNSLookupFor
 }
 
-#------------------------------------------------------------------------------
-# Function:     Check if parameter is in SkiFiles array
-# Parameters:  url @SkipFiles
-# Return:              0 Not found, 1 Found
-#------------------------------------------------------------------------------
-sub SkipFile {
-       foreach my $match (@SkipFiles) { if ($_[0] =~ /$match/i) { return 1; } }
-       0; # Not in @SkipFiles
-}
-
 #------------------------------------------------------------------------------
 # Function:     Check if parameter is in SkiHosts array
 # Parameters:  host @SkipHosts
@@ -847,8 +841,8 @@ sub SkipHost {
 }
 
 #------------------------------------------------------------------------------
-# Function:     Check if parameter is in UserAgent array
-# Parameters:  host @SkipHosts
+# Function:     Check if parameter is in SkipUserAgents array
+# Parameters:  useragent @SkipUserAgents
 # Return:              0 Not found, 1 Found
 #------------------------------------------------------------------------------
 sub SkipUserAgent {
@@ -856,6 +850,26 @@ sub SkipUserAgent {
        0; # Not in @SkipUserAgent
 }
 
+#------------------------------------------------------------------------------
+# Function:     Check if parameter is in SkiFiles array
+# Parameters:  url @SkipFiles
+# Return:              0 Not found, 1 Found
+#------------------------------------------------------------------------------
+sub SkipFile {
+       foreach my $match (@SkipFiles) { if ($_[0] =~ /$match/i) { return 1; } }
+       0; # Not in @SkipFiles
+}
+
+#------------------------------------------------------------------------------
+# Function:     Check if parameter is in OnlyHosts array
+# Parameters:  host @OnlyHosts
+# Return:              0 Not found, 1 Found
+#------------------------------------------------------------------------------
+sub OnlyHost {
+       foreach my $match (@OnlyHosts) { if ($_[0] =~ /$match/i) { return 1; } }
+       0; # Not in @OnlyHosts
+}
+
 #------------------------------------------------------------------------------
 # Function:     Check if parameter is in OnlyFiles array
 # Parameters:  url @OnlyFiles
@@ -1097,6 +1111,11 @@ sub Parse_Config {
                        foreach my $elem (split(/\s+/,$value))  { push @SkipFiles,$elem; }
                        next;
                        }
+               if ($param =~ /^OnlyHosts/) {
+                       $value =~ s/\\\./\./g; $value =~ s/([^\\])\./$1\\\./g; $value =~ s/^\./\\\./;   # Replace . into \.
+                       foreach my $elem (split(/\s+/,$value))  { push @OnlyHosts,$elem; }
+                       next;
+                       }
                if ($param =~ /^OnlyFiles/) {
                        $value =~ s/\\\./\./g; $value =~ s/([^\\])\./$1\\\./g; $value =~ s/^\./\\\./;   # Replace . into \.
                        foreach my $elem (split(/\s+/,$value))  { push @OnlyFiles,$elem; }
@@ -4474,13 +4493,14 @@ if ($UpdateStats && $FrameName ne 'index' && $FrameName ne 'mainleft') {        # Updat
        }
        unshift @HostAliases,"$SiteToAnalyze";  # Add SiteToAnalyze
 
-       # Optimize HostAliases, SkipHosts, SkipFiles, OnlyFiles, SkipDNSLookupFor array
+       # Optimize HostAliases, SkipDNSLookupFor, SkipHosts, SkipUserAgents, SkipFiles, OnlyHosts, OnlyFiles array
        &OptimizeArray(\@HostAliases,1,1); if ($Debug) { debug("HostAliases is now @HostAliases",1); }
+       &OptimizeArray(\@SkipDNSLookupFor,1,0); if ($Debug) { debug("SkipDNSLookupFor is now @SkipDNSLookupFor",1); }
        &OptimizeArray(\@SkipHosts,1,0); if ($Debug) { debug("SkipHosts is now @SkipHosts",1); }
        &OptimizeArray(\@SkipUserAgents,1,0); if ($Debug) { debug("SkipUserAgents is now @SkipUserAgents",1); }
        &OptimizeArray(\@SkipFiles,0,0); if ($Debug) { debug("SkipFiles is now @SkipFiles",1); }
+       &OptimizeArray(\@OnlyHosts,1,0); if ($Debug) { debug("OnlyHosts is now @OnlyHosts",1); }
        &OptimizeArray(\@OnlyFiles,0,0); if ($Debug) { debug("OnlyFiles is now @OnlyFiles",1); }
-       &OptimizeArray(\@SkipDNSLookupFor,1,0); if ($Debug) { debug("SkipDNSLookupFor is now @SkipDNSLookupFor",1); }
 
        # GENERATING PerlParsingFormat
        #------------------------------------------
@@ -4857,9 +4877,10 @@ if ($UpdateStats && $FrameName ne 'index' && $FrameName ne 'mainleft') { # Updat
 
                # Skip for some client host IP addresses, some URLs, other URLs
                my $qualifdrop="";
-               if (@SkipHosts && &SkipHost($field[$pos_host]))     { $qualifdrop="Dropped record (host $field[$pos_host] not qualified by SkipHosts)"; }
-               elsif (@SkipFiles && &SkipFile($field[$pos_url]))   { $qualifdrop="Dropped record (URL $field[$pos_url] not qualified by SkipFiles)"; }
-               elsif (@OnlyFiles && ! &OnlyFile($field[$pos_url])) { $qualifdrop="Dropped record (URL $field[$pos_url] not qualified by OnlyFiles)"; }
+               if    (@SkipHosts && &SkipHost($field[$pos_host]))   { $qualifdrop="Dropped record (host $field[$pos_host] not qualified by SkipHosts)"; }
+               elsif (@SkipFiles && &SkipFile($field[$pos_url]))    { $qualifdrop="Dropped record (URL $field[$pos_url] not qualified by SkipFiles)"; }
+               elsif (@OnlyHosts && ! &OnlyHost($field[$pos_host])) { $qualifdrop="Dropped record (host $field[$pos_host] not qualified by OnlyHosts)"; }
+               elsif (@OnlyFiles && ! &OnlyFile($field[$pos_url]))  { $qualifdrop="Dropped record (URL $field[$pos_url] not qualified by OnlyFiles)"; }
                elsif ($pos_agent >= 0 && @SkipUserAgents && &SkipUserAgent($field[$pos_agent]))        { $qualifdrop="Dropped record (user agent $field[$pos_agent] not qualified by SkipUserAgents)"; }
                if ($qualifdrop) {
                        $NbOfLinesDropped++;
@@ -8007,6 +8028,7 @@ else {
 #     If new line
 #        Skip line for SkipHosts
 #        Skip line for SkipFiles
+#        Skip line for not OnlyHosts
 #        Skip line for not OnlyFiles
 #        Skip line for SkipUserAgent
 #        If other month/year, create/update tmp file and purge data arrays with