Codebase list squidview / debian/0.79-2 INSTALL
debian/0.79-2

Tree @debian/0.79-2 (Download .tar.gz)

INSTALL @debian/0.79-2raw · history · blame

--Compiling squidview

  $ ./configure
  $ make

The program is c/c++ and uses the ncurses library for obtaining some
keystrokes. Old gcc compilers can fail in compiling this program; if so
start afresh by deleting the source directory, unpack then

  $ cp Makefile.old Makefile
  $ make oldgcc

... and install manually.

Since version 0.77 squidview has support for large files, > 4 gigs.
Squidview may still handle large logs even when the support is not detected
by the configure script.

--Installation

If "configure" and "make" are successful:

  # make install-strip

"make install-strip" will provide a smaller executable than "make install"
because the latter has quite a bit of debugging information with it.
  
Or if you aren't the superuser the program will still run if you have read
access to the squid log file.

This program assumes the main squid log file is here:
  /usr/local/squid/var/logs/access.log
If it isn't just symlink it appropriately from the following default. This
directory and links are made in the user's home space when squidview is first
run by the user.

  graeme@localhost:~/.squidview$ ls -l
  HOWTO -> /usr/local/share/squidview/HOWTO
  log1 -> /usr/local/squid/var/logs/access.log
  log2 -> log1
  log3 -> log1
  users
  words

In this case squidview expects the primary log to be "log1", and the symlink
redirects it to where the file actually is. Three log locations are supported
which gives you a bit of room for accomodating rotating logs.

This tar.gz archive comes with an example access.log named example.log.
Symlink it to view it with squidview, or copy it to your ~/.squidview
directory. The same applies to the HOWTO.

"users" and "words" are reporting files - these can be symlinks to /etc if
you would rather have these files there. "aliases" is another text file,
this time for mapping IP numbers to user-defined names.

This package comes with example "users", "words" and "aliases" files you can
build on.