[PATCH v4 0/3] rust: add SRCU abstraction

From: Onur Özkan

Date: Mon May 25 2026 - 13:57:57 EST


The immediate motivation is the Tyr reset infrastructure [1] which needs
to serialize reset sensitive hardware access against reset and teardown
paths. That reset series started to require many independent dependencies
so this SRCU support is split out as a standalone Rust API to keep the
reset series focused on the reset logic and easier to review, rebase and
land.

Changes since v3 (which are for Sashiko notes [2]):

- Added rust helpers for srcu_barrier() and synchronize_srcu_expedited()
so the abstraction builds with CONFIG_TINY_SRCU, where these are
static inline functions.
- Added missing INVARIANT comment in Srcu::new() about why the type
invariants hold after successful initialization.

Changes since v2:

- Removed closure-based API.
- Added #[doc(hidden)] on new_srcu macro.
- Added #[must_use..] on srcu::Guard.
- Improved the clean-up path (PinnedDrop implementation) which
eventually made read_lock safe with leaked guards.

v2: https://lore.kernel.org/all/20260502162833.34334-1-work@xxxxxxxxxxxxx

Changes since v1:

- Made the owned SRCU read-side guard API unsafe and added a safe closure
based helper for callers that do not need to keep the guard. This is to
avoid UB on the C side cleanup_srcu_struct where the SRCU struct is freed
while there are still active guards, which can happen if the caller leaks
the guard e.g., with mem::forget().
- Improved doc comments.

v1: https://lore.kernel.org/all/20260428103437.156236-1-work@xxxxxxxxxxxxx


[1]: https://lore.kernel.org/all/20260416171728.205141-1-work@xxxxxxxxxxxxx
[2]: https://sashiko.dev/#/patchset/20260522054228.114814-1-work@xxxxxxxxxxxxx?part=2

Onur Özkan (3):
rust: helpers: add SRCU helpers
rust: sync: add SRCU abstraction
MAINTAINERS: add Rust SRCU files to SRCU entry

MAINTAINERS | 3 +
rust/helpers/helpers.c | 1 +
rust/helpers/srcu.c | 34 +++++++++
rust/kernel/sync.rs | 2 +
rust/kernel/sync/srcu.rs | 158 +++++++++++++++++++++++++++++++++++++++
5 files changed, 198 insertions(+)
create mode 100644 rust/helpers/srcu.c
create mode 100644 rust/kernel/sync/srcu.rs

--
2.51.2