summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorHuacai Chen <chenhuacai@loongson.cn>2026-06-22 11:29:06 +0800
committerHuacai Chen <chenhuacai@loongson.cn>2026-06-22 11:29:06 +0800
commit872cc6abda1507429b97cc7b42a9dae51ee0a668 (patch)
tree8b0c0b73b454dfa4514806d15f140a5bcaa56844 /Documentation
parent8cd9520d35a6c38db6567e97dd93b1f11f185dc6 (diff)
parente4287bf34f97a88c7d9322f5bde828724c073a6b (diff)
Merge tag 'bpf-next-7.2' into loongarch-next
LoongArch architecture changes for 7.2 need the bpf changes to add new features, so merge 'bpf-next-7.2' to create a base.
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/bpf/btf.rst6
-rw-r--r--Documentation/bpf/kfuncs.rst36
-rw-r--r--Documentation/bpf/map_lru_hash_update.dot44
3 files changed, 78 insertions, 8 deletions
diff --git a/Documentation/bpf/btf.rst b/Documentation/bpf/btf.rst
index 3b60583f5db2..3f05f17990ad 100644
--- a/Documentation/bpf/btf.rst
+++ b/Documentation/bpf/btf.rst
@@ -97,10 +97,8 @@ Each type contains the following common data::
struct btf_type {
__u32 name_off;
/* "info" bits arrangement
- * bits 0-15: vlen (e.g. # of struct's members)
- * bits 16-23: unused
- * bits 24-28: kind (e.g. int, ptr, array...etc)
- * bits 29-30: unused
+ * bits 0-23: vlen (e.g. # of struct's members)
+ * bits 24-30: kind (e.g. int, ptr, array...etc)
* bit 31: kind_flag, currently used by
* struct, union, enum, fwd, enum64,
* decl_tag and type_tag
diff --git a/Documentation/bpf/kfuncs.rst b/Documentation/bpf/kfuncs.rst
index 75e6c078e0e7..4c814ff6061e 100644
--- a/Documentation/bpf/kfuncs.rst
+++ b/Documentation/bpf/kfuncs.rst
@@ -207,8 +207,26 @@ Here, the buffer may be NULL. If the buffer is not NULL, it must be at least
buffer__szk bytes in size. The kfunc is responsible for checking if the buffer
is NULL before using it.
-2.3.5 __str Annotation
-----------------------------
+2.3.5 __nonown_allowed Annotation
+---------------------------------
+
+This annotation is used to indicate that the parameter may be a non-owning reference.
+
+An example is given below::
+
+ __bpf_kfunc int bpf_list_add(..., struct bpf_list_node
+ *prev__nonown_allowed, ...)
+ {
+ ...
+ }
+
+For the ``prev__nonown_allowed`` parameter (resolved as ``KF_ARG_PTR_TO_LIST_NODE``),
+suffix ``__nonown_allowed`` retains the usual owning-pointer rules and also
+permits a non-owning reference with no ref_obj_id (e.g. the return value of
+bpf_list_front() / bpf_list_back()).
+
+2.3.6 __str Annotation
+----------------------
This annotation is used to indicate that the argument is a constant string.
An example is given below::
@@ -462,6 +480,20 @@ In order to accommodate such requirements, the verifier will enforce strict
PTR_TO_BTF_ID type matching if two types have the exact same name, with one
being suffixed with ``___init``.
+2.8 Accessing arena memory through kfunc arguments
+--------------------------------------------------
+
+A read or write at any address inside an arena does not oops the kernel.
+Unallocated arena pages are lazily backed by a scratch page and the
+access is reported through the program's BPF stream as an error. Only
+the BPF program's correctness is affected; the kernel itself remains
+intact.
+
+The arena is followed by a ``GUARD_SZ / 2`` (32 KiB) guard region that
+is also covered by this recovery. A kfunc handed an arena pointer may
+therefore access up to ``GUARD_SZ / 2`` past it without bounds-checking
+against the arena. Larger accesses must verify the range explicitly.
+
.. _BPF_kfunc_lifecycle_expectations:
3. kfunc lifecycle expectations
diff --git a/Documentation/bpf/map_lru_hash_update.dot b/Documentation/bpf/map_lru_hash_update.dot
index ab10058f5b79..412bc8b3b57e 100644
--- a/Documentation/bpf/map_lru_hash_update.dot
+++ b/Documentation/bpf/map_lru_hash_update.dot
@@ -21,10 +21,18 @@ digraph {
// names that initiate the corresponding logic in kernel/bpf/bpf_lru_list.c.
// Number suffixes and errno suffixes handle subsections of the corresponding
// logic in the function as of the writing of this dot.
+ //
+ // All LRU locks are rqspinlock_t. Every acquire can fail (AA self-deadlock
+ // or contention timeout); on failure the corresponding helper returns NULL
+ // and the caller propagates -ENOMEM. The "rqspinlock acquire failed"
+ // terminal below is reached via the dashed arrows from each acquire site.
+
+ rqspinlock_failed [shape=rectangle,
+ label="Any LRU rqspinlock\nacquire fails\n(AA or timeout)"]
// cf. __local_list_pop_free() / bpf_percpu_lru_pop_free()
local_freelist_check [shape=diamond,fillcolor=1,
- label="Local freelist\nnode available?"];
+ label="Local freelist\nnode available?\n(lockless free_llist)"];
use_local_node [shape=rectangle,
label="Use node owned\nby this CPU"]
@@ -82,6 +90,15 @@ digraph {
// fn__local_list_pop_pending()
}
+ // Post-steal: re-acquire local loc_l->lock to insert the stolen node into
+ // the local pending list. If the acquire fails, the stolen node is published
+ // to the lockless local free_llist so the next pop on this CPU picks it up
+ // instead of orphaning it.
+ post_steal_lock [shape=diamond,fillcolor=1,
+ label="Acquire local\nloc_l->lock\nto add pending"]
+ post_steal_to_free_llist [shape=rectangle,
+ label="Publish stolen node to\nlocal free_llist (lockless)"]
+
fn_bpf_lru_list_pop_free_to_local2 [shape=rectangle,
label="Use node that was\nnot recently referenced"]
local_freelist_check4 [shape=rectangle,
@@ -97,10 +114,19 @@ digraph {
fn_htab_lru_map_update_elem_ENOENT [shape=oval,label="return -ENOENT"]
begin -> local_freelist_check
+ // The initial per-CPU lock (loc_l->lock for common, l->lock for percpu) is
+ // acquired before the local freelist check; rqspinlock failure here exits
+ // directly to -ENOMEM (no recovery needed: nothing was removed yet).
+ local_freelist_check -> rqspinlock_failed [style=dashed,
+ xlabel="acquire fails"]
local_freelist_check -> use_local_node [xlabel="Y"]
local_freelist_check -> common_lru_check [xlabel="N"]
common_lru_check -> fn_bpf_lru_list_pop_free_to_local [xlabel="Y"]
common_lru_check -> fn___bpf_lru_list_shrink_inactive [xlabel="N"]
+ // Global lru_list lock acquire failure in pop_free_to_local: skip refill,
+ // fall through to the steal path. Not ENOMEM by itself.
+ fn_bpf_lru_list_pop_free_to_local -> common_lru_check2 [style=dashed,
+ xlabel="global lru_lock\nacquire fails"]
fn_bpf_lru_list_pop_free_to_local -> fn___bpf_lru_node_move_to_free
fn___bpf_lru_node_move_to_free ->
fn_bpf_lru_list_pop_free_to_local2 [xlabel="Y"]
@@ -120,13 +146,27 @@ digraph {
local_freelist_check6 -> local_freelist_check7
local_freelist_check7 -> fn_htab_lru_map_update_elem
- fn_htab_lru_map_update_elem -> fn_htab_lru_map_update_elem3 [xlabel = "Y"]
+ // Steal-loop victim lock failure is silent: treat as "no node found here"
+ // and continue to next CPU; same edge as the existing "N" path.
+ local_freelist_check5 -> fn_htab_lru_map_update_elem2 [style=dashed,
+ xlabel="victim's lock\nfails: skip"]
+ // After a successful steal, re-acquire the local loc_l->lock. On failure
+ // the stolen node is published to free_llist (recovered, not orphaned)
+ // and the update returns -ENOMEM.
+ fn_htab_lru_map_update_elem -> post_steal_lock [xlabel = "Y"]
+ post_steal_lock -> fn_htab_lru_map_update_elem3 [xlabel = "OK"]
+ post_steal_lock -> post_steal_to_free_llist [style=dashed,
+ xlabel="loc_l->lock\nacquire fails"]
+ post_steal_to_free_llist -> fn_htab_lru_map_update_elem_ENOMEM
fn_htab_lru_map_update_elem -> fn_htab_lru_map_update_elem2 [xlabel = "N"]
fn_htab_lru_map_update_elem2 ->
fn_htab_lru_map_update_elem_ENOMEM [xlabel = "Y"]
fn_htab_lru_map_update_elem2 -> local_freelist_check5 [xlabel = "N"]
fn_htab_lru_map_update_elem3 -> fn_htab_lru_map_update_elem4
+ // Shared rqspinlock-failure terminal collapses to the same -ENOMEM exit.
+ rqspinlock_failed -> fn_htab_lru_map_update_elem_ENOMEM
+
use_local_node -> fn_htab_lru_map_update_elem4
fn_bpf_lru_list_pop_free_to_local2 -> fn_htab_lru_map_update_elem4
local_freelist_check4 -> fn_htab_lru_map_update_elem4