for_each_cpu_wrap(9)

okay bestie, welcome to the for_each_cpu_wrap(9) page from the Kernel API Manual — it's giving elegant CPU-mask iterator energy, and honestly? iconic. ✨

🌸 NAME 🌸

for_each_cpu_wrap — iterate over every cpu in a mask, starting at a specified location. 🌀

✨ SYNOPSIS ✨

for_each_cpu_wrap (cpu , mask , start );

🎀 ARGUMENTS 🎀

• cpu — the (optionally unsigned) integer iterator. she's the loop variable, bestie 💅
• mask — the cpumask pointer. the actual CPU guest list 🌈
• start — the start location. where the wrap party begins 🎉

💅 DESCRIPTION 💅

okay so plot twist: the implementation does not assume any bit in mask is set (including start). no cap, not even the start bit is promised. 🙈

after the loop, cpu is >= nr_cpu_ids. that's the after-party state, periodt. 💀

🦋 SEE ALSO 🦋

Kernel file ./include/linux/cpumask.h — that's where this whole cpumask friend group lives 🫶

• cpumask_pr_args(9)
• cpumask_first(9)
• cpumask_first_zero(9)
• cpumask_first_and(9)
• cpumask_first_andnot(9)
• cpumask_first_and_and(9)
• cpumask_last(9)
• cpumask_next(9)
• cpumask_next_zero(9)
• cpumask_next_and(9)
• cpumask_next_andnot(9)
• cpumask_next_and_wrap(9)
• cpumask_next_wrap(9)
• cpumask_random(9)
• for_each_cpu(9)
• for_each_cpu_and(9)
• for_each_cpu_andnot(9)
• for_each_cpu_or(9)
• for_each_cpu_from(9)
• cpumask_any_but(9)
• cpumask_any_and_but(9)
• cpumask_any_andnot_but(9)
• cpumask_nth(9)
• cpumask_nth_and(9)
• cpumask_nth_and_andnot(9)
• cpumask_set_cpu(9)
• cpumask_clear_cpus(9)
• cpumask_clear_cpu(9)
• cpumask_test_cpu(9)
• cpumask_test_and_set_cpu(9)
• cpumask_test_and_clear_cpu(9)
• cpumask_setall(9)
• cpumask_clear(9)
• cpumask_and(9)
• cpumask_or(9)
• cpumask_weighted_or(9)
• cpumask_xor(9)
• cpumask_andnot(9)
• cpumask_equal(9)
• cpumask_or_equal(9)
• cpumask_intersects(9)
• cpumask_subset(9)
• cpumask_empty(9)
• cpumask_full(9)
• cpumask_weight(9)
• cpumask_weight_and(9)
• cpumask_weight_andnot(9)
• cpumask_shift_right(9)
• cpumask_shift_left(9)
• cpumask_copy(9)
• cpumask_any(9)
• cpumask_any_and(9)
• cpumask_of(9)
• cpumask_parse_user(9)
• cpumask_parselist_user(9)
• cpumask_parse(9)
• cpulist_parse(9)
• cpumask_size(9)
• alloc_cpumask_var(9)
• to_cpumask(9)
• num_online_cpus(9)
• cpumap_print_bitmask_to_buf(9)
• cpumap_print_list_to_buf(9)

source/version: ./include/linux, date: October 2026 — this for_each_cpu_wrap(9) sign-off is out, mwah 💖