vyos/vyos-documentation
1
0
Fork 0
mirror of https://github.com/vyos/vyos-documentation.git synced 2025-12-16 02:22:04 +01:00
Code Issues Packages Projects Releases Wiki Activity

xdp: use common include for both ethernet and bond

Browse Source
This commit is contained in:
Christian Poessinger 2020-12-23 14:30:45 +01:00
parent 6cdae27351
commit 2b55a3a72f
3 changed files with 35 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
docs/_include/interface-xdp.txt Normal file
View File

@ -0,0 +1,24 @@
.. 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.
Example:
.. code-block:: none
set interfaces {{ var0 }} {{ var1 }} xdp

8
docs/configuration/interfaces/bonding.rst
View File

@ -256,6 +256,13 @@ Bond options
The maximum number of targets that can be specified is 16. The default value
is no IP addresses.
Offloading
----------
.. cmdinclude:: /_include/interface-xdp.txt
:var0: bonding
:var1: bond0
VLAN
====
@ -265,6 +272,7 @@ VLAN
Port Mirror (SPAN)
==================
.. cmdinclude:: ../../_include/interface-mirror.txt
:var0: bonding
:var1: bond1

21
docs/configuration/interfaces/ethernet.rst
View File

@ -92,24 +92,9 @@ Offloading
the IPv4 ID is not sequentially incrementing it will be altered so that it is
when a frame assembled via GRO is segmented via GSO.
.. cfgcmd:: set interfaces ethernet <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.
.. cmdinclude:: /_include/interface-xdp.txt
:var0: ethernet
:var1: eth0
VLAN
====