README for searches.pl
by Jon C. Jensen <jon@viscom.byu.edu>

This program parses /var/log/messages* to generate a report of recently-used
search words and search types (and, or, boolean) and hosts who've searched with
htdig.

It only goes as far back as the messages files go, and on our server there are 5
files (named messages, messages.1, messages.2, etc.) that get rotated through
about once a month. But to just get an idea of what people've been searching for
recently, it works.

It detects whether it's being used from the shell or as a CGI and returns its
output as plain text or HTML as appropriate. A few options allow for changing
sort order and limiting the report to search words or hosts that appear at least
a certain number of times. These can be hard-coded in the program or passed in
through CGI parameters, as in the example HTML file stats.html.

The program is at:

http://viscom.byu.edu/jon/perlstuff/searches.pl

and there's a running version at

http://vc.clubs.byu.edu/searches/stats.html