summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Breunig <christian@breunig.cc>2023-06-12 20:13:11 +0200
committerChristian Breunig <christian@breunig.cc>2023-06-12 20:13:11 +0200
commit9d2bb52db8e0490e3d856821180ffb777d80dd7a (patch)
tree8b928a692990b271355f3722b6603772c7d85d74
parentb41f753f3c315e36a2867d1e139e479d8ed75281 (diff)
downloadvyos-documentation-9d2bb52db8e0490e3d856821180ffb777d80dd7a.tar.gz
vyos-documentation-9d2bb52db8e0490e3d856821180ffb777d80dd7a.zip
T5286: remove XDP from documentation - feature wil be superseeded by VPP
-rw-r--r--docs/_include/interface-xdp.txt32
-rw-r--r--docs/configuration/interfaces/bonding.rst7
-rw-r--r--docs/configuration/interfaces/ethernet.rst23
3 files changed, 0 insertions, 62 deletions
diff --git a/docs/_include/interface-xdp.txt b/docs/_include/interface-xdp.txt
deleted file mode 100644
index cee9933b..00000000
--- a/docs/_include/interface-xdp.txt
+++ /dev/null
@@ -1,32 +0,0 @@
-.. cfgcmd:: set interfaces {{ var0 }} <interface> xdp
-
- Enable support for Linux :abbr:`XDP (eXpress Data Path)` on recent 1.4 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.
-
- Enabling this feature will only load the XDP router code as described here:
-
- .. stop_vyoslinter
-
- https://blog.apnic.net/2020/04/30/how-to-build-an-xdp-based-bgp-peering-router/
-
- .. start_vyoslinter
-
- Example:
-
- .. code-block:: none
-
- set interfaces {{ var0 }} {{ var1 }} xdp
diff --git a/docs/configuration/interfaces/bonding.rst b/docs/configuration/interfaces/bonding.rst
index 3d30f1a5..3c8ebd0d 100644
--- a/docs/configuration/interfaces/bonding.rst
+++ b/docs/configuration/interfaces/bonding.rst
@@ -271,13 +271,6 @@ Bond options
The maximum number of targets that can be specified is 16. The default value
is no IP address.
-Offloading
-----------
-
-.. cmdinclude:: /_include/interface-xdp.txt
- :var0: bondinging
- :var1: bond0
-
VLAN
====
diff --git a/docs/configuration/interfaces/ethernet.rst b/docs/configuration/interfaces/ethernet.rst
index 76f02d6d..4eb1b5f4 100644
--- a/docs/configuration/interfaces/ethernet.rst
+++ b/docs/configuration/interfaces/ethernet.rst
@@ -289,26 +289,3 @@ Operation
.. stop_vyoslinter
-.. opcmd:: show interfaces ethernet <interface> xdp
-
- Display XDP forwarding statistics
-
- .. code-block:: none
-
- vyos@vyos:~$ show interfaces ethernet eth1 xdp
-
- Collecting stats from BPF map
- - BPF map (bpf_map_type:6) id:176 name:xdp_stats_map key_size:4 value_size:16 max_entries:5
- XDP-action
- XDP_ABORTED 0 pkts ( 0 pps) 0 Kbytes ( 0 Mbits/s) period:0.250340
- XDP_DROP 0 pkts ( 0 pps) 0 Kbytes ( 0 Mbits/s) period:0.250317
- XDP_PASS 0 pkts ( 0 pps) 0 Kbytes ( 0 Mbits/s) period:0.250314
- XDP_TX 0 pkts ( 0 pps) 0 Kbytes ( 0 Mbits/s) period:0.250313
- XDP_REDIRECT 0 pkts ( 0 pps) 0 Kbytes ( 0 Mbits/s) period:0.250313
-
- XDP-action
- XDP_ABORTED 0 pkts ( 0 pps) 0 Kbytes ( 0 Mbits/s) period:2.000410
- XDP_DROP 0 pkts ( 0 pps) 0 Kbytes ( 0 Mbits/s) period:2.000414
- XDP_PASS 0 pkts ( 0 pps) 0 Kbytes ( 0 Mbits/s) period:2.000414
- XDP_TX 0 pkts ( 0 pps) 0 Kbytes ( 0 Mbits/s) period:2.000414
- XDP_REDIRECT 0 pkts ( 0 pps) 0 Kbytes ( 0 Mbits/s) period:2.000414