inpaths package description
===========================

This packages contains new inpaths program, written by
chongo@prime.corp.sgi.com (Landon Curt Noll), and pathgrep script
distributed by Pierre Beyssac <pb@fasterix.frmug.fr.net>.

I have added two more shell scripts, i.e., trimpathlog and
mkinpaths.

The first script, "trimpathlog" archives current pathlog file into
a separate directory.  This is designed to be be run once a day.
Please don't run more than once a day.  The archive file names are
different by its date number only.  Therefore, if you run
"trimpathlog" multiple times within the same day, the old archive
will be lost!  To install this script, please edit following variables
for your system.  And add following lines on your crontab

    1 1 * * * /usr/local/news/bin/trimpathlog

The second script makes the inpaths report and mails to you and
pathsurvey@ue.org simultaneously.  You are advised to run earlier
than the end of every month.  

    1 2 25 * * /usr/local/news/bin/mkinpaths <pathname_of_your_host>

How to install?
===============

1. compile inpaths.c and install as $NEWSBIN/inpaths.

2. Allocate a big disk space(> 500 MB), and mkdir ${PATHLOGDIR} there.
   Update the PATH_LOG variable in "pathgrep" script, and then
   install as $NEWSBIN/pathgrep.  Also edit pathname of innshellvars
   file if it is different from yours.

3. Add a newsfeed entry on your newsfeeds as:

       path!:*:Tc,WH:/usr/local/news/bin/pathgrep pathlog

   and then reload it to INN.

4. Look at trimpathlog script, and edit following variables if needed.

   PATHLOG   # full path name of the active pathlog
   ARCHIVES  # pathlog archive directory
   
   Also you may have to change the path name of "innshellvars".

   Install "trimpathlog" in $NEWSBIN.

5. Look at mkinpaths script.  The ARCHIVES variable must be same as
   that of "trimpathlog".  Then install it on $NEWSBIN.

Testing
=======

1. Issue "trimpathlog".  You will have a pathlog.MN.gz in $ARCHIVES.
   where "MN" is the date sequence of today.

2. mv pathlog.MN.gz pathlog.4N.gz

3. Repeat steps 1-2 several times.

4. issue "mkinpaths <your_host_name>".
   You should receive a inpaths report via mail within a minute.
   The MAILTO variable is limited to NEWSMASTER.
   If you are satisfied with the result, include pathsurvey@eu.org
   in the MAILTO variable of "mkinpaths".

Note
====
For safety, mkinpaths does not delete old archives after reporting.
However, trimpathlog will replace old archives once a month.  Ok?

--
sysuh@kigam.re.kr
