Commit 46f91add authored Apr 28, 2025 by Danilo Krummrich

rust: revocable: implement Revocable::access()



Implement an unsafe direct accessor for the data stored within the
Revocable.

This is useful for cases where we can prove that the data stored within
the Revocable is not and cannot be revoked for the duration of the
lifetime of the returned reference.

Reviewed-by: Christian Schrefl <chrisi.schrefl@gmail.com>
Reviewed-by: Benno Lossin <benno.lossin@proton.me>
Acked-by: Miguel Ojeda <ojeda@kernel.org>
Reviewed-by: Alexandre Courbot <acourbot@nvidia.com>
Acked-by: Boqun Feng <boqun.feng@gmail.com>
Reviewed-by: Joel Fernandes <joelagnelf@nvidia.com>
Link: https://lore.kernel.org/r/20250428140137.468709-2-dakr@kernel.org


Signed-off-by: Danilo Krummrich <dakr@kernel.org>

parent fc55584e

rust/kernel/revocable.rs

+12 −0

Original line number	Diff line number	Diff line
		@@ -139,6 +139,18 @@ pub fn try_access_with<R, F: FnOnce(&T) -> R>(&self, f: F) -> Option<R> {
		self.try_access().map(\|t\| f(&*t))
		}

		/// Directly access the revocable wrapped object.
		///
		/// # Safety
		///
		/// The caller must ensure this [`Revocable`] instance hasn't been revoked and won't be revoked
		/// as long as the returned `&T` lives.
		pub unsafe fn access(&self) -> &T {
		// SAFETY: By the safety requirement of this function it is guaranteed that
		// `self.data.get()` is a valid pointer to an instance of `T`.
		unsafe { &*self.data.get() }
		}

		/// # Safety
		///
		/// Callers must ensure that there are no more concurrent users of the revocable object.