summaryrefslogtreecommitdiff
path: root/INSTALL
blob: e90d5c103bdc40ad2174bc5c907232148d239a3b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
FOLLOW THESE SIMPLE GUIDELINES:
-------------------------------

Compiling the source code:
%make
Put the files in the right directories:
%make install

If you are using the CVS code or need your own kernel includes, do this
instead (change the include directory to the appropriate one):
%make install KERNEL_INCLUDES=/usr/src/linux/include

If you want to make a static binary for ebtables, containing all the
extensions, without shared libraries, do this (this will make a
binary called 'static', which you can rename):
%make static

WHAT GETS INSTALLED AND WHAT OPTIONS ARE AVAILABLE?
---------------------------------------------------

- The ebtables manual gets installed in /usr/local/man/man8
  To put the manual somewhere else, include MANDIR=<<man-path/man>> as
  option on the command line.
  The Makefile will append /man8/ebtables.8.
- ethertypes is by default placed in /etc/, if you
  want to change this, include ETHERTYPESPATH=<<path>>.
- The userspace programs ebtables ebtables-save and ebtables-restore are
  are copied by default to /usr/local/sbin/ebtables. If you want to put
  the executables somewhere else, include BINPATH=<<path>>.
- The ebtables initialisation file (enabling use of 'service ebtables') is
  copied to /etc/rc.d/init.d (change with option INITDIR)
- The ebtables configuration file (ebtables-config) is copied to /etc/sysconfig
- ebtables can use a lock file to enable concurrent execution of the ebtables
  tool. The standard location of the lock file is /var/lib/ebtables/lock.
  Include LOCKFILE=<<path-to-file>> if you want to use another file.

That's all

You can also use a base directory different from the root directory (/),
using the DESTDIR option. See the Makefile for more details.

You might need to set LDFLAGS=-Wl,-no-as-needed to build ebtables correctly
on your system.

ADDITIONAL PROGRAMS:
----------------------
-- examples/ulog/test_ulog.c --

Contains an example to receive and parse netlink messages containing
packets seen by the ebtables ulog watcher.

Compile with:
%make test_ulog KERNEL_INCLUDES=/usr/src/linux/include

Usage:
%examples/ulog/test_ulog NETLINK_GROUP
%ebtables -A chain --ulog-nlgroup NETLINK_GROUP

-- examples/perf_test/perf_test --

A test script to compare the performance for the different ways to
construct an ebtables table. This is deprecated and should probably
be ignored.