release/src/router/ebtables/INSTALL

   1 FOLLOW THESE SIMPLE GUIDELINES:
   2 -------------------------------
   3
   4 Compiling the source code:
   5 %make
   6 Put the files in the right directories:
   7 %make install
   8
   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
  12
  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
  17
  18 WHAT GETS INSTALLED AND WHAT OPTIONS ARE AVAILABLE?
  19 ---------------------------------------------------
  20
  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
  33 - ebtables can use a lock file to enable concurrent execution of the ebtables
  34   tool. The standard location of the lock file is /var/lib/ebtables/lock.
  35   Include LOCKFILE=<<path-to-file>> if you want to use another file.
  36
  37 That's all
  38
  39 You can also use a base directory different from the root directory (/),
  40 using the DESTDIR option. See the Makefile for more details.
  41
  42
  43 ADDITIONAL PROGRAMS:
  44 ----------------------
  45 -- examples/ulog/test_ulog.c --
  46
  47 Contains an example to receive and parse netlink messages containing
  48 packets seen by the ebtables ulog watcher.
  49
  50 Compile with:
  51 %make test_ulog KERNEL_INCLUDES=/usr/src/linux/include
  52
  53 Usage:
  54 %examples/ulog/test_ulog NETLINK_GROUP
  55 %ebtables -A chain --ulog-nlgroup NETLINK_GROUP
  56
  57 -- examples/perf_test/perf_test --
  58
  59 A test script to compare the performance for the different ways to
  60 construct an ebtables table. This is deprecated and should probably
  61 be ignored.