
GFILTER	- INN channel based article filter program, by Matthew Dillon

    This program is placed in the public domain, do with it as you will.

(I) INSTALLATION:

    - Edit the default definitions in gfilter.c

    - compile gfilter.c with GNU C

    - install in /home/news/bin (or wherever your news bin is)

    - install gfilter.ctl in /home/news (or whatever your base directory
      is for INN news), and edit accordingly.

    - create newsfeeds entry as shown below:

gfilter:\
     *:B4096/1024,Tc,WO:/home/news/bin/gfilter

    - enable the filter in inn, either by restarting inn or reloading
      the newsfeeds file.


(II) TESTING

    Add a simple logging entry for 'Re:' strings in the subject line as shown
    in the comments in the gfilter.ctl file

    if you haven't yet, have INN reload your newsfeeds file.  If it is already
    reloaded and you want to restart the program, kill any running program
    amd do a 'ctlinnd begin gfilter'.

    check the log files for errors, at a minimum the pid should be logged
    when.

    You should get a large number of log entries due to the Re: test string.
    Remove the string and restart gfilter when you are satisfied (note: don't
    set the 'd' flag for your test entry as you do not want to delete those
    articles!).  (Well, I guess what you see depends on how active your
    feeds are).

(III) TODO

    Change linear lookup into a hash based lookup to accomodate a large
    number of matching strings.

    Add flags to check for cross posting to moderated-flagged groups

