trace_pid_list_next(9)

✨ trace_pid_list_next(9) ✨

okay so bestie, we're deep in the Kernel API Manual today and this one is literally the "who's next tho" of pid lists 💅

🌸 NAME 🌸

trace_pid_list_next — return the next pid in the list 🫶

🎀 SYNOPSIS 🎀

int trace_pid_list_next (struct trace_pid_list *pid_list , unsigned int
pid , unsigned int *next );

🦋 ARGUMENTS 🦋

• pid_list — the pid list we're gonna examine 👀 like, this is the whole vibe we're searching through
• pid — the pid you start from 🏁 your little starting point, no cap
• next — the pointer where the found pid gets placed, set starting from pid ✨ this is where the answer goes

💖 DESCRIPTION 💖

So the way this works: it looks for the next consecutive pid that's in pid_list, starting at the pid you specified with pid. If one is set (including pid itself, yes queen, it counts 💅), then that pid gets placed into next.

Return 0 when a pid is found 🎉 and -1 if there are no more pids included 😭 that's it, that's the whole vibe check.

ngl the -1 is not an error, it's just the "we're out of pids bestie" signal, so don't panic 💀

🌈 SEE ALSO 🌈

Kernel file ./kernel/trace/pid_list.c and the rest of the squad:

• trace_pid_list_is_set(9)
• trace_pid_list_set(9)
• trace_pid_list_clear(9)
• trace_pid_list_first(9)
• trace_pid_list_alloc(9)
• trace_pid_list_free(9)

and that's the page 💖 brought to you by ./kernel/trace, living its best October 2026 life — slay, icon, periodt 👑✨