Commit 4d032779 authored by Danilo Krummrich's avatar Danilo Krummrich Committed by Greg Kroah-Hartman
Browse files

rust: device: implement device context marker 



Some bus device functions should only be called from bus callbacks,
such as probe(), remove(), resume(), suspend(), etc.

To ensure this add device context marker structs, that can be used as
generics for bus device implementations.

Reviewed-by: default avatarBenno Lossin <benno.lossin@proton.me>
Suggested-by: default avatarBenno Lossin <benno.lossin@proton.me>
Signed-off-by: default avatarDanilo Krummrich <dakr@kernel.org>
Acked-by: default avatarBoqun Feng <boqun.feng@gmail.com>
Link: https://lore.kernel.org/r/20250314160932.100165-3-dakr@kernel.org


Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent d1f6d6c5

rust/kernel/device.rs

+26 −0
Original line number Diff line number Diff line
@@ -209,6 +209,32 @@ unsafe impl Send for Device {} 
// synchronization in `struct device`.

unsafe impl Sync for Device {}



/// Marker trait for the context of a bus specific device.

///

/// Some functions of a bus specific device should only be called from a certain context, i.e. bus

/// callbacks, such as `probe()`.

///

/// This is the marker trait for structures representing the context of a bus specific device.

pub trait DeviceContext: private::Sealed {}



/// The [`Normal`] context is the context of a bus specific device when it is not an argument of

/// any bus callback.

pub struct Normal;



/// The [`Core`] context is the context of a bus specific device when it is supplied as argument of

/// any of the bus callbacks, such as `probe()`.

pub struct Core;



mod private {

    pub trait Sealed {}



    impl Sealed for super::Core {}

    impl Sealed for super::Normal {}

}



impl DeviceContext for Core {}

impl DeviceContext for Normal {}



#[doc(hidden)]

#[macro_export]

macro_rules! dev_printk {