NScache is simple program for viewing and amanging contents of Netscape(tm)
browsers cache directory. This program is distributed under terms of GPL.

Personaly I have tested NScache only with 4.0, 4.5, 4.7 Linux x86 versions
of Netscape Communicator (version 4 and 5 of cache index database format),
and also on DEC OSF 4.0F Alpha with Netscape Communicator 4.0.
I am not sure if it will work well other versions. Also I don't know If I
implemented well, reading of cache index database, bacause I don't find
any documentation for it.

I'v got reports that NScache works, after fixes for big endian platforms by
Harald Frster, properly also on Linux PPC and reads properly cache indexes
from Linux PPC and MacOS Netscape Communicator.
Also I'v got report, that NScache can read fat.db indexes from Win32
version of Netscape Communicator.

It have very easy user interface writen by using of GTK+1.2 widget libraries.
It shows 3 levels tree of cache contents. At first level are protocols, at 
second level are servers and at third level are regular documents.
Or sorted list of cache entries sorted by different criteria.

For each document there is shown its URL, name of cache file, its size, 
MIME type, encoding type, character set for HTML documents, modification
time, access time and time when document expires. It is possible to remove
columns which you don't want to see (this setting will stay persistent,
so you don't need to do it each time you start nscache).

When you press right mouse button inside tree list, you can make any action
on selected item. You can save file from cache to other location, you can 
remove files and entries from chache (one or all entries for server), or you
can compute numbers of documents in subtrees and size of all documets in 
subtree. You can launch any viewer command on cache file or on source URL.
The viewers you can assign to any MIME type. You can also copy selected URL
to clipboard.

To each menu entry in nscahe GUI interface you can assign any keyboard 
shortcat (open menu, fucus to selected menu item and hit on keyboard the 
shortcat). Seting of assigned shortcuts will stay persistent, so you
can do this once and use the shortcuts also when you start nscache next 
time.

Version 0.4 and later can be used to list content of cache to stdout. This
way can be used nscache also in custom scripts for handling it.
To activate this feature, use option -l (--list). There are two kinds of 
directory listings. First short, which displays only cache filename and
original URL of cache entry on one line separated with one table space 
character. This one is default and can be forced with option -s (--short).
Second one is multiline output, which displays all informations which can
be dysplayed in GUI interface lists. To use thi second listing mode,
you must use option -m (--multi-line).

Available commandline options :
  -f,  --db_file=FILENAME  set cache file to FILENAME
  -l,  --list              list cache directory contents to stdout
  -m,  --multi-line        print multi line info about each cache entry
                           listing when listing cache content
  -s,  --short             print short listing when listing cache content
  -v,  --version           display version information and exit
  -h,  --help              display this help and exit


As this program is very simple and small, I hope that it contains not too
much bugs. But if you find any, please feel free to send me bug reports.
Also if you have any suggestions I will be glad to hear it.

New versions of this program you can find at its homepage :
http://www.idata.sk/~ondrej/nscache/ or at
http://nscache.sourceforge.net/

Stefan Ondrejicka <ondrej@idata.sk>

