summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorChristian Poessinger <christian@poessinger.com>2023-01-31 07:37:18 +0100
committerChristian Poessinger <christian@poessinger.com>2023-01-31 07:37:18 +0100
commit0ff42b6f995584eac37aeca76f6b04e8ee912a9b (patch)
tree3bf42e25b35dc746f4d9b7117b5b4f4740fc2ee3 /docs
parent51a76e1b04f1a0d77ba671129c917f87dc31324f (diff)
downloadvyos-documentation-0ff42b6f995584eac37aeca76f6b04e8ee912a9b.tar.gz
vyos-documentation-0ff42b6f995584eac37aeca76f6b04e8ee912a9b.zip
xdp: remove documentation - feature not supported in VyOS 1.3
Diffstat (limited to 'docs')
-rw-r--r--docs/_include/interface-xdp.txt27
-rw-r--r--docs/configuration/interfaces/bonding.rst7
-rw-r--r--docs/configuration/interfaces/ethernet.rst31
3 files changed, 0 insertions, 65 deletions
diff --git a/docs/_include/interface-xdp.txt b/docs/_include/interface-xdp.txt
deleted file mode 100644
index d87151fc..00000000
--- a/docs/_include/interface-xdp.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-.. cfgcmd:: set interfaces {{ var0 }} <interface> 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.
-
- 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
-
- set interfaces {{ var0 }} {{ var1 }} xdp \ No newline at end of file
diff --git a/docs/configuration/interfaces/bonding.rst b/docs/configuration/interfaces/bonding.rst
index 1e89e5f0..6db8e53b 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: bonding
- :var1: bond0
-
VLAN
====
diff --git a/docs/configuration/interfaces/ethernet.rst b/docs/configuration/interfaces/ethernet.rst
index 4fa9f6be..071044f5 100644
--- a/docs/configuration/interfaces/ethernet.rst
+++ b/docs/configuration/interfaces/ethernet.rst
@@ -107,11 +107,6 @@ Offloading
- it does not increase hardware device interrupt rate (although it does
introduce inter-processor interrupts (IPIs)).
-
-.. cmdinclude:: /_include/interface-xdp.txt
- :var0: ethernet
- :var1: eth0
-
Authentication (EAPoL)
----------------------
@@ -288,29 +283,3 @@ Operation
BR margin, min : 0%
Vendor SN : FNS092xxxxx
Date code : 0506xx
-
-.. 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