freebsd-dev/contrib/ipfilter
Qing Li 6e6b3f7cbc This main goals of this project are:
1. separating L2 tables (ARP, NDP) from the L3 routing tables
2. removing as much locking dependencies among these layers as
   possible to allow for some parallelism in the search operations
3. simplify the logic in the routing code,

The most notable end result is the obsolescent of the route
cloning (RTF_CLONING) concept, which translated into code reduction
in both IPv4 ARP and IPv6 NDP related modules, and size reduction in
struct rtentry{}. The change in design obsoletes the semantics of
RTF_CLONING, RTF_WASCLONE and RTF_LLINFO routing flags. The userland
applications such as "arp" and "ndp" have been modified to reflect
those changes. The output from "netstat -r" shows only the routing
entries.

Quite a few developers have contributed to this project in the
past: Glebius Smirnoff, Luigi Rizzo, Alessandro Cerri, and
Andre Oppermann. And most recently:

- Kip Macy revised the locking code completely, thus completing
  the last piece of the puzzle, Kip has also been conducting
  active functional testing
- Sam Leffler has helped me improving/refactoring the code, and
  provided valuable reviews
- Julian Elischer setup the perforce tree for me and has helped
  me maintaining that branch before the svn conversion
2008-12-15 06:10:57 +00:00
..
BSD Import IPFilter 4.1.28 2007-10-18 21:42:51 +00:00
etc import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
FreeBSD import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
FreeBSD-2.2 import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
FreeBSD-3 import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
FreeBSD-4.0 Import IP Filter 4.1.10 2005-12-30 11:34:54 +00:00
FWTK * Someone imported a lot of files with the wrong CVS tag, so lots of files need 2005-04-25 18:20:15 +00:00
iplang This commit was generated by cvs2svn to compensate for changes in r172771, 2007-10-18 21:42:51 +00:00
ipsd Resolve conflicts 2006-08-16 12:23:02 +00:00
ipsend This main goals of this project are: 2008-12-15 06:10:57 +00:00
l4check Pullup IPFilter 4.1.28 from the vendor branch into HEAD. 2007-10-18 21:52:14 +00:00
lib 2020447 IPFilter's NAT can undo name server random port selection 2008-07-24 12:35:05 +00:00
man Pullup IPFilter 4.1.28 from the vendor branch into HEAD. 2007-10-18 21:52:14 +00:00
net import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
perl Import IP Filter 4.1.10 2005-12-30 11:34:54 +00:00
rules Import IP Filter 4.1.10 2005-12-30 11:34:54 +00:00
samples Resolve conflicts 2006-08-16 12:23:02 +00:00
test 2020447 IPFilter's NAT can undo name server random port selection 2008-07-24 12:35:05 +00:00
tools 2020447 IPFilter's NAT can undo name server random port selection 2008-07-24 12:35:05 +00:00
.cvsignore import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
BNF import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
bpf_filter.c Merge IPFilter 4.1.23 back to HEAD 2007-06-04 02:54:36 +00:00
bpf-ipf.h Import IP Filter 4.1.10 2005-12-30 11:34:54 +00:00
bsdinstall import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
BugReport Import IPFilter 4.1.23 to vendor branch. 2007-06-04 02:50:28 +00:00
FAQ.FreeBSD
HISTORY Import IPFilter 4.1.28 2007-10-18 21:42:51 +00:00
IMPORTANT
INST.FreeBSD-2.2 Import IP Filter 4.1.10 2005-12-30 11:34:54 +00:00
INSTALL.FreeBSD import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
INSTALL.xBSD
ip_fil.c Fix build when WITHOUT_DYNAMICROOT is specified in src.conf(5). 2008-08-04 22:45:27 +00:00
ip_msnrpc_pxy.c * Someone imported a lot of files with the wrong CVS tag, so lots of files need 2005-04-25 18:20:15 +00:00
ipf.h Merge IPFilter 4.1.23 back to HEAD 2007-06-04 02:54:36 +00:00
IPF.KANJI
ipmon.h Resolve conflicts 2006-08-16 12:23:02 +00:00
ipt.h Resolve conflicts 2006-08-16 12:23:02 +00:00
kmem.h Resolve conflicts (and believe me...you don't want to know). 2005-12-30 11:52:26 +00:00
LICENCE
Makefile Pullup IPFilter 4.1.28 from the vendor branch into HEAD. 2007-10-18 21:52:14 +00:00
md5.c Import IP Filter 4.1.10 2005-12-30 11:34:54 +00:00
md5.h Pullup IPFilter 4.1.28 from the vendor branch into HEAD. 2007-10-18 21:52:14 +00:00
mkfilters
mlf_ipl.c Import IP Filter 4.1.10 2005-12-30 11:34:54 +00:00
mlf_rule.c Import IP Filter 4.1.10 2005-12-30 11:34:54 +00:00
mlfk_rule.c Resolve conflicts (and believe me...you don't want to know). 2005-12-30 11:52:26 +00:00
mlh_rule.c * Someone imported a lot of files with the wrong CVS tag, so lots of files need 2005-04-25 18:20:15 +00:00
NAT.FreeBSD Import IP Filter 4.1.10 2005-12-30 11:34:54 +00:00
opt_inet6.h
opts.h Resolve conflicts (and believe me...you don't want to know). 2005-12-30 11:52:26 +00:00
pcap-bpf.h Enable building /sbin/ipf (but not the rescue version) with the ability to 2005-05-16 16:22:55 +00:00
pcap-ipf.h Import IP Filter 4.1.10 2005-12-30 11:34:54 +00:00
radix_ipf.h Pullup IPFilter 4.1.28 from the vendor branch into HEAD. 2007-10-18 21:52:14 +00:00
radix.c Pullup IPFilter 4.1.28 from the vendor branch into HEAD. 2007-10-18 21:52:14 +00:00
README import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
snoop.h Resolve conflicts (and believe me...you don't want to know). 2005-12-30 11:52:26 +00:00
STYLE.TXT import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
todo Import IP Filter 4.1.13 2006-08-16 11:51:32 +00:00
WhatsNew40.txt import ipfilter 4.1.8 into the vendor branch 2005-04-25 17:31:50 +00:00
Y2K

IP Filter - What's this about ?
============================
Web site: http://coombs.anu.edu.au/~avalon/ip-filter.html
How-to: http://www.obfuscation.org/ipf/ipf-howto.txt

  The idea behind this package is allow those who use Unix workstations as
routers (a common occurance in Universities it appears) to apply packet
filtering to packets going in and out of them.  This package has been
tested on all versions of SunOS 4.1 and Solaris 2.4/2.5, running on Sparcs.
It is also quite possible for this small kernel extension to be installed
and used effectively on Sun workstations which don't route IP, just for
added security.  It can also be integrated with the multicast patches.
It has also been tested successfully on all of the modern free BSDs as
well as BSDI, and SGI's IRIX 6.2.

   The filter keeps a rule list for both inbound and outbound sides of
the IP packet queue and a check is made as early as possible, aiming to
stop the packet before it even gets as far as being checked for source
route options.  In the file "BNF", a set of rules for constructing filter
rules understood by this package is given.  The files in the directory
"rules", "example.1" ... "example.sr" show example rules you might apply.

   In practise, I've successfully isolated a workstation from all
machines except the NFS file servers on its local subnets (yeah, ok, so
this doesn't really increase security, because of NFS, but you get the
drift on how it can be applied and used).  I've also successfully
setup and maintained my own firewalls using it with TIS's Firewall Toolkit,
including using it on an mbone router.

   When using it with multicast IP, the calls to fr_check() should be
before the packet is unwrapped and after it is encapsulated.  So the
filter routines will see the packet as a UDP packet, protocol XYZ.
Whether this is better or worse than having it filter on class D addresses
is debateable, but the idea behind this package is to be able to
discriminate between packets as they are on the 'wire', before they
get routed anywhere, etc.

   It is worth noting, that it is possible, using a small MTU and
generating tiny fragmented IP packets to generate a TCP packet which
doesn't contain enough information to filter on the "flags".  Filtering
on these types of packets is possible, but under the more general case
of the packets being "short".  ICMP and UDP packets which are too small
(they don't contain a complete header) are dropped and logged, no questions
asked.  When filtering on fragmented packets, the last fragment will get
through for TCP/UDP/ICMP packets.

Bugs/Problems
-------------
If you have a problem with IP Filter on your operating system, please email
a copy of the file "BugReport" with the details of your setup as required
and email to darrenr@pobox.com.

Some general notes.
-------------------
   To add/delete a rule from memory, access to the device in /dev is needed,
allowing non-root maintenaince.  The filter list in kernel memory is built
from the kernel's heap.  Each packet coming *in* or *out* is checked against
the appropriate list, rejects dropped, others passed through.  Thus this will
work on an individual host, not just gateways.  Presently there is only one
list for all interfaces, the changes required to make it a per-interface list
require more .o replacements for the kernel.  When checking a packet, the
packet is compared to the entire list from top to bottom, the last matching
line being effective.


What does what ?
----------------
if_fil.o  (Loadable kernel module)
	- additional kernel routines to check an access list as to whether
	  or not to drop or pass a packet.  It currently defaults to pass
	  on all packets.

ipfstat
	- digs through your kernel (need to check #define VMUNIX in fils.c)
	  and /dev/kmem for the access filter list and mini stats table.
	  Obviously needs to be run priviledged if required.

ipf
	- reads the files passed as parameters as input files containing new
	  filter rules to add/delete to the kernel list.  The lines are
	  inserted in order; the first line is inserted first, and ends up
	  first on the list.  Subsequent invocations append to the list
	  unless specified otherwise.

ipftest
	- test the ruleset given by filename.  Reads in the ruleset and then
	  waits for stdin.

	  See the man pages (ipf.1, ipftest.1, ipfstat.8) for more detailed
	  information on what the above do.

mkfilters
	- suggests a set of filter rules to employ and suggests how to add
	  routes to back these up.

BNF
	- BNF rule set for the filter rules

Darren Reed
darrenr@pobox.com
http://coombs.anu.edu.au/~avalon/ip-filter.html