synchronize_rcu_expedited(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… synchronize_rcu_expedited(9) πŸ’…

okay bestie, welcome to the Kernel API Manual page for synchronize_rcu_expedited(9) β€” this one is giving β€œbrute-force grace period” energy, and we’re gonna get into it ✨


🌸 NAME 🌸

  • synchronize_rcu_expedited β€” Brute-force RCU grace period 🫢

πŸ¦‹ SYNOPSIS πŸ¦‹

void synchronize_rcu_expedited (void );

πŸ’… ARGUMENTS πŸ’…

  • void β€” no arguments. Zero. Nada. It takes no arguments, periodt πŸ’€

πŸ”₯ DESCRIPTION πŸ”₯

So the whole vibe is: wait for an RCU grace period, but expedite it. The basic idea is to IPI all non-idle non-nohz online CPUs. The IPI handler checks whether the CPU is in an RCU critical section, and if so, it sets a flag that causes the outermost rcu_read_unlock to report the quiescent state for RCU-preempt or asks the scheduler for help for RCU-sched. On the other hand, if the CPU is not in an RCU read-side critical section, the IPI handler reports the quiescent state immediately πŸ‘‘

And like, yes, this is a great improvement over previous expedited implementations. But it is still unfriendly to real-time workloads, so it is thus not recommended for any sort of common-case code. In fact, if you are using synchronize_rcu_expedited in a loop, please restructure your code to batch your updates, and then use a single synchronize_rcu instead πŸ™ˆ

bestie, this has the same semantics as (but is more brutal than) synchronize_rcu. Not me warning you dramatically, but also yes, literally warning you dramatically πŸ’€

πŸ‘‘ SEE ALSO πŸ‘‘


okay that’s the page, bestie πŸ’– cute little sign-off: source/version is ./kernel/rcu, dated October 2026, for synchronize_rcu_expedited(9) β€” mwah πŸ’‹

πŸ“¦ where this page comes from