Read Me

This is the README file for Yaalr - Yet Another Apache Log Reader
-----------------------------------------------------------------

Yaalr reads an apache log and reports back on it with the following information:

	1. First date found in the log 
	2. Number of 'Hits' in the log
	3. Number of successful requests (i.e. 200 status code) 
	4. Number of 'Not Found' pages (i.e. 404 status code)
	5. Number of 'Internal Error' pages (i.e. 500 status code)
	6. Unique remote hosts found in the log
	7. Total number of bytes transfered, in Megs and Gigs
	8. Last date found in the log

Yaalr supports three types of log files:

	standard: This is the default apache log file, use the -s option to parse this type of file 
	combined: This type of log file has the referrer as well as other information combined into one
	          log, use the -c option if you have this type of log file
	combined with cookies: This type of log file is the same as the normal combined log file but it
		  also has a field for cookies, use the -f option for this log type

Options:
	-s 	Parses a common apache log file and produces a report on the command line.  
		Expects a file as an argument after the option.

       	-c      Parses a combined apache log file and produces a report on the command line.  
		Expects a file as an argument after the option.

       	-f      Parses a combined apache log file that includes cookies and produces a report on the command line. 
		Expects a file as an argument after the option.

Example:

	yaalr.pl -s /var/log/apache/access.log

Yaalr is a perl script so you can install it anywhere you wish. Since it is a perl script it comes with
documentation, simply use perl's built in documentation system: `perldoc yaalr.pl`

Note that you need to have read permissions on a web log to read it, yaalr will need this as well.