
			    README FOR NEWSPRUNE

    Newsprune is a program which *efficiently* locates article files in your
    spool which INND has lost track of (i.e. are missing from the history
    file but not deleted).

    Newsprune works by:

    (a) scanning the history file

    (b) scanning (opendir()/readdir()) the news spool

    (c) producing a list of files that exist in the spool but do not exist
	in the history file.

    The idea is to run newsprune once a day or once a week and then run 
    fastrm on the output, as in:

    newsprune > /home/news/log/prune.out
    fastrm / < /home/news/log/prune.out

    NOTE!  The program works well at BEST, but I strongly recommend that you
    TEST it by running it manually and checking its output for reasonability
    before installing it on your system.

    Newsprune requires about the same amount of memory to run as expire does,
    on the order of 20 MB I believe.

    Newsprune has a safety feature in that it will not output any filename
    that is less then 8 hours old.  The primary reason for this is to not
    remove articles that have come in since newsprune had finished reading
    the history file.  NOTE: if newsprune runs for more then 4 hours,
    something is probably wrong and you should stop using it.  On most systems,
    newsprune runs very quickly... less then half an hour, since it does not
    actually open the article files or even stat most of them.

				COMPILATION

    Edit newsprune.c, setting the ACTIVE, HISTORY, and SPOOL defines 
    properly for your system.  Alternately you can compile newsprune.c
    with -D overrides for these defines if the defaults do not suit you.
    The defaults are:

	#define ACTIVE  "/home/news/active"
	#define HISTORY "/home/news/history"
	#define SPOOL   "/home/news/spool/news"

    Compile as follows:

	gcc -Wall newsprune.c -o newsprune -O

    (or however you like).  The program is essentially ANSI C.

				EXECUTION

    Most commonly:

	newsprune > /home/news/log/prune.out
	fastrm / < /home/news/log/prune.out

						-Matt

