bpf_percpu_obj_new(9)

👑 bpf_percpu_obj_new(9) — the Kernel API Manual glow-up ✨

okay bestie, welcome to the Kernel API Manual page for bpf_percpu_obj_new(9) — a little kfunc that literally hands you a percpu object and says "here, it's yours, slay" 💅 no cap.

---

🌸 NAME 🌸

bpf_percpu_obj_new — allocate a percpu object described by program BTF 🦋

---

✨ SYNOPSIS ✨

__bpf_kfunc void * bpf_percpu_obj_new (u64 local_type_id__k ,
                                       struct btf_struct_meta *meta );

that's the whole flex, bestie. two args, one pointer back. periodt.

---

🎀 ARGUMENTS 🎀

• local_type_id__k — the type ID in the program BTF. it's giving "which type am I even allocating bestie" 💭
• meta — verifier-supplied struct btf_struct_meta metadata. you're not the one setting this, the verifier is. main character energy, honestly 👑

---

💖 DESCRIPTION 💖

So what it does is: it allocates a percpu object of the type identified by local_type_id__k 🌈.

BPF programs can use bpf_core_type_id_local to provide that local_type_id__k value — super handy, iykyk 🔥.

And the meta situation? The verifier rewrites meta itself. BPF programs do not set it, like at all 🙈. don't touch it, bestie, it's not yours.

---

🫶 RETURN 🫶

A pointer to the allocated percpu object 💫 — or NULL on failure 😭 (yes, bestie, failure exists, vibe check failed, check your returns fr fr).

---

🧚 SEE ALSO 🧚

the kernel file ./kernel/bpf/helpers.c and honestly the whole friend group:

• bpf_obj_new(9)
• bpf_obj_drop(9)
• bpf_percpu_obj_drop(9)
• bpf_refcount_acquire(9)
• bpf_list_push_front(9)
• bpf_list_push_back(9)
• bpf_rbtree_add(9)
• bpf_task_acquire(9)
• bpf_task_release(9)
• bpf_cgroup_acquire(9)
• bpf_cgroup_release(9)
• bpf_cgroup_ancestor(9)
• bpf_cgroup_from_id(9)
• bpf_task_under_cgroup(9)
• bpf_task_get_cgroup1(9)
• bpf_task_from_pid(9)
• bpf_task_from_vpid(9)
• bpf_dynptr_slice(9)
• bpf_dynptr_slice_rdwr(9)
• bpf_dynptr_copy(9)
• bpf_dynptr_memset(9)
• bpf_iter_bits_new(9)
• bpf_iter_bits_next(9)
• bpf_iter_bits_destroy(9)
• bpf_copy_from_user_str(9)
• bpf_copy_from_user_task_str(9)
• bpf_strcmp(9)
• bpf_strcasecmp(9)
• bpf_strnchr(9)
• bpf_strchr(9)
• bpf_strchrnul(9)
• bpf_strrchr(9)
• bpf_strnlen(9)
• bpf_strlen(9)
• bpf_strspn(9)
• bpf_strcspn(9)
• bpf_strstr(9)
• bpf_strcasestr(9)
• bpf_strnstr(9)
• bpf_strncasestr(9)
• bpf_lookup_user_key(9)
• bpf_lookup_system_key(9)
• bpf_key_put(9)
• bpf_verify_pkcs7_signature(9)
• bpf_task_work_schedule_signal(9)
• bpf_task_work_schedule_resume(9)
• bpf_timer_cancel_async(9)

like, the entire roster. read them, love them, cite them 🍓

---

💀 reminder bestie: meta is verifier business only — if your BPF program is out here trying to set it, that's not the move, that's a bug.

---

anyway that's the page! brought to you straight out of ./kernel/bpf, version October 2026, filed under bpf_percpu_obj_new(9) — mwah, go allocate something cute 💜✨