readme

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

Note: A kilobyte is 1024 bytes, not 1000 :)

Top Entry and Exit Pages

  The Top Entry and Exit tables give a rough estimate of what URL's
are used to enter your site, and what the last pages viewed are.
Because of limitations in the HTTP protocol, log rotations, etc...
this number should be considered a good "rough guess" of the actual
numbers, however will give a good indication of the overall trend in
where users come into, and exit, your site.


Command Line Options
--------------------

The Webalizer supports many different configuration options that will
alter the way the program behaves and generates output.  Most of these
can be specified on the command line, while some can only be specified
in a configuration file. The command line options are listed below,
with references to the corresponding configuration file keywords.

--------------------------------------------------------------------------

General Options
---------------

-h        Display all available command line options and exit program.

-v        Display program version and exit program.

-d        Display additional 'debugging' information for errors and
          warnings produced during processing.  This normally would
          not be used except to determine why you are getting all those
          errors and wanted to see the actual data.  Normally The
          Webalizer will just tell you it found an error, not the
          actual data.  This option will display the data as well.
          Config file keyword: Debug

-F        Specify that the log being used is a ftp log.  Normally, the
          Webalizer expects to find a valid CLF or Combined format
          we server log file.  This option allows you to process wu-ftpd
          xferlogs as well.
          Config file keyword: LogType

-f        Fold out of sequence log records back into analysis, by
          treating them as if they were the same date/time as the
          last good record.  Normally, out of sequence log records
          are ignored.  If you run apache, don't worry about this.
          Config file keyword: FoldSeqErr

-i        Ignore history file.  USE WITH CAUTION.  This causes The
          Webalizer to ignore any existing history file produced from
          previous runs and generate it's output from scratch.  The
          effect will be as if The Webalizer is being run for the
          first time and any previous statistics will be lost (although
          the HTML documents, if any, will not be deleted) on the main
          index.html (yearly) web page.
          Config file keyword: IgnoreHist

-p        Preserve state (incremental processing).  This allows the
          processing of partial logs in increments.  At the end of
          the program, all relevant internal data is saved, so that
          it may be restored the next time the program is run.  This
          allows sites that must rotate their logs more than once a
          month to still be able to use The Webalizer, and not worry
          about having to gather and feed an entire months logs to
          the program at the end of the month.  See the section on
          "Incremental Processing" below for additional information.
          The default is to not perform incremental processing.  Use
          this command line option to enable the feature.
          Config file keyword: Incremental

-q        Quiet mode.  Normally, The Webalizer will produce various
          messages while it runs letting you know what it's doing.
          This option will suppress those messages.  It should be
          noted that this WILL NOT suppress errors and warnings, which
          are output to STDERR.
          Config file keyword: Quiet

-Q        ReallyQuiet mode.  This allows suppression of _all_ messages
          generated by The Webalizer, including warnings and errors.
          Useful when The Webalizer is run as a cron job.
          Config file keyword: ReallyQuiet

-T        Display timing information.  The Webalizer keeps track of the
          time it begins and ends processing, and normally displays the
          total processing time at the end of each run.  If quiet mode
          (-q or 'Quiet yes' in configuration file) is specified, this
          information is not displayed.  This option forces the display
          of timing totals if quiet mode has been specified, otherwise
          it is redundant and will have no effect.
          Config file keyword: TimeMe

-c file   This option specifies a configuration file to use.  Configuration
          files allow greater control over how The Webalizer behaves, and
          there are several ways to use them.  As of version 0.98, The
          Webalizer searches for a default configuration file in the
          current directory named "webalizer.conf", and if not found,
          will search in the /etc/ directory for a file of the same name.
          In addition, you may specify a configuration file to use with
          this command line option.

-n name   This option specifies the hostname for the reports generated.
          The hostname is used in the title of all reports, and is also
          prepended to URL's in the reports.  This allows The Webalizer
          to be run on log files for 'virtual' web servers or web servers
          that are different than the machine the reports are located on,
          and still allows clicking on the URL's to go to the proper
          location.  If a hostname is not specified, either on the
          command line or in a configuration file, The Webalizer attempts
          to determine the hostname using a 'uname' system call.  If this
          fails, "localhost" will be used as the hostname.
          Config file keyword: HostName

-o dir    This options specifies the output directory for the reports.
          If not specified here or in a configuration file, the current
          default directory will be used for output.
          Config file keyword: OutputDir

-x name   This option allows the generated pages to have an extension
          other than '.html', which is the default.  Do not include the
          leading period ('.') when you specify the extension.
          Config file keyword: HTMLExtension

-P name   Specify the file extensions for 'pages'.  Pages (sometimes
          called 'PageViews') are normally html documents and CGI
          scripts that display the whole page, not just parts of it.
          Some system will need to define a few more, such as 'phtml',
          'php3' or 'pl' in order to have them counted as well.  The
          default is 'htm*' and 'cgi' for web logs and 'txt' for ftp.
          Config file keyword: PageType

-t name   This option specifies the title string for all reports.  This
          string is used, in conjunction with the hostname (if not blank)
          to produce the actual title.  If not specified, the default of
          "Usage Statistics for" will be used.
          Config file keyword: ReportTitle

-Y        Supress Country graph.  Normally, The Webalizer produces
          country statistics in both Graph and Columnar forms.  This
          option will suppress the Country Graph from being generated.
          Config file keyword: CountryGraph

-G        Supress hourly graph.  Normally, The Webalizer produces
          hourly statistics in both Graph and Columnar forms.  This
          option will suppress the Hourly Graph only from being generated.
          Config file keyword: HourlyGraph

-H        Supress Hourly statistics.  Normally, The Webalizer produces
          hourly statistics in both Graph and Columnar forms.  This
          option will suppress the Hourly Statistics table only from
          being generated.
          Config file keyword: HourlyStats

-L        Disable Graph Legends.  The color coded legends displayed on
          the in-line graphs can be disabled with this option.  The
          default is to display the legends.
          Config file keyword: GraphLegend

-l num    Graph Lines.  Specify the number of background reference
          lines displayed on the in-line graphics produced.  The default
          is 2 lines, however can range anywhere from zero ('0') for
          no lines, up to 20 lines (looks funny!).
          Config file keyword: GraphLines

-P name   Page type.  This is the extension of files you consider to
          be pages for Pages calculations (sometimes called 'pageviews').
          The default is 'htm*' and 'cgi' (plus whatever HTMLExtension
          you specified if it is different).  Don't use a period!

-m num    Specify a 'visit timeout'.  Visits are calculated by looking at
          the time difference between the current and last request made
          by a specific host.  If the difference is greater that the
          visit timeout value, the request is considered a new visit.
          This value is specified in number of seconds.  The default
          is 30 minutes (1800).
          Config file keyword: VisitTimeout

-M num    Mangle user agent names.  Normally, The Webalizer will keep
          track of the user agent field verbatim.  Unfortunately, there are
          a ton of different names that user agents go by, and the field
          also reports other items such as machine type and OS used. For
          Example, Netscape 4.03 running on Windows 95 will report a
          different string than Netscape 4.03 running on Windows NT, so even
          though they are the same browser type, they will be considered
          as two totally different browsers by The Webalizer.  For that
          matter, Netscape 4.0 running on Windows NT will report different
          names if one is run on an Alpha and the other on an Intel
          processor!  Internet Exploder is even worse, as it reports itself
          as if it were Netscape and you have to search the given string a
          little deeper to discover that it is really MSIE!  In order to
          consolidate generic browser types, this option will cause The
          Webalizer to 'mangle' the user agent field, attempting to
          consolidate generic browser types. There are 6 levels that can be
          specified, each producing different levels of detail.  Level 5
          displays only the browser name (MSIE or Mozilla) and the major
          version number.  Level 4 will also display the minor version
          number (single decimal place).  Level 3 will display the minor
          version number to two decimal places.  Level 2 will 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 disable name mangling and leave the user agent
          field unmodified, producing the greatest amount of detail.
          Configuration file keyword: MangleAgents

-g num    This option allows you to specify the level of domains name
          grouping to be performed.  The numeric value represents the
          level of grouping, and can be thought of as the 'number of
          dots' to be displayed.  The default value of 0 disables any
          domain name grouping.
          Configuration file keyword: GroupDomains

-D name   This allows the specification of a DNS Cache file name.  This
          filename MUST be specified if you have dns lookups enabled
          (using the -N command line switch or DNSChildren configuration
          keyword).  The filename is relative to the default output
          directory if an absolute path is not specified (ie: starts
          with a leading '/').  This option is only available if DNS
          support was enabled at compile time, otherwise an 'Invalid
          Keyword' error will be generated.  See the DNS.README file
          for additional information regarding DNS lookups.

-N num    Number of DNS child processes to use for reverse DNS lookups.
          If specified, a DNSCache name MUST be specified also.  If you
          do not wish a DNS cache file to be generated, specify a value
          of zero ('0') to disable it.  This does not prevent using an
          existing cache file, only the generation of one at run time.
          See the DNS.README file for additional information regarding
          DNS lookups.


Hide Options
------------

The following options take a string argument to use as a comparison
for matching.  Except for the IndexAlias option, the string argument
can be plain text, or plain text that either starts or ends with the
wildcard character '*'.

For Example:

Given the string "yourmama/was/here", the arguments "was", "*here" and
"your*" will all produce a match.


-a name   This option allows hiding of user agents (browsers) from the
          "Top User Agents" table in the report.  This option really
          isn't too useful as there are a zillion different names that