readme

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

          current browsers go by, depending where they were obtained,
          however you might have some particular user agents that hit
          your site a lot that you would like to exclude from the list.
          You must have a web server that includes user agents in it's
          log files for this option to be of any use.  In addition, it
          is also useless if you disable the user agent table in the
          report (see the -A command line option or "TopAgents"
          configuration file keyword). You can specify as many of these
          as you want on the command line.  The wildcard character '*'
          can be used either in front of or at the end of the string.
          (ie: Mozilla/4.0* would match anything that starts with the
          string "Mozilla/4.0").
          Config file keyword: HideAgent

-r name   This option allows hiding of referrers from the "Top Referrer"
          table in the report.  Referrers are URL's, either on your own
          local site or a remote site, that referred the user to a URL
          on your web server.  This option is normally used to hide
          your own server from the table, as your own pages are usually
          the top referrers to your own pages (well, you get the idea).
          You must have a web server that includes referrer information
          in the log files for this option to be of any use.  In addition,
          it is also useless if you disable the referrers table in the
          report (see the -R command line option or "TopReferrers"
          configuration file keyword).  You can specify as many of these
          as you like on the command line.
          Config file keyword: HideReferrer

-s name   This option allows hiding of sites from the "Top Sites" table
          in the report.  Normally, you will only want to hide your own
          domain name from the report, as it usually is one of the top
          sites to visit your web server.  This option is of no use if
          you disable the top sites table in the report (see the -S
          command line option or "TopSites" configuration file option).
          Config file keyword: HideSite

-X        This causes all individual sites to be hidden, which results
          in only grouped sites to be displayed on the report.
          Config file keyword: HideAllSites

-u name   This option allows hiding of URL's from the "Top URL's" table
          in the report.  Normally, this option is used to hide images,
          audio files and other objects your web server dishes out that
          would otherwise clutter up the table.  This option is of no
          use if you disable the top URL's table in the report (see the
          -U command line option or "TopURLs" configuration file keyword).
          Config file keyword: HideURL

-I name   This option allows you to specify additional index.html aliases.
          The Webalizer usually strips the string 'index.' from URL's
          before processing, which has the effect of turning a URL such
          as /somedir/index.html into just /somedir/ which is really the
          same URL and should be treated as such.  This option allows you
          to specify _additional_ strings that are to be treated the same
          way.  Use with care, improper use could cause unexpected results.
          For example, if you specify the alias string of 'home', a URL
          such as /somedir/homepages/brad/home.html would be converted
          into just /somedir/ which probably isn't what was intended.
          This option is useful if your web server uses a different default
          index page other than the standard 'index.html' or 'index.htm',
          such as 'home.html' or 'homepage.html'.  The string specified
          is searched for _anywhere_ in the URL, so "home.htm" would
          turn both "/somedir/home.htm" and "/somedir/home.html" into
          just "/somedir/".  Go easy on this one, each string specified
          will be scanned for in EVERY log record, so if you specify a
          bunch of these, you will notice degraded performance.  Wildcards
          are not allowed on this one.
          Config file keyword: IndexAlias

Table Size Options
------------------

-e num    This option specifies the number of entries to display in the
          "Top Entry Pages" table.  To disable the table, use a value of
          zero (0).
          Config file keyword: TopEntry

-E num    This option specifies the number of entries to display in the
          "Top Exit Pages" table.  To disable the table, use a value of
          zero (0).
          Config file keyword: TopExit

-A num    This option specifies the number of entries to display in the
          "Top User Agents" table.  To disable the table, use a value of
          zero (0).
          Config file keyword: TopAgents

-C num    This option specifies the number of entries to display in the
          "Top Countries" table.  To disable the table, use a value of
          zero (0).
          Config file keyword: TopCountries

-R num    This option specifies the number of entries to display in the
          "Top Referrers" table.  To disable the table, use a value of
          zero (0).
          Config file keyword: TopReferrers

-S num    This option specifies the number of entries to display in the
          "Top Sites" table.  To disable the table, use a value of
          zero (0).
          Config file keyword: TopSites

-U num    This option specifies the number of entries to display in the
          "Top URL's" table.  To disable the table, use a value of
          zero (0).
          Config file keyword: TopURLs

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


CONFIGURATION FILES
-------------------

The Webalizer allows configuration files to be used in order to simplify
life for all.  There are several ways that configuration files are accessed
by the Webalizer.  When The Webalizer first executes, it looks for a
default configuration file named "webalizer.conf" in the current directory,
and if not found there, will look for "/etc/webalizer.conf".  In addition,
configuration files may be specified on the command line with the '-c'
option.  There are lots of different ways you can combine the use of
configuration files and command line options to produce various results.
The Webalizer always looks for and reads configuration options from a
default configuration file before doing anything else.  Because of this,
you can override options found in the default file by use of additional
configuration files specified on the command line or command line options
themselves.  If you specify a configuration file on the command line, you
can override options in it by additional command line options which follow.
For example, most users will most likely want to create the default file
/etc/webalizer.conf and place options in it to specify the hostname, log
file, table options, etc...  At the end of the month when a different log
file is to be used (the end of month log), you can run The Webalizer as
usual, but put the different filename on the end of the command line, which
will override the log file specified in the configuration file.  It should
be noted that you cannot override some configuration file options by the
use of command line arguments.  For example, if you specify "Quiet yes" in
a configuration file, you cannot override this with a command line argument,
as the command line option only _enables_ the feature (-q option).

The configuration files are standard ASCII text files that may be created
or edited using any standard editor.  Blank lines and lines that begin
with a pound sign ('#') are ignored.  Any other lines are considered to
be configuration lines, and have the form "Keyword Value", where the
'Keyword' is one of the currently available configuration keywords defined
below, and 'Value' is the value to assign to that particular option.  Any
text found after the keyword up to the end of the line is considered the
keyword's value, so you should not include anything after the actual value
on the line that is not actually part of the value being assigned.  The
file "sample.conf" provided with the distribution contains lots of useful
documentation and examples as well.  It should be noted that you do not
have to use any configuration files at all, in which case, default values
will be used (which should be sufficient for most sites).

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

General Configuration Keywords
------------------------------

LogFile       This defines the log file to use. It should be a fully qualified
              name (ie: contain the path), but relative names will work as
              well.  If not specified, the logfile defaults to STDIN. 

LogType       This specified the log file type being used.  Normally, The
              Webalizer processes web logs in either CLF or Combined format.
              You may also process wu-ftpd xferlog formatted logs, or squid
              proxy logs by setting the appropriate type using this keyword.
              Values may be either 'clf', 'ftp' or 'squid'.  Ensure that you
              specify the proper file type, otherwise you will be presented
              with a long stream of 'invalid record' messages ;)
              Command line argument: -F

OutputDir     This defines the output directory to use for the reports.  If
              it is not specified, the current directory is used.
              Command line argument: -o

HistoryName   Allows specification of a history path/filename if desired.
              The default is to use the file named 'webalizer.hist', kept
              in the normal output directory (OutputDir above).  Any name
              specified is relative to the normal output directory unless
              an absolute path name is given (ie: starts with a '/').

ReportTitle   This specifies the title to use for the generated reports.
              It is used in conjunction with the hostname (unless blank)
              to produce the final report titles.  If not defined, the
              default of "Usage Statistics for" is used.
              Command line argument: -t

HostName      This defines the hostname.  The hostname is used in the
              report title as well as being prepended to URL's in the
              "Top URL's" table.  This allows The Webalizer to be run
              on "virtual" web servers, or servers that do not reside
              on the local machine, and allows clicking on the URL to
              go to the right place.  If not specified, The Webalizer
              attempts to get the hostname via a 'uname' system call,
              and if that fails, will default to "localhost".
              Command line argument: -n

UseHTTPS      Causes the links in the 'Top URL's' table to use 'https://'
              instead of the default 'http://' prefix.  Not much use if
              you run a mix of secure/insecure servers on your machine.
              Only useful if you run the analysis on a secure servers
              logs, and want the links in the table to work properly.

Quiet         This allows you to enable or disable informational messages
              while it is running.  The values for this keyword can be
              either 'yes' or 'no'.  Using "Quiet yes" will suppress these
              messages, while "Quiet no" will enable them.  The default
              is 'no' if not specified, which will allow The Webalizer
              to display informational messages.  It should be noted that
              this option has no effect on Warning or Error messages that
              may be generated, as they go to STDERR.
              Command line argument: -q

TimeMe        This allows you to display timing information regardless of
              any "quiet mode" specified.  Useful only if you did in fact
              tell the webalizer to be quiet either by using the -q command
              line option or the "Quiet" keyword, otherwise timing stats
              are normally displayed anyway.  Values may be either 'yes'
              or 'no', with the default being 'no'.
              Command line argument: -T

GMTTime       This keyword allows timestamps to be displayed in GMT (UTC)
              time instead of local time.  Normally The Webalizer will
              display timestamps in the time-zone of the local machine
              (ie: PST or EDT).  This keyword allows you to specify the
              display of timestamps in GMT (UTC) time instead.  Values
              may be either 'yes' or 'no'.  Default is 'no'.

Debug         This tells The Webalizer to display additional information
              when it encounters Warnings or Errors.  Normally, The
              Webalizer will just tell you it found a bad record or
              field.  This option will enable the display of the actual
              data that produced the Warning or Error as well.  Useful
              only if you start getting lots of Warnings or Errors and
              want to determine the cause.  Values may be either 'yes'
              or 'no', with the default being 'no'.
              Command line argument: -d

IgnoreHist    This suppresses the reading of a history file.  USE WITH
              EXTREME CAUTION as the history file is how The Webalizer
              keeps track of previous months.  The effect of this option
              is as if The Webalizer was being run for the very first
              time, and any previous data is discarded.  Values may be
              either 'yes' or 'no', with the default being 'no'.
              Command line argument: -i

FoldSeqErr    Allows log records that are out of sequence to be folded
              back into the analysis, by treating them as if they had
              the same date/time as the last good record.  Normally,
              out of sequence log records are simply ignored.  If you