Title:          PeerGuardian for DSL
Description:    Blocks network IPs for security and privacy
Author:         bitrot / Nullcontext
Original-site:  http://www.phoenixlabs.org
Copying-policy: GNU GPL
Extension by:   P.Lee
Requires:	iptables.dsl <-* important * - you need this.

Comments:       Uses iptables to block ranges.
		Uses peerguardian lists (not supplied)
		Includes ncurses Gui.
		Installs to opt and ~/.peerguard
-------------------------------------------------------------

Quick Start
-----------
You only need the Load/Unload functions. Blocklists are 
available from phoenixlabs or bluetack.co.uk they should replace
the blocklist.txt file. Alternatively try the Update function
which uses wget to download a new blocklist.

History
-------
PeerGuardian for linux was superceded by MoBlock,
so this is program a bit old.

'peerguardnf'  is a command line program which can be used
by itself and is the orginal version from Phoenixlabs. It
uses PG.conf (pls do read PG.conf).

Most geeks will write their own scripts to control peerguardnf
but an ncurses gui comes with the original package called 'pgtext'.
pgtext uses 'pgcursrc' which it generates on first run.
pgtext in this version had to be hacked to accomodate DSL. It is
more robust that than the orginal version but still a bit flaky
so don't abuse it too much. It usually has trouble with 
filenames, file paths and file ownership (peerguardnf runs as
super user) and also extra lines in pgcursrc.
A wrapper pgtext.sh makes sure PG.conf is created but not overwritten.

Moving the blocklist
--------------------
The blocklist.txt file may be moved away from the default
location by editing PG.conf. e.g to permanent storage.
This is desirable for those using frugal or usb-pen install since
it saves ram usage and reduces backup-compression time.

Getting Rid of logging
----------------------
If you don't like the bulky logging, you can change the log file 
to /dev/null


Command line help
-----------------
(extract from phoenixlabs forums)

Basic usage:

	peerguardnf -d -c /etc/PG.conf -l /var/log/PG.log -h -m

where

	-d : Starts PeerGuardian in daemon mode (background process)

	-c : use the configuration file PG.conf located in /etc/

	-l : Tells PeerGuardian to log it's events

	-h : Tells PeerGuardian to disable it's web server

	-m : Tells PeerGuardian to load kernel modules it requires automatically

To Close:
	killall peerguardnf


Sorry no more help files, please try the Phoenixlabs forums.


How to Uninstall
----------------
see 'uninstall.txt'

