diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..3d5cc37 --- /dev/null +++ b/Makefile @@ -0,0 +1,10 @@ +# Fake Makefile For waccess +# $Id: Makefile,v 1.1 2001/08/03 19:34:32 tundra Exp $ + +all: # Do nothing - this is a python script that needs no build + +install: + install -c -o root -g wheel -m 755 ./waccess ${PREFIX}/bin + mkdir ${PREFIX}/share/doc/waccess + install -c -o root -g wheel -m 644 ./waccess.1.gz ${PREFIX}/man/man1 + install -c -o root -g wheel -m 644 ./waccess-license.txt ${PREFIX}/share/doc/waccess diff --git a/waccess-license.txt b/waccess-license.txt new file mode 100644 index 0000000..74cbb3b --- /dev/null +++ b/waccess-license.txt @@ -0,0 +1,80 @@ +$Id: waccess-license.txt,v 1.1 2001/08/03 19:30:47 tundra Exp $ + +In order to use, study, modify, or copy 'waccess', you must read and +agree to all the licensing terms below. If you do not agree with or +do not understand *ANYTHING* you see in this document, you are NOT +granted a license to use, study, modify, or copy 'waccess'. By using, +studying, modifying, or copying 'waccess', you are agreeing to all the +terms of the 'waccess' LICENSE below in their entirety. + + + 'waccess' LICENSE AGREEMENT + ======================== + +1) DEFINITIONS + +Throughout this Agreement the term 'waccess' is used to mean: + +Anything included in the 'waccess' software distribution package from +TundraWare Inc. This includes scripts, programs, documentation, license +text and all other files provided in that original software +distribution package. + +Throughout this Agreement the term "User" is used to mean +any person who is enagaged in any of the following activities: + + - Uses any files found in the 'waccess' software distribution in any way. + - Reads the 'waccess' documentation. + - Studies the 'waccess' program source code or supporting files. + - Makes use of any part of the 'waccess' software distribution for any + purpose. + - Duplicates and/or distributes the 'waccess' software distribution. + +2) OWNERSHIP + +'waccess' Is Copyright (c) 2001, TundraWare Inc., All Rights Reserved. + + +3) TERMS + +Permission is hereby granted to the User for the duplication and use +of 'waccess' so long as ALL the following conditions are met: + + 1) The User of 'waccess' understands and agrees that this is EXPERIMENTAL + SOFTWARE which is provided "AS-IS" with no warranties expressed + or implied by TundraWare Inc. + + 2) The User acknowledges 'waccess' has NOT been tested for: + + a) Correct operation + b) Freedom from unintended consequences + c) Any operation or condition which might cause damage, + compromise, or disruption to the User's or other: + hardware, software, networks, or data, or which might + cause any breach of system security of such systems, + software, and networks. + + 3) By using 'waccess' in any way, the User does so at their own risk and + agrees to hold TundraWare Inc. harmless for any damage, + direct or indirect, that this software may or does cause to + the User's computational environment, including, but not + limited to, the User's or others' hardware, software, network, + or data. THE USER FURTHER AGREES TO HOLD TUNDRAWARE + INC. HARMLESS FOR ANY ECONOMIC DAMAGE OR ANY OTHER ADVERSE + CONSEQUENCE, DIRECT OR INDIRECT, CAUSED BY THE USE OF 'waccess'. + + 4) If duplicated and/or distributed, no fee beyond reasonable + duplication charges may be charged for 'waccess'. No commercial + use of 'waccess' which involves any remuneration beyond these + duplication charges is permitted. + + 5) Any distributed copies of 'waccess' must include all the originally + provided software, documentation, and licensing information in + their original distribution format and packaging without any + modifications. + +By using any part or all of 'waccess', you are agreeing to be bound by +this license. + +IF YOU DO NOT UNDERSTAND, OR CANNOT ABIDE BY ANY OF THESE CONDITIONS, +DO NOT USE 'waccess'. diff --git a/waccess.1 b/waccess.1 new file mode 100644 index 0000000..2085fb0 --- /dev/null +++ b/waccess.1 @@ -0,0 +1,64 @@ +.TH waccess 1 TundraWare +.SH NAME +waccess \- Quick And Dirty Web Log Analysis +.SH SYNOPSIS +waccess [-rs] string, string, ... +.SH DESCRIPTION + +\'waccess\' is a quick way to check a web access log for particular +"hits" or accesses. \'waccess\' will search the log looking for, +displaying, and counting all the accesses which contain any of the +strings you name on the command line. + +\'waccess\' is not a replacement for a serious web log analysis tool, +but is useful for "quickie" lookups. + +.SH OPTIONS +.TP +.B -r +Try to determine the hostname of each access by doing a reverse lookup +on the IP address. + +.TP +.B -s +Suppress display of the individual matching records and only show the +totals. + +.SH EXAMPLES + +.B waccess myreport.pdf + +Searches the web access log displaying all access records containing the +string \'myreport.pdf\'. When log search is finished, \'waccess\' displays +the total number of records examined and how many matching entries were found. + +.B waccess -r myreport.pdf + +Searches the web access log displaying all access records containing the +string \'myreport.pdf\'. This time, for each matching record, \'waccess\' +will try to figure out (and display) the hostname of the accessing machine +via a reverse IP lookup. + +.B waccess -s myreport.pdf + +Look for and count records in the web access log containing \'myreport.pdf\', +but do not display them. Only display the totals when the analysis is complete. + + +.SH OTHER +You must have a reasonably current copy of 'python' installed for \'waccess\' +to operate. + +.SH BUGS AND MISFEATURES +None known as of this release. + +.SH COPYRIGHT AND LICENSING +waccess is Copyright(c) 2001, TundraWare Inc. +For terms of use, see the waccess-license.txt file in the program distribution. +If you install waccess on a FreeBSD system using the 'ports' mechanism, you will +also find this file in /usr/local/share/doc/waccess. +.SH AUTHOR +.nf +Tim Daneliuk +tundra@tundraware.com +