radix_tree_iter_resume(9)
π radix_tree_iter_resume(9) π
okay so bestie, welcome to the Kernel API Manual β yes we're reading kernel docs together, this is our bonding era π«Ά. Today's main character: radix_tree_iter_resume, and trust, she's lowkey iconic once you get what she's for.
β¨ NAME β¨
radix_tree_iter_resume β resume iterating when the chunk may be invalid π. That's the whole vibe. She picks your iteration back up when stuff might've gone sideways while you weren't looking.
πΈ SYNOPSIS πΈ
void __rcu ** radix_tree_iter_resume (void __rcu **slot , struct
radix_tree_iter *iter );
like, yes, the return type has __rcu ** in it, we love a dramatic pointer-to-pointer moment π.
π ARGUMENTS π
slotβ pointer to current slot. this is your spot, your little address in the tree, she knows where she is πiterβ iterator state. the whole memory of the walk, all the state, the receipts, everything πΈ
β RETURN β
New slot pointer. that's it, that's the gift π β a fresh slot pointer handed right back to you.
π¦ DESCRIPTION π¦
okay so here's the situation, and it's giving "I need to let go of the lock but I'm scared" π.
If the iterator needs to release then reacquire a lock, the chunk may have been invalidated by an insertion or deletion in the meantime. like, you let go for one sec and the tree said "new phone who dis" and rearranged itself π.
So: call this function before releasing the lock, and it'll continue the iteration from the next index. no cap, that's the whole move. lock drops, lock comes back, iteration carries on from the next index like nothing happened β¨.
fr fr do NOT skip the "before releasing the lock" part β that's the entire point of her existence π
π SEE ALSO π
- Kernel file
./include/linux/radix-tree.hstructradix_tree_iter(9)β the struct herself, go say hi π«Ά Radix-tree synchronization(9)radix_tree_deref_slot(9)radix_tree_deref_slot_protected(9)radix_tree_deref_retry(9)radix_tree_exception(9)radix_tree_iter_init(9)radix_tree_next_chunk(9)radix_tree_iter_lookup(9)radix_tree_iter_retry(9)radix_tree_chunk_size(9)radix_tree_next_slot(9)radix_tree_for_each_slot(9)radix_tree_for_each_tagged(9)
okay that's the whole page, you ate that π. this one lives over in ./include/linux, dated October 2026, and she answers to radix_tree_iter_resume(9) β mwah, see you in the next manpage bestie ππ§
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms