start_poll_synchronize_srcu(9)
π start_poll_synchronize_srcu(9) π
okay so this is straight out of the Kernel API Manual, bestie β the start_poll_synchronize_srcu(9) page, and it's literally about handing you a cookie and kicking off a grace period at the same time. multi-tasking icon behavior, we love to see it β¨
πΈ NAME πΈ
start_poll_synchronize_srcu β bestie it provides a cookie AND starts the grace period. two jobs, one function, main character energy fr fr πͺ
β¨ SYNOPSIS β¨
unsigned long start_poll_synchronize_srcu (struct srcu_struct *ssp );
π ARGUMENTS π
sspβ thesrcu_structyou want the cookie for. that's it. that's the whole argument. she's low maintenance π
π¦ DESCRIPTION π¦
ngl this one's actually kinda elegant. so: this function returns a cookie β and you can pass that cookie to poll_state_synchronize_srcu, which will return true if a full grace period has elapsed in the meantime. so you get the cookie now, you check it later, and it tells you if the grace period already happened. convenient much?? π
and here's the part that makes her different from get_state_synchronize_srcu β this function also ensures that any needed SRCU grace period will be started. so she's not just handing you a cookie and walking away, she's also making sure the grace period gets going. proactive queen π
but listen, bestie, nothing's free β this convenience does come at a cost in terms of CPU overhead. so likeβ¦ she's doing more work, and you're paying for it in cycles. worth it? that's your call, iykyk π
π SEE ALSO π
the kernel file lives at ./kernel/rcu/srcutree.c, and here's the whole friend group π«Ά
init_srcu_struct_generic(9)init_srcu_struct_fast(9)init_srcu_struct_fast_updown(9)cleanup_srcu_struct(9)call_srcu(9)synchronize_srcu_expedited(9)synchronize_srcu(9)get_state_synchronize_srcu(9)poll_state_synchronize_srcu(9)srcu_barrier(9)srcu_expedite_current(9)srcu_batches_completed(9)
π that's the whole page, no cap! source: ./kernel/rcu, dated October 2026, and the page is start_poll_synchronize_srcu(9) β go forth and cookie responsibly, 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