blob: dafd4c32c3b134e2ffcae3cb87c8c65a47fd42a1 [file] [log] [blame]
Richard Gooch8e3b8922000-04-22 00:57:38 +00001FOLLOW THESE STEPS:
Richard Gooch8e3b8922000-04-22 00:57:38 +00002
Rusty Russell8c245b52000-07-14 08:01:22 +000031) If /usr/src/linux contains the kernel headers of a recent 2.4
4 kernel:
Richard Gooch8e3b8922000-04-22 00:57:38 +00005 % make
Rusty Russell8c245b52000-07-14 08:01:22 +00006 Otherwise:
7 % make KERNEL_DIR=<<where-your-kernel-is>>
Rusty Russell7fae6fa2000-05-31 06:32:02 +00008
Rusty Russell8c245b52000-07-14 08:01:22 +000092) Finally, you need to to install the shared libraries, and the binary:
Rusty Russell7fae6fa2000-05-31 06:32:02 +000010 # make install
Rusty Russell8c245b52000-07-14 08:01:22 +000011 Or
12 # make install KERNEL_DIR=<<where-your-kernel-is>>
Rusty Russell7fae6fa2000-05-31 06:32:02 +000013
Rusty Russell429eafb2001-01-07 06:49:44 +000014If you are a developer, you can install the libipq headers, like:
15 # make install-devel
Rusty Russell8c245b52000-07-14 08:01:22 +000016
Rusty Russell429eafb2001-01-07 06:49:44 +000017That's it!
18================================================================
19FEELING BRAVE?
20
211) If you want to try some extensions, you can do the following:
22 % make patch-o-matic KERNEL_DIR=<<where-your-kernel-is>>
23
24This offers you a collection of maybe-broken maybe-cool third-part
25extensions. It will modify you kernel source (so back it up first!).
26
272) If you want to test out `iptables-save' and `iptables-restore', you
28can use
29 % make experimental
30 % make install-experimental
31
32================================================================
33PROBLEMS YOU MAY ENCOUNTER:
34
351) This package requires a 2.4.0 kernel, or above.
Rusty Russell8c245b52000-07-14 08:01:22 +000036
372) If you get the kernel directory wrong, you may see a message like:
38 Please try `make KERNEL_DIR=path-to-correct-kernel'
39
403) If you want to specify alternate directories for installation
41(instead of /usr/local/ bin lib man), do this:
Richard Gooch8e3b8922000-04-22 00:57:38 +000042
43 % make BINDIR=/usr/bin LIBDIR=/usr/lib MANDIR=/usr/man
Rusty Russell8c245b52000-07-14 08:01:22 +000044 # make BINDIR=/usr/bin LIBDIR=/usr/lib MANDIR=/usr/man install
Richard Gooch8e3b8922000-04-22 00:57:38 +000045
46NOTE: make sure you build with at least the correct LIBDIR=
47specification, otherwise iptables(8) won't know where to find the
48dynamic objects.