summaryrefslogtreecommitdiffstats
path: root/contrib/ipfilter/INSTALL.FreeBSD
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/ipfilter/INSTALL.FreeBSD')
-rw-r--r--contrib/ipfilter/INSTALL.FreeBSD55
1 files changed, 52 insertions, 3 deletions
diff --git a/contrib/ipfilter/INSTALL.FreeBSD b/contrib/ipfilter/INSTALL.FreeBSD
index c732bac..a4a787a 100644
--- a/contrib/ipfilter/INSTALL.FreeBSD
+++ b/contrib/ipfilter/INSTALL.FreeBSD
@@ -1,7 +1,56 @@
-*** IF you are using FreeBSD 2.2.x, see the file "INST.FreeBSD-2.2" ***
-*** IF you are using FreeBSD 3.x, see the file "FreeBSD-3/INST.FreeBSD-3" ***
-*** IF you are using FreeBSD 4.x, see the file "FreeBSD-4.0/INST.FreeBSD-4" ***
+This file is for use with FreeBSD 4.x and 5.x only.
+
+To build a kernel for use with the loadable kernel module, follow these
+steps:
+ 1. For FreeBSD version:
+ 4.* do make freebsd4
+ 5.* do make freebsd5
+
+ 2. do "make install-bsd"
+ (probably has to be done as root)
+
+ 3. Run "BSD/kupgrade"
+
+ 4. build a new kernel
+
+ 5. install and reboot with the new kernel
+
+ 6. use modload(8) to load the packet filter with:
+ modload if_ipl.o
+
+ 7. do "modstat" to confirm that it has been loaded successfully.
+
+There is no need to use mknod to create the device in /dev;
+- upon loading the module, it will create itself with the correct values,
+ under the name (IPL_NAME) from the Makefile. It will also remove itself
+ from /dev when it is modunload'd.
+
+To build a kernel with the IP filter, follow these steps:
+
+ 1. For FreeBSD version:
+ 4.* do make freebsd4
+ 5.* do make freebsd5
+
+ 2. do "make install-bsd"
+ (probably has to be done as root)
+
+ 3. run "FreeBSD/kinstall" as root
+
+ 4. build a new kernel
+
+ 5.
+ b) If you are using FreeBSD-3 or later:
+ create devices for IP Filter as follows (assuming it was
+ installed into the device table as char dev 20):
+ mknod /dev/ipl c 79 0
+ mknod /dev/ipnat c 79 1
+ mknod /dev/ipstate c 79 2
+ mknod /dev/ipauth c 79 3
+ mknod /dev/ipsync c 79 4
+ mknod /dev/ipscan c 79 5
+
+ 6. install and reboot with the new kernel
Darren Reed
darrenr@pobox.com
OpenPOWER on IntegriCloud