prevent source code corruption with static build (reported by Tino Keitel)
[jleu-ebtables.git] / INSTALL
blob7e1c78ab239161b13af89c84d0a5e681815e5b83
1 FOLLOW THESE SIMPLE GUIDELINES:
2 -------------------------------
4 Compiling the source code:
5 %make
6 Put the files in the right directories:
7 %make install
9 If you are using the CVS code or need your own kernel includes, do this
10 instead (change the include directory to the appropriate one):
11 %make install KERNEL_INCLUDES=/usr/src/linux/include
13 If you want to make a static binary for ebtables, containing all the
14 extensions, without shared libraries, do this (this will make a
15 binary called 'static', which you can rename):
16 %make static
18 WHAT GETS INSTALLED?
19 --------------------
21 - The ebtables manual gets installed in /usr/local/man/man8
22   To put the manual somewhere else, include MANDIR=<<man-path/man>> as
23   option on the command line.
24   The Makefile will append /man8/ebtables.8.
25 - ethertypes is by default placed in /etc/, if you
26   want to change this, include ETHERTYPESPATH=<<path>>.
27 - The userspace programs ebtables ebtables-save and ebtables-restore are
28   are copied by default to /usr/local/sbin/ebtables. If you want to put
29   the executables somewhere else, include BINPATH=<<path>>.
30 - The ebtables initialisation file (enabling use of 'service ebtables') is
31   copied to /etc/rc.d/init.d (change with option INITDIR)
32 - The ebtables configuration file (ebtables-config) is copied to /etc/sysconfig
34 That's all
36 You can also use a base directory different from the root directory (/),
37 using the DESTDIR option. See the Makefile for more details.
40 ADDITIONAL PROGRAM(S):
41 ----------------------
42 -- examples/ulog/test_ulog.c --
44 Contains an example to receive and parse netlink messages containing
45 packets seen by the ebtables ulog watcher.
47 Compile with:
48 %make test_ulog.c KERNEL_INCLUDES=/usr/src/linux/include
50 Usage:
51 %examples/ulog/test_ulog NETLINK_GROUP
52 %ebtables -A chain --ulog-nlgroup NETLINK_GROUP
54 -- examples/perf_test/perf_test --
56 A test script to compare the performance for the different ways to
57 construct an ebtables table. This is deprecated and should probably
58 be ignored.