| title | description |
|---|---|
KFunc 'bpf_task_get_cgroup1' |
This page documents the 'bpf_task_get_cgroup1' eBPF kfunc, including its defintion, usage, program types that can use it, and examples. |
Acquires the associated cgroup of a task within a specific cgroup1 hierarchy.
The cgroup1 hierarchy is identified by its hierarchy ID.
Returns
On success, the cgroup is returen. On failure, NULL is returned.
#!c struct cgroup *bpf_task_get_cgroup1(struct task_struct *task, int hierarchy_id)
!!! note
This kfunc returns a pointer to a refcounted object. The verifier will then ensure that the pointer to the object
is eventually released using a release kfunc, or transferred to a map using a referenced kptr
(by invoking bpf_kptr_xchg). If not, the verifier fails the
loading of the BPF program until no lingering references remain in all possible explored states of the program.
!!! note The pointer returned by the kfunc may be NULL. Hence, it forces the user to do a NULL check on the pointer returned from the kfunc before making use of it (dereferencing or passing to another helper).
!!! example "Docs could be improved" This part of the docs is incomplete, contributions are very welcome
The following program types can make use of this kfunc:
- BPF_PROG_TYPE_LSM
- BPF_PROG_TYPE_SCHED_CLS
- BPF_PROG_TYPE_STRUCT_OPS
- BPF_PROG_TYPE_TRACING
- BPF_PROG_TYPE_XDP
!!! example "Docs could be improved" This part of the docs is incomplete, contributions are very welcome