Skip to contentSkip to conversation

rust: sync: Add Lock::from_raw for Lock<(), B>

PATCH Superseded Lyude Paul 2 participants 3 messages Sep 16, 2024 – Sep 21, 2024

Subsystems (3)

v2 of 4 Superseded Latest is v4 →

lore
Share & tools
lore

Lyude Paul

author reviewer
#0 lore raw

v2 cover rust: sync: Add Lock::from_raw for Lock<(), B>

This patch just adds a ::from_raw method to the kernel's Lock type, which can be used for locks where the data type is ().

The current example usecase for this is rvkms, specifically rust/kernel/drm/device.rs (kernel::drm::device::Device::event_lock())

https://gitlab.freedesktop.org/lyudess/linux/-/tree/rvkms-example-09162024

Lyude Paul (1):
rust: sync: Add Lock::from_raw() for Lock<(), B>

 rust/kernel/sync/lock.rs | 28 ++++++++++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

base-commit: a2f11547052001bd448ccec81dd1e68409078fbb

Signature · 1 line
2.46.0
author reviewer
#1 lore raw

PATCH v2 1/1 rust: sync: Add Lock::from_raw() for Lock<(), B>

A few of the APIs I've been writing bindings for (KMS in particular) rely on the user manually acquiring specific locks before calling certain functions. At the moment though, the only way of acquiring these locks in bindings is to simply call the C locking functions directly - since said locks are not acquired on the rust side of things.

However - if we add #[repr(C)] to Lock<(), B>, then given () is a ZST
- Lock<(), B> becomes equivalent in data layout to its inner B::State type. Since locks in C don't have data explicitly associated with them anyway, we can take advantage of this to add a Lock::from_raw() function that can translate a raw pointer to B::State into its proper Lock<(), B> equivalent. This lets us simply acquire a reference to the lock in question and work with it like it was initialized on the rust side of things, allowing us to use less unsafe code to implement bindings with lock requirements.

---

V2:
* Don't implement this for all ZST types, just implement it for ()

---
 rust/kernel/sync/lock.rs | 28 ++++++++++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)
rust/kernel/sync/lock.rs +26 -2
index f6c34ca4d819f..8a74a1ea1ecaf 100644
@@ -6,8 +6,8 @@
 //! spinlocks, raw spinlocks) to be provided with minimal effort.
 
 use super::LockClassKey;
-use crate::{init::PinInit, pin_init, str::CStr, types::Opaque, types::ScopeGuard};
-use core::{cell::UnsafeCell, marker::PhantomData, marker::PhantomPinned};
+use crate::{init::PinInit, pin_init, prelude::*, str::CStr, types::Opaque, types::ScopeGuard};
+use core::{cell::UnsafeCell, marker::PhantomData, marker::PhantomPinned, mem};
 use macros::pin_data;
 
 pub mod mutex;
@@ -81,6 +81,7 @@ unsafe fn relock(ptr: *mut Self::State, guard_state: &mut Self::GuardState) {
 ///
 /// Exposes one of the kernel locking primitives. Which one is exposed depends on the lock
 /// [`Backend`] specified as the generic parameter `B`.
+#[repr(C)]
 #[pin_data]
 pub struct Lock<T: ?Sized, B: Backend> {
     /// The kernel lock object.
@@ -117,6 +118,29 @@ pub fn new(t: T, name: &'static CStr, key: &'static LockClassKey) -> impl PinIni
             }),
         })
     }
+
+}
+
+impl<B: Backend> Lock<(), B> {
+    /// Constructs a [`Lock`] from a raw pointer.
+    ///
+    /// This can be useful for interacting with a lock which was initialised outside of rust.
+    ///
+    /// # Safety
+    ///
+    /// The caller promises that `ptr` points to a valid initialised instance of [`State`].
+    ///
+    /// [`State`]: Backend::State
+    pub unsafe fn from_raw<'a>(ptr: *mut B::State) -> &'a Self
+    {
+        // SAFETY:
+        // * By the safety contract `ptr` must point to a valid initialised instance of `B::State`
+        // * Since the lock data type is `()` which is a ZST, `state` is the only non-ZST member of
+        //   the struct
+        // * Combined with `#[repr(C)]`, this guarantees `Self` has an equivalent data layout to
+        //   `B::State`.
+        unsafe { &*ptr.cast() }
+    }
 }
 
 impl<T: ?Sized, B: Backend> Lock<T, B> {
Signature · 1 line
2.46.0
#2 lore raw

Re: [PATCH v2 1/1] rust: sync: Add Lock::from_raw() for Lock<(), B>

kernel test robot noticed the following build warnings:

Hi Lyude,

kernel test robot noticed the following build warnings:

[auto build test WARNING on a2f11547052001bd448ccec81dd1e68409078fbb]

url:    https://github.com/intel-lab-lkp/linux/commits/Lyude-Paul/rust-sync-Add-Lock-from_raw-for-Lock-B/20240917-071956
base:   a2f11547052001bd448ccec81dd1e68409078fbb
patch link:    https://lore.kernel.org/r/20240916231817.643934-4-lyude%40redhat.com
patch subject: [PATCH v2 1/1] rust: sync: Add Lock::from_raw() for Lock<(), B>
config: x86_64-randconfig-104-20240921 (https://download.01.org/0day-ci/archive/20240921/[email protected]/config)
compiler: clang version 18.1.8 (https://github.com/llvm/llvm-project 3b5b5c1ec4a3095ab096dd780e84d7ab81f3d7ff)
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20240921/[email protected]/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <[email protected]>
| Closes: https://lore.kernel.org/oe-kbuild-all/[email protected]/

All warnings (new ones prefixed by >>):

>> warning: unused import: `mem`

--> rust/kernel/sync/lock.rs:10:74
|
10 | use core::{cell::UnsafeCell, marker::PhantomData, marker::PhantomPinned, mem};
| ^^^
|
= note: #[warn(unused_imports)] on by default
--

>> warning: unused import: `prelude`

--> rust/kernel/sync/lock.rs:9:38
|
9 | use crate::{init::PinInit, pin_init, prelude::*, str::CStr, types::Opaque, types::ScopeGuard};
| ^^^^^^^

Signature · 2 lines
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki