start_poll_synchronize_rcu(9)
π start_poll_synchronize_rcu(9) β the Kernel API Manual glow-up
okay bestie, welcome to the Kernel API Manual, section 9, and today's main character is start_poll_synchronize_rcu π she's a little function with a big job: she takes a snapshot and kicks off an RCU grace period. periodt.
β¨ NAME β¨
start_poll_synchronize_rcu β snapshot and start RCU grace period π«Ά
πΈ SYNOPSIS πΈ
unsigned long start_poll_synchronize_rcu (void );
like, that's the whole signature. yes the space before the ) is supposed to be there. no we're not fixing it. it's iconic π
π¦ ARGUMENTS π¦
voidβ no arguments. zero. nada. she takes nothing and she gives you a cookie. queen behavior honestly π
π₯ DESCRIPTION π₯
so here's the vibe: start_poll_synchronize_rcu returns a cookie πͺ β and that cookie gets handed off to a later call to cond_synchronize_rcu or poll_state_synchronize_rcu, which use it to figure out whether or not a full grace period has elapsed in the meantime. iykyk.
and if the grace period you need is not already slated to start, she notifies the RCU core that said grace period is needed. like she's texting the group chat "hey we need this, it's happening" π²β¨
π SEE ALSO π
all the siblings and cousins, no cap. kernel file ./kernel/rcu/tree.c, and then:
rcu_softirq_qs(9)rcu_watching_snap_stopped_since(9)rcu_is_cpu_rrupt_from_idle(9)rcu_irq_exit_check_preempt(9)__rcu_irq_enter_check_tick(9)rcu_is_watching(9)rcu_set_gpwrap_lag(9)call_rcu_hurry(9)call_rcu(9)synchronize_rcu(9)get_completed_synchronize_rcu_full(9)get_state_synchronize_rcu(9)get_state_synchronize_rcu_full(9)start_poll_synchronize_rcu_full(9)poll_state_synchronize_rcu(9)poll_state_synchronize_rcu_full(9)cond_synchronize_rcu(9)cond_synchronize_rcu_full(9)rcu_barrier(9)rcu_barrier_throttled(9)
the whole friend group fr fr π
aaaand that's the page!! mwah π source lives at ./kernel/rcu, dated October 2026, and it's filed under start_poll_synchronize_rcu(9) β ok bye bestie, go take a snapshot, slay π§ββοΈβ
π¦ 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