]> git.ipfire.org Git - thirdparty/linux.git/commit
doc: xdp: Clarify driver implementation for XDP Rx metadata
authorSong Yoong Siang <yoong.siang.song@intel.com>
Wed, 16 Jul 2025 15:48:46 +0000 (23:48 +0800)
committerMartin KaFai Lau <martin.lau@kernel.org>
Wed, 16 Jul 2025 23:36:11 +0000 (16:36 -0700)
commitef57dc6f52e4949527f82a456cb9a637a55209ea
tree19e70c1d5c1bf672a007af16f2155e9946257ecc
parent6e375b236317c19cf3e4da40285ef5b2f0da1899
doc: xdp: Clarify driver implementation for XDP Rx metadata

Clarify that drivers must remove device-reserved metadata from the
data_meta area before passing frames to XDP programs.

Additionally, expand the explanation of how userspace and BPF programs
should coordinate the use of METADATA_SIZE, and add a detailed diagram
to illustrate pointer adjustments and metadata layout.

Also describe the requirements and constraints enforced by
bpf_xdp_adjust_meta().

Signed-off-by: Song Yoong Siang <yoong.siang.song@intel.com>
Signed-off-by: Martin KaFai Lau <martin.lau@kernel.org>
Acked-by: Stanislav Fomichev <sdf@fomichev.me>
Link: https://lore.kernel.org/r/20250716154846.3513575-1-yoong.siang.song@intel.com
Documentation/networking/xdp-rx-metadata.rst