From 2b55a3a72fca5975724836df2d857de77fb12e7f Mon Sep 17 00:00:00 2001 From: Christian Poessinger Date: Wed, 23 Dec 2020 14:30:45 +0100 Subject: xdp: use common include for both ethernet and bond --- docs/_include/interface-xdp.txt | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 docs/_include/interface-xdp.txt (limited to 'docs/_include/interface-xdp.txt') diff --git a/docs/_include/interface-xdp.txt b/docs/_include/interface-xdp.txt new file mode 100644 index 00000000..6f5f88c1 --- /dev/null +++ b/docs/_include/interface-xdp.txt @@ -0,0 +1,24 @@ +.. cfgcmd:: set interfaces {{ var0 }} xdp + + Enable support for Linux :abbr:`XDP (eXpress Data Path)` on recent 1.3 rolling + releases. You must enable it for every interface which should participate in + the XDP forwarding. + + XDP is an eBPF based high performance data path merged in the Linux kernel + since version 4.8. The idea behind XDP is to add an early hook in the RX path + of the kernel, and let a user supplied eBPF program decide the fate of the + packet. The hook is placed in the NIC driver just after the interrupt + processing, and before any memory allocation needed by the network stack + itself, because memory allocation can be an expensive operation. + + .. warning:: This is highly experimental! + + .. note:: Enabling this feature will break any form of NAT or Firewalling on + this interface, as XDP is handled way earlier in the driver then iptables/ + nftables. + + Example: + + .. code-block:: none + + set interfaces {{ var0 }} {{ var1 }} xdp \ No newline at end of file -- cgit v1.2.3 From f24d3637e5ecb07f202f04996007255c640f45e2 Mon Sep 17 00:00:00 2001 From: Christian Poessinger Date: Wed, 23 Dec 2020 14:49:46 +0100 Subject: xdp: referece XDP router from APNIC --- docs/_include/interface-xdp.txt | 3 +++ 1 file changed, 3 insertions(+) (limited to 'docs/_include/interface-xdp.txt') diff --git a/docs/_include/interface-xdp.txt b/docs/_include/interface-xdp.txt index 6f5f88c1..d87151fc 100644 --- a/docs/_include/interface-xdp.txt +++ b/docs/_include/interface-xdp.txt @@ -17,6 +17,9 @@ this interface, as XDP is handled way earlier in the driver then iptables/ nftables. + Enabling this feature will only load the XDP router code as described here: + https://blog.apnic.net/2020/04/30/how-to-build-an-xdp-based-bgp-peering-router/ + Example: .. code-block:: none -- cgit v1.2.3