aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2025-10-29 12:35:36 +0100
committerAlejandro Colomar <alx@kernel.org>2025-10-29 12:36:33 +0100
commit1ffe85c6ffff88ec9efb7b1b2c40519646cb7a93 (patch)
tree737a4c5535446afe299b8f0b433e9875535b91d4
parent0b2d9bd664822e5dd8affa0583c533a9fac45027 (diff)
downloadman-pages-1ffe85c6ffff88ec9efb7b1b2c40519646cb7a93.tar.gz
man/man7/bpf-helpers.7: Refresh page from Linux v6.17
Scripted change: $ ~/src/linux/linux/v6.17/scripts/bpf_doc.py \ | rst2man \ >man7/bpf-helpers.7; Signed-off-by: Alejandro Colomar <alx@kernel.org>
-rw-r--r--man/man7/bpf-helpers.725
1 files changed, 18 insertions, 7 deletions
diff --git a/man/man7/bpf-helpers.7 b/man/man7/bpf-helpers.7
index a44b334474..01c2d87d91 100644
--- a/man/man7/bpf-helpers.7
+++ b/man/man7/bpf-helpers.7
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BPF-HELPERS" "7" "2024-10-10" "Linux v6.14"
+.TH "BPF-HELPERS" "7" "2025-06-26" "Linux v6.17"
.SH NAME
BPF-HELPERS \- list of eBPF helper functions
.\" Copyright (C) All BPF authors and contributors from 2014 to present.
@@ -263,10 +263,17 @@ The SMP id of the processor running the program.
.TP
.B Description
Store \fIlen\fP bytes from address \fIfrom\fP into the packet
-associated to \fIskb\fP, at \fIoffset\fP\&. \fIflags\fP are a combination of
-\fBBPF_F_RECOMPUTE_CSUM\fP (automatically recompute the
-checksum for the packet after storing the bytes) and
-\fBBPF_F_INVALIDATE_HASH\fP (set \fIskb\fP\fB\->hash\fP, \fIskb\fP\fB\->swhash\fP and \fIskb\fP\fB\->l4hash\fP to 0).
+associated to \fIskb\fP, at \fIoffset\fP\&. The \fIflags\fP are a combination
+of the following values:
+.INDENT 7.0
+.TP
+.B \fBBPF_F_RECOMPUTE_CSUM\fP
+Automatically update \fIskb\fP\fB\->csum\fP after storing the
+bytes.
+.TP
+.B \fBBPF_F_INVALIDATE_HASH\fP
+Set \fIskb\fP\fB\->hash\fP, \fIskb\fP\fB\->swhash\fP and \fIskb\fP\fB\->l4hash\fP to 0.
+.UNINDENT
.sp
A call to this helper is susceptible to change the underlying
packet buffer. Therefore, at load time, all checks on pointers
@@ -326,7 +333,8 @@ flags. With \fBBPF_F_MARK_MANGLED_0\fP, a null checksum is left
untouched (unless \fBBPF_F_MARK_ENFORCE\fP is added as well), and
for updates resulting in a null checksum the value is set to
\fBCSUM_MANGLED_0\fP instead. Flag \fBBPF_F_PSEUDO_HDR\fP indicates
-the checksum is to be computed against a pseudo\-header.
+that the modified header field is part of the pseudo\-header.
+Flag \fBBPF_F_IPV6\fP should be set for IPv6 packets.
.sp
This helper works in combination with \fBbpf_csum_diff\fP(),
which does not update the checksum in\-place, but offers more
@@ -740,7 +748,7 @@ one or for all CPUs) and to store the file descriptor into the
into it. An example is available in file
\fIsamples/bpf/trace_output_user.c\fP in the Linux kernel source
tree (the eBPF program counterpart is in
-\fIsamples/bpf/trace_output_kern.c\fP).
+\fIsamples/bpf/trace_output.bpf.c\fP).
.sp
\fBbpf_perf_event_output\fP() achieves better performance
than \fBbpf_trace_printk\fP() for sharing data with user
@@ -3997,6 +4005,9 @@ that the redirection happens to the \fIifindex\fP\(aq peer device and
the netns switch takes place from ingress to ingress without
going through the CPU\(aqs backlog queue.
.sp
+\fIskb\fP\fB\->mark\fP and \fIskb\fP\fB\->tstamp\fP are not cleared during
+the netns switch.
+.sp
The \fIflags\fP argument is reserved and must be 0. The helper is
currently only supported for tc BPF program types at the
ingress hook and for veth and netkit target device types. The