bpf_iter_num_next.md

title	description
KFunc 'bpf_iter_num_next'	This page documents the 'bpf_iter_num_next' eBPF kfunc, including its defintion, usage, program types that can use it, and examples.

KFunc bpf_iter_num_next

:octicons-tag-24: v6.4

Get the next number from the iterator.

Definition

This kfunc returns the next number from the iterator it. If the iterator is exhausted, it returns NULL.

#!c int *bpf_iter_num_next(struct bpf_iter_num *it)

!!! 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).

Usage

See bpf_iter_num_new for usage details.

Program types

The following program types can make use of this kfunc:

• BPF_PROG_TYPE_CGROUP_SKB
• BPF_PROG_TYPE_CGROUP_SOCK_ADDR
• BPF_PROG_TYPE_LSM
• BPF_PROG_TYPE_LWT_IN
• BPF_PROG_TYPE_LWT_OUT
• BPF_PROG_TYPE_LWT_SEG6LOCAL
• BPF_PROG_TYPE_LWT_XMIT
• BPF_PROG_TYPE_NETFILTER
• BPF_PROG_TYPE_SCHED_ACT
• BPF_PROG_TYPE_SCHED_CLS
• BPF_PROG_TYPE_SK_SKB
• BPF_PROG_TYPE_SOCKET_FILTER
• BPF_PROG_TYPE_STRUCT_OPS
• BPF_PROG_TYPE_SYSCALL
• BPF_PROG_TYPE_TRACING
• BPF_PROG_TYPE_XDP

Example

See bpf_iter_num_new for examples.