Re: [PATCH bpf-next v2] bpf: Add kernel-doc for arena page kfuncs

[bot+bpf-ci]

> bpf: Add kernel-doc for arena page kfuncs
>
> The page-management kfuncs exposed by BPF arena -
> bpf_arena_alloc_pages(), bpf_arena_free_pages() and
> bpf_arena_reserve_pages() - are part of the BPF kfunc ABI but lack
> rendered documentation. Their contracts (valid argument ranges,
> sleepable-only context, and the set of error returns) are today only
                    ^^^^^^^^^^^^^^^^^^^^
> discoverable by reading kernel/bpf/arena.c.

Is the description "sleepable-only context" accurate here? The BPF
verifier supports calling bpf_arena_alloc_pages() and
bpf_arena_free_pages() in non-sleepable contexts by dynamically
replacing the calls with their non-sleepable variants.

Looking at the BTF_ID_FLAGS definitions, they do not include
KF_SLEEPABLE. While the code documentation was fixed in v2 to reflect
this, the commit message text was not updated.

This was flagged by both bot+bpf-ci@xxxxxxxxxx and sashiko-bot@xxxxxxxxxx
in their reviews of v2:

https://lore.kernel.org/bpf/a0b9a09127618cb4e3dd1aae92ef25aab9beb90bd533490ec5be7789420d9ef4@xxxxxxxxxxxxxxx/


---
AI reviewed your patch. Please fix the bug or email reply why it's not a bug.
See: https://github.com/kernel-patches/vmtest/blob/master/ci/claude/README.md

CI run summary: https://github.com/kernel-patches/bpf/actions/runs/26409601656