| Bart De Schuymer | 1abc55d | 2002-06-01 19:23:47 +0000 | [diff] [blame] | 1 | FOLLOW THESE SIMPLE GUIDELINES: |
| 2 | ------------------------------- |
| 3 | |
| Bart De Schuymer | 095f258 | 2005-10-20 17:29:07 +0000 | [diff] [blame] | 4 | Compiling the source code: |
| 5 | %make |
| 6 | Put the files in the right directories: |
| Bart De Schuymer | 4a721be | 2002-11-20 19:40:47 +0000 | [diff] [blame] | 7 | %make install |
| Bart De Schuymer | 1abc55d | 2002-06-01 19:23:47 +0000 | [diff] [blame] | 8 | |
| Bart De Schuymer | 4a721be | 2002-11-20 19:40:47 +0000 | [diff] [blame] | 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): |
| Bart De Schuymer | 06a9682 | 2003-02-19 20:09:51 +0000 | [diff] [blame] | 11 | %make install KERNEL_INCLUDES=/usr/src/linux/include |
| Bart De Schuymer | 1abc55d | 2002-06-01 19:23:47 +0000 | [diff] [blame] | 12 | |
| Bart De Schuymer | 7d9e3eb | 2006-02-06 21:24:02 +0000 | [diff] [blame] | 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 | |
| Bart De Schuymer | 5d44bac | 2011-07-10 09:03:27 +0000 | [diff] [blame] | 18 | WHAT GETS INSTALLED AND WHAT OPTIONS ARE AVAILABLE? |
| 19 | --------------------------------------------------- |
| Bart De Schuymer | 1abc55d | 2002-06-01 19:23:47 +0000 | [diff] [blame] | 20 | |
| Bart De Schuymer | 1abc55d | 2002-06-01 19:23:47 +0000 | [diff] [blame] | 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. |
| Bart De Schuymer | a296038 | 2003-04-01 17:29:13 +0000 | [diff] [blame] | 25 | - ethertypes is by default placed in /etc/, if you |
| 26 | want to change this, include ETHERTYPESPATH=<<path>>. |
| Bart De Schuymer | 095f258 | 2005-10-20 17:29:07 +0000 | [diff] [blame] | 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 |
| Bart De Schuymer | 5d44bac | 2011-07-10 09:03:27 +0000 | [diff] [blame] | 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. |
| Bart De Schuymer | 1abc55d | 2002-06-01 19:23:47 +0000 | [diff] [blame] | 36 | |
| 37 | That's all |
| Bart De Schuymer | 30c04a2 | 2004-11-29 21:25:36 +0000 | [diff] [blame] | 38 | |
| Bart De Schuymer | 095f258 | 2005-10-20 17:29:07 +0000 | [diff] [blame] | 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 | |
| Bart De Schuymer | 5d44bac | 2011-07-10 09:03:27 +0000 | [diff] [blame] | 43 | ADDITIONAL PROGRAMS: |
| Bart De Schuymer | 30c04a2 | 2004-11-29 21:25:36 +0000 | [diff] [blame] | 44 | ---------------------- |
| Bart De Schuymer | 26a486e | 2005-06-29 18:44:30 +0000 | [diff] [blame] | 45 | -- examples/ulog/test_ulog.c -- |
| Bart De Schuymer | 30c04a2 | 2004-11-29 21:25:36 +0000 | [diff] [blame] | 46 | |
| 47 | Contains an example to receive and parse netlink messages containing |
| 48 | packets seen by the ebtables ulog watcher. |
| 49 | |
| 50 | Compile with: |
| Bart De Schuymer | e4e4faa | 2009-11-22 11:05:25 +0000 | [diff] [blame] | 51 | %make test_ulog KERNEL_INCLUDES=/usr/src/linux/include |
| Bart De Schuymer | 30c04a2 | 2004-11-29 21:25:36 +0000 | [diff] [blame] | 52 | |
| 53 | Usage: |
| 54 | %examples/ulog/test_ulog NETLINK_GROUP |
| 55 | %ebtables -A chain --ulog-nlgroup NETLINK_GROUP |
| Bart De Schuymer | 26a486e | 2005-06-29 18:44:30 +0000 | [diff] [blame] | 56 | |
| 57 | -- examples/perf_test/perf_test -- |
| 58 | |
| 59 | A test script to compare the performance for the different ways to |
| Bart De Schuymer | 095f258 | 2005-10-20 17:29:07 +0000 | [diff] [blame] | 60 | construct an ebtables table. This is deprecated and should probably |
| 61 | be ignored. |