From 9d2bb52db8e0490e3d856821180ffb777d80dd7a Mon Sep 17 00:00:00 2001 From: Christian Breunig Date: Mon, 12 Jun 2023 20:13:11 +0200 Subject: T5286: remove XDP from documentation - feature wil be superseeded by VPP --- docs/_include/interface-xdp.txt | 32 ------------------------------ docs/configuration/interfaces/bonding.rst | 7 ------- docs/configuration/interfaces/ethernet.rst | 23 --------------------- 3 files changed, 62 deletions(-) delete mode 100644 docs/_include/interface-xdp.txt 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 }} 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 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 -- cgit v1.2.3