readme

c语言实现的web http报文分析

              run apache, don't worry about this.

VisitTimeout  Set the 'visit timeout' value.  Visits are determined by
              looking at the time difference between the current and last
              request made by a specific site.  If the difference in time
              is greater than the visit timeout value, the request is
              considered a new visit.  The value is in number of seconds,
              and defaults to 30 minutes (1800).
              Command line argument: -m

PageType      Allows you to define the 'page' type extension.  Normally,
              people consider HTML and CGI scripts as 'pages'.  This
              option allows you to specify what extensions you consider
              a page.  Default is 'htm*' and 'cgi' for web logs, and
              'txt' for ftp logs.
              Command line argument: -P

GraphLegend   Enable/disable the display of color coded legends on the
              produced graphs.  Default is 'yes', to display them.
              Command line argument: -L

GraphLines    Specify the number of background reference lines to display
              on produced graphs.  The default is 2.  To disable the use
              of background lines, use zero ('0').
              Command line argument: -l

CountryGraph  This keyword is used to either enable or disable the creation
              and display of the Country Usage graph.  Values may be either
              'yes' or 'no', with the default being 'yes'.
              Command line argument: -Y

DailyGraph    This keyword is used to either enable or disable the creation
              and display of the Daily Usage graph.  Values may be either
              'yes' or 'no', with the default being 'yes'.

DailyStats    This keyword is used to either enable or disable the creation
              and display of the Daily Usage statistics table.  Values may
              be either 'yes' or 'no', with the default being 'yes'.

HourlyGraph   This keyword is used to either enable or disable the creation
              and display of the Hourly Usage graph.  Values may be either
              'yes' or 'no', with the default being 'yes'.
              Command line argument: -G

HourlyStats   This keyword is used to either enable or disable the creation
              and display of the Hourly Usage statistics table.  Values may
              be either 'yes' or 'no', with the default being 'yes'.
              Command line argument: -H

IndexAlias    This allows additional 'index.html' aliases to be defined.
              Normally, The Webalizer scans for and strips the string
              "index." from URL's before processing them.  This turns a
              URL such as /somedir/index.html into just /somedir/ which
              is really the same URL.  This keyword allows _additional_
              names to be treated in the same fashion for sites that use
              different default names, such as "home.html".  The string
              is scanned for anywhere in the URL, so care should be used
              if and when you define additional aliases.  For example,
              if you were to use an alias such as 'home', the URL
              /somedir/homepages/brad/home.html would be turned into just
              /somedir/ which probably isn't the intended result.  Instead,
              you should have specified 'home.htm' which would correctly
              turn the URL into /somedir/homepages/brad/ like intended.
              It should also be noted that specified aliases are scanned
              for in EVERY log record... A bunch of aliases will noticeably
              degrade performance as each record has to be scanned for
              every alias defined.  You don't have to specify 'index.' as
              it is always the default.
              Command line argument: -I 

MangleAgents  The MangleAgents keyword specifies the level of user agent
              name mangling, if any.  There are 6 levels that may be specified,
              each producing a different level of detail displayed.  Level 5
              displays only the browser name (MSIE or Mozilla) and the major
              version number.  Level 4 adds the minor version (single
              decimal place).  Level 3 adds the minor version to two decimal
              places.  Level 2 will also add any sub-level designation
              (such as Mozilla/3.01Gold or MSIE 3.0b).  Level 1 will also
              attempt to add the system type.  The default level 0 will
              leave the user agent field unmodified and produces the
              greatest amount of detail.
              Command line argument: -M

SearchEngine  This keyword allows specification of search engines and
              their query strings.  Search strings are obtained from
              the referrer field in the record, and in order to work
              properly, the Webalizer needs to know what query strings
              different search engines use.  The SearchEngine allows
              you to specify the search engine and it's query string
              to parse the search string from.  The line is formatted
              as:  "SearchEngine engine-string query-string"  where
              'engine-string' is a substring for matching the search
              engine with, such as "yahoo.com" or "altavista".  The
              'query-string' is the unique query string that is added
              to the URL for the search engine, such as "search=" or
              "MT=" with the actual search strings appended to the
              end.  There is no command line option for this keyword.

Incremental   This allows incremental processing to be enabled or disabled.
              Incremental processing allows processing partial logs without
              the loss of detail data from previous runs in the same month.
              This feature saves the 'internal state' of the program so that
              it may be restored in following runs.  See the section above
              titled "Incremental Processing" for additional information.
              The value may be 'yes' or 'no', with the default being 'no'.
              Command line argument: -p

IncrementalName
              Allows specification of the incremental data filename if
              desired.  Normally, the file named "webalizer.current' is
              used, kept in the standard output directory.  If specified,
              filenames are relative to the standard output directory,
              unless an absolute name is given (ie: starts with '/').

DNSCache      Specifies the DNS cache filename.  This name is relative
              to the default output directory unless an absolute name
              is given (ie: starts with '/').  See the DNS.README file
              for additional information.

DNSChildren   The number of DNS children processes to run in order to
              create/update the DNS cache file.  If specified, the DNS
              cache filename must also be specified (see above).  Use
              a value of zero ('0') to disable.  See the DNS.README
              file for additional information.


Top Table Keywords
------------------

TopAgents     This allows you to specify how many "Top" user agents are
              displayed in the "Top User Agents" table.  The default
              is 15.  If you do not want to display user agent statistics,
              specify a value of zero (0).  The display of user agents
              will only work if your web server includes this information
              in its log file (ie: a combined log format file).
              Command line argument: -A 

AllAgents     Will cause a separate HTML page to be generated for all
              normally visable User Agents.  A link will be added to
              the bottom of the "Top User Agents" table if enabled.
              Value can be either 'yes' or 'no', with 'no' being the
              default.

TopCountries  This allows you to specify how many "Top" countries are
              displayed in the "Top Countries" table.  The default is
              30.  If you want to disable the countries table, specify
              a value of zero (0).
              Command line argument: -C 

TopReferrers  This allows you to specify how many "Top" referrers are
              displayed in the "Top Referrers" table.  The default is
              30.  If you want to disable the referrers table, specify
              a value of zero (0).  The display of referrer information
              will only work if your web server includes this information
              in its log file (ie: a combined log format file).
              Command line argument: -R 

AllReferrers  Will cause a separate HTML page to be generated for all
              normally visable Referrers.  A link will be added to the
              "Top Referrers" table if enabled.  Value can be either
              'yes' or 'no', with 'no' being the default.

TopSites      This allows you to specify how many "Top" sites are
              displayed in the "Top Sites" table.  The default is 30.
              If you want to disable the sites table, specify a value
              of zero (0).
              Command line argument: -S 

TopKSites     Identical to TopSites, except for the 'by KByte' table.
              Default is 10.  No command line switch for this one.

AllSites      Will cause a separate HTML page to be generated for all
              normally visable Sites.  A link will be added to the
              bottom of the "Top Sites" table if enabled.  Value can
              be either 'yes' or 'no', with 'no' being the default.

TopURLs       This allows you to specify how many "Top" URL's are
              displayed in the "Top URL's" table.  The default is 30.
              If you want to disable the URL's table, specify a value
              of zero (0).
              Command line argument: -U 

TopKURLs      Identical to TopURLs, except for the 'by KByte' table.
              Default is 10.  No command line switch for this one.

AllURLs       Will cause a separate HTML page to be generated for all
              normally visable URLs.  A link will be added to the
              bottom of the "Top URLs" table if enabled.  Value can
              be either 'yes' or 'no', with 'no' being the default.

TopEntry      Allows you to specify how many "Top Entry Pages" are
              displayed in the table.  The default is 10.  If you
              want to disable the table, specify a value of zero (0).
              Command line argument: -e

TopExit       Allows you to specify how many "Top Exit Pages" are
              displayed in the table.  The default is 10.  If you
              want to disable the table, specify a value of zero (0).
              Command line argument: -E

TopSearch     Allows you to specify how many "Top Search Strings" are
              displayed in the table.  The default is 20.  If you
              want to disable the table, specify a value of zero (0).
              Only works if using combined log format (ie: contains
              referrer information).

TopUsers      This allows you to specify how many "Top" usernames are
              displayed in the "Top Usernames" table.  Usernames are
              only available if you use http authentication on your
              web server, or when processing wu-ftpd xferlogs.  The
              default value is 20.  If you want to disable the Username
              table, specify a value of zero (0).

AllUsers      Will cause a separate HTML page to be generated for all
              normally visable usernames.  A link will be added to the
              bottom of the "Top Usernames" table if enabled.  Value
              can be either 'yes' or 'no', with 'no' being the default.

AllSearchStr  Will create a separate HTML page to be generated for all
              normally visable Search Strings.  A link will be added
              to the bottom of the "Top Search Strings" table if
              enabled.  Value can be either 'yes' or 'no', with 'no'
              being the default.


Hide Object Keywords
--------------------

These keywords allow you to hide user agents, referrers, sites, URL's
and usernames from the various "Top" tables.  The value for these keywords
are the same as those used in their command line counterparts.  You
can specify as many of these as you want without limit.  Refer to the
section above on "Command Line Options" for a description of the string
formatting used as the value.  Values cannot exceed 80 characters in
length.

HideAgent     This allows specified user agents to be hidden from the
              "Top User Agents" table.  Not very useful, since there
              a zillion different names by which browsers go by today,
              but could be useful if there is a particular user agent
              (ie: robots, spiders, real-audio, etc..) that hits your
              site frequently enough to make it into the top user agent
              listing.  This keyword is useless if 1) your log file does
              not provide user agent information or 2) you disable the
              user agent table.
              Command line argument: -a 

HideReferrer  This allows you to hide specified referrers from the
              "Top Referrers" table.  Normally, you would only specify