stat.exe .02 - A more in depth stats program for OmniHTTPDd

I ask absolutely nothing for this program except that if you find the 
time, to come by my site and check it out (it's listed below).

I.      Intro
II.     Known Conflicts
III.    Setup
IV.     Problems?
V.      Future Updates
VI.     Format Specifiers
------------------------

I. Intro
--------
This program is a statistics generator for OmniHTTPd.  It is meant as
a cumulative statistics generator.  It is meant for the hobbyist who is
currious about the usage of their server.  This by no means a comprehensive 
stats program and is not meant to be anything more than an interesting 
diversion from oridinary webmaster life.  To see mine in action, check out
http://reflux.mcm.housing.washington.edu/stat/stat.htm

II.  Known Conflicts/Restrictions
---------------------------------
Stats can't access the file access.log while OmniHTTPd is running 
so I included some .BAT files for performing updates while the server
is running.  This can cause problems if the file is copied durring an update.
I've only run into this once out of the million times I've run it so if the 
program frezzes, stop it and try again. STAT.EXE takes input in this form:

STAT INPUT.LOG PARTUP|FULLUP TEMPLATE.HTM [debugON]

Where INPUT.LOG is the log file to read from and TEMPLATE.HTM is a file 
that contains the format specifiers (see below for more details and look at 
sample file provided).  PARTUP or FULLUP tell the program which update mode 
to use.  PARTUP will look at the file "PAST.STA" for past stats, read them 
in if they exist, perform the reading on the log file then quit without 
updating the "PAST.STA" file.  This is useful if you don't want to delete 
your log file but keep the stats current.  FULLUP does the same thing except 
also updates the stats in the "PAST.STA" file.  So for FULLUP, you should 
delete the access.log after you run stats in order to keep the stats correct.  
I only use this mode when my access.log gets to big. :)  The stats will then 
be put into the template form and outputed to the file "STAT.HTM" so make sure 
you don't already have one in that directory or it will be deleted.

The "debugON" option is optional while all others are required.  You should use 
it when if program freezes.  It prints output of it's reads to give you a hint 
of where the problem in a log file lies.

III.  Setup
-----------
Here's a quick and dirty setup guide to running visitor.exe on your 
web server.

A. Copy the included files to the LOGS subdirectory of your httpd directory.

B. Edit the batch files for descriptions of what they do.

C. Run each one accordingly to what you want to do. 


IV. Problems? Suggestions?
--------------------------

Now since you didn't pay for this, I don't have a toll-free technical
support line to help you (Not that Microsoft has one mind you) but I 
will try to help you out if I can.  Keep in mind that I am a student as
well and as much as I would like computer time to come first, it can't
always.  Also, any suggestions are welcome. My current email is 
"reflux@u.washington.edu" and my server is at 
"http://reflux.mcm.housing.washington.edu".

V. Future Updates
-----------------
I will dedicate a page on my server for a while to it.  Check them for
updates.

Pages:
http://reflux.mcm.housing.washington.edu/visitor/stats.html
  This will be up till summer.
http://weber.u.washington.edu/~reflux/visitor/stats.html
  This will be up as long as I go to the University of Washington.

Things added:

Ver .02
* In cooperation with Garrick, updated the program to the new
  log format.  

Ver .01
* Released

VI. Format Specifiers
---------------------
Put these in your template.htm file and the program will replace them
with the appropriate info.  Not all of them need to be present.  You 
can use any you want, in any order.

%ACCESS%     : Date and time the site was last accessed.
%BROW%       : Last browser to visit.
%HTTPEC%     : Last HTTP error code.
%LASTSITE%   : Last site to access 
%REFERER%    : URL from which the last browser came from.
%REQLINE%    : Last HTTP request line.
%REQUESTS%   : Total individual requests.
%SECINFO%    : Security info on last request (- if none).
%TOTAL%      : Total megabytes served.
%USER%       : Last User (- if none).


DISCLAIMER
----------

Now I know that this part sucks but I have to do it.

Since the Software is provided free of charge, Omnicron Software
Solutions and Joseph Downs (the "software providers") shall not be held 
responsible for any damages arising from the use of the Software.  The 
Software is provided on an AS IS basis, without warranty of any kind, 
including without limitation the warranties of merchantability, fitness 
for a particular purpose and non-infringement. The entire risk as to the 
quality and performance of the Software is borne by you. Should the 
Software prove defective, you and not the software providers, assume 
the entire cost of any service and repair.  

Whew...I hate that crap.  I hope you have fun with the program and let
me know if you're using it!