gShield Installation Notes
--------------------------

# ------------------------------ #
# Netfilter/iptables             #       
# -------------------------------#

gShield assumes you have a properly working and
configured netfilter/iptables setup. It does not make
use of any "special" extensions or patches, but some
things will not work well unless you are sure they
are installed (such as the FTP NAT support) 

# ------------------------------ #             
# Installing                     #             
# -------------------------------#   

The default configuration assumes everything will
be installed in /etc/firewall.  

gShield will untar to gShield-<version> which means you 
will need to a) move/rename this directory to /etc/firewall
or b) symlink /etc/firewall to gShield-<version>/

** DO NOT attempt to run configure this script remotely **

** DO NOT run the thing remotely! **

I recommend installing/configuring the first time locally in case
something horrible happens.

* NEXT *

Open a terminal. Get out that favorite editor of yours. Edit 
gShield.conf -- it's commented.

* NEXT *

Read the README. It's in the docs directory. 

* NEXT *

Run the script (/etc/firewall/gShield.rc). I suggest
linking this, or setting it up as an automatic process.

Three examples on how to do this. 

PPP -- under Debian, there's a nice directory -> /etc/ppp/ip-up.d/

Make a link from the firewall:

	ln -s /etc/firewall/gShield.rc /etc/ppp/ip-up.d/gShield.rc 

DHCP -- from my config file for dhcpcd:

	OPTIONS='-d -c /etc/firewall/gShield.rc'

* That's it *
