ethernet: xdp: adjust CLI node

1 files changed, 16 insertions, 5 deletions

diff --git a/docs/configuration/interfaces/ethernet.rst b/docs/configuration/interfaces/ethernet.rst
index 25eebf25..8c6bcc07 100644
--- a/docs/configuration/interfaces/ethernet.rst
+++ b/docs/configuration/interfaces/ethernet.rst
@@ -92,13 +92,24 @@ 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.
 
-  .. warning:: Recent 1.3 rolling images also support XDP offloading which
-    stands for eXpress Data Path in the Linux Kernel. You must enable it for
-    every interface which should participate in the XDP forwarding.
+.. cfgcmd:: set interfaces ethernet <interface> xdp
 
-    Enabling this feature will break any form of NAT or Firewalling on this
-    interface, as XDP is handled way earlier in the driver then NfTables.
+  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.
 
 VLAN
 ====