Skip to content

Commit 8ea401b

Browse files
committed
doc: iptables: document broken iptables support
As of commit c951864, iptables is no longer supported. There are currently no plans to support legacy iptables.
1 parent 7865373 commit 8ea401b

3 files changed

Lines changed: 3 additions & 31 deletions

File tree

doc/index.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,6 @@
5858
<h5>Key features</h5>
5959

6060
- **High performance**: utilizes eBPF's near-native performance capabilities
61-
- **Flexible integration**: use the custom ``iptables`` integration or **bpfilter**'s ``bfcli`` command line for extended functionalities
6261
- **Low overhead**: minimal resource consumption with maximized efficiency
6362
- **Developer-friendly**: clean architecture with clear separation of components
6463

doc/usage/index.rst

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,7 @@ Before anything, you will have to run the daemon on your system, see :doc:`daemo
1919
Once the daemon is running, you need to choose which front-end's CLI to use:
2020

2121
- :doc:`bfcli`: ``bpfilter``-specific CLI, developed as part of the project. ``bfcli`` supports new ``bpfilter`` features before other CLIs as it's used for development. It allows for a more flexible rule definition: you can use a combination of filters and hooks that might not be possible with other CLIs. However, it doesn't support ``nftables`` or ``iptables`` rules format.
22-
- :doc:`nftables`: requires a custom version of the ``nft`` binary with ``bpfilter`` support (see below), and support for new ``bpfilter`` features is usually a bit delayed.
23-
- :doc:`iptables`: similar to ``nftables``, however ``iptables`` has been deprecated globally in favor of ``nftables``.
22+
- :doc:`nftables` (work in progress): requires a custom version of the ``nft`` binary with ``bpfilter`` support, and support for new ``bpfilter`` features is usually a bit delayed.
2423

2524
Install
2625
-------

doc/usage/iptables.rst

Lines changed: 2 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,6 @@
11
``iptables``
22
============
33

4-
A custom ``iptables`` binary is required to use with ``bpfilter``, but it can be built directly from the ``bpfilter`` source tree: ``make iptables``. Once you have build ``iptables``, you can force it to communicate with ``bpfilter`` instead of the kernel using ``--bpf``.
4+
.. warning::
55

6-
The following filters are supported:
7-
8-
- Source IPv4 address and mask.
9-
- Destination IPv4 address and mask.
10-
- Layer 4 protocol.
11-
12-
Filtering rules can be defined for any table, and ``ACCEPT`` and ``DROP`` action are supported. The ruleset can also be fetched back from ``bpfilter``. For example:
13-
14-
.. code:: shell
15-
16-
# Start bpfilter daemon
17-
$ sudo bpfilter
18-
19-
# Add a new rule to block ping requests
20-
$ sudo iptables -I INPUT --bpf -p icmp -j DROP
21-
22-
# Show the rules and counters after the host was pinged
23-
$ sudo iptables --bpf -nv -L
24-
Chain INPUT (policy ACCEPT 327 packets, 42757 bytes)
25-
pkts bytes target prot opt in out source destination
26-
2 196 DROP icmp -- * * 0.0.0.0/0 0.0.0.0/0
27-
28-
Chain FORWARD (policy ACCEPT 0 packets, 0 bytes)
29-
pkts bytes target prot opt in out source destination
30-
31-
Chain OUTPUT (policy ACCEPT 0 packets, 0 bytes)
32-
pkts bytes target prot opt in out source destination
6+
``iptables`` support is currently broken.

0 commit comments

Comments
 (0)