BY POPULAR DEMAND, A FAQ
------------------------

Q. Huh?
A. Read the INSTALL file for information about installing this software.


Q. What is squint?
A. Squint is a log analyzer for the squid proxy server.  It produces static
html reports based on a squid log.


Q. How do I use squint?
A.  You can safely run the commands squint.cron.sh and squint.pl to see what
they are willing to do for you.  (And we hope that helps you.)


Q. What exactly does squint monitor?
A. squint only counts actual bytes downloaded via the squid proxy server -
http, ftp, https.  Squid does not count protocol overhead, DNS queries, etc.
Squid's logs also do not include non-proxy traffic, such as unsolicited
connection attempts, and regular outgoing traffic that you send or forward.


Q. Was I really on the internet all day?
A. If not you, then your computer was.  Some sites contain code which instructs
your browser to download new copies of the page (e.g. MRTG, some news sites).


Q. I downloaded an ISO, and it took all day, but squint says I only spent 10
minutes on the net.
A. Producing this behaviour is left as an exercise to the reader.  It's a
feature.


Q. My squint reports skipped a week!
A. Most likely your server was off when the time came to run the squint cron
job.  Run `squint.cron.sh regen' -- this will regenerate all the reports from
the squid log files.


Q. My squint reports are blank!
A. Squint cannot find your log files, or the format of your log files is
incorrect (e.g. Apache's common log format).  If you have squid log files in
some place not listed in squint.cron.sh, let us know.  If you have log files in
common log format, good luck to you.  Squint only understands the squid log
format (sorry).


Q. I've found a bug!
A. Not so loud! Just now everyone will want one! (see also "waiter, waiter,
there's a fly in my soup").  If you can fix it, let us know how.  If you think
we can fix it even though you can't, tell us how to get the bug.  Generally we
will need copies of the log lines that trigger the bug, an explanation of what happens and why it is wrong, and
an explanation of what the correct behaviour would be.


Q. Can you change squint to ...
A. Probably we can.  If you offer to pay us, we most likely will.


Q. Squint dies with "Can't locate warnings.pm in @INC"
A. Squint expects perl >= version 5.6 - perl 5.5 struggles with this and
mkdir with a umask argument .  You can try this patch (and then just ignore the
warnings about uninitialized variables...):

18c18
< #no warnings qw{uninitialized};
---
> no warnings qw{uninitialized};
329c329
<       my ($site, $user, $currentsort);
---
>       my $site, $user, $currentsort;
462c462
<       mkdir("$date",0777);
---
>       mkdir "$date";


