KFunc scx_bpf_get_idle_cpumask_node

v6.15

Get a referenced kptr to the idle-tracking per-CPU cpumask of a target NUMA node.

Definition

Parameters

node: target NUMA node

Returns

An empty cpumask if idle tracking is not enabled, if node is not valid, or running on a UP kernel. In this case the actual error will be reported to the BPF scheduler via scx_error.

Signature

const struct cpumask *scx_bpf_get_idle_cpumask_node(int node)

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.

Usage

Docs could be improved

This part of the docs is incomplete, contributions are very welcome

Program types

The following program types can make use of this kfunc:

• BPF_PROG_TYPE_LSM
• BPF_PROG_TYPE_PERF_EVENT v6.12 -
• BPF_PROG_TYPE_STRUCT_OPS
• BPF_PROG_TYPE_SYSCALL
• BPF_PROG_TYPE_TRACEPOINT v6.12 -
• BPF_PROG_TYPE_TRACING

Example

Docs could be improved

This part of the docs is incomplete, contributions are very welcome