blob: f391d2c1c42c7167832471522bea77868e28378c [file] [log] [blame]
Richard Gooch8e3b8922000-04-22 00:57:38 +00001FOLLOW THESE STEPS:
Richard Gooch8e3b8922000-04-22 00:57:38 +00002
Rusty Russell50a8efe2001-02-03 10:50:04 +000030) There may be some outstanding bugfixes or tweaks which are not yet
4 in the official kernel. To look through these, do:
5 % make pending-patches KERNEL_DIR=<<where-your-kernel-is>>
6
71) Next, make the package.
Rusty Russell8c245b52000-07-14 08:01:22 +00008 % make KERNEL_DIR=<<where-your-kernel-is>>
Rusty Russell7fae6fa2000-05-31 06:32:02 +00009
Rusty Russell8c245b52000-07-14 08:01:22 +0000102) Finally, you need to to install the shared libraries, and the binary:
Rusty Russell8c245b52000-07-14 08:01:22 +000011 # make install KERNEL_DIR=<<where-your-kernel-is>>
Rusty Russell7fae6fa2000-05-31 06:32:02 +000012
Rusty Russell429eafb2001-01-07 06:49:44 +000013If you are a developer, you can install the libipq headers, like:
14 # make install-devel
Rusty Russell8c245b52000-07-14 08:01:22 +000015
Rusty Russell429eafb2001-01-07 06:49:44 +000016That's it!
17================================================================
18FEELING BRAVE?
19
201) If you want to try some extensions, you can do the following:
21 % make patch-o-matic KERNEL_DIR=<<where-your-kernel-is>>
22
23This offers you a collection of maybe-broken maybe-cool third-part
24extensions. It will modify you kernel source (so back it up first!).
25
262) If you want to test out `iptables-save' and `iptables-restore', you
27can use
28 % make experimental
29 % make install-experimental
30
31================================================================
32PROBLEMS YOU MAY ENCOUNTER:
33
341) This package requires a 2.4.0 kernel, or above.
Rusty Russell8c245b52000-07-14 08:01:22 +000035
362) If you get the kernel directory wrong, you may see a message like:
37 Please try `make KERNEL_DIR=path-to-correct-kernel'
38
393) If you want to specify alternate directories for installation
40(instead of /usr/local/ bin lib man), do this:
Richard Gooch8e3b8922000-04-22 00:57:38 +000041
42 % make BINDIR=/usr/bin LIBDIR=/usr/lib MANDIR=/usr/man
Rusty Russell8c245b52000-07-14 08:01:22 +000043 # make BINDIR=/usr/bin LIBDIR=/usr/lib MANDIR=/usr/man install
Richard Gooch8e3b8922000-04-22 00:57:38 +000044
45NOTE: make sure you build with at least the correct LIBDIR=
46specification, otherwise iptables(8) won't know where to find the
47dynamic objects.