Commit f933b748 authored by Danilo Krummrich's avatar Danilo Krummrich
Browse files

rust: device: implement Bound device context 



The Bound device context indicates that a device is bound to a driver.
It must be used for APIs that require the device to be bound, such as
Devres or dma::CoherentAllocation.

Implement Bound and add the corresponding Deref hierarchy, as well as the
corresponding ARef conversion for this device context.

Reviewed-by: default avatarBenno Lossin <benno.lossin@proton.me>
Link: https://lore.kernel.org/r/20250413173758.12068-7-dakr@kernel.org


[ Add missing `::` prefix in macros. - Danilo ]
Signed-off-by: default avatarDanilo Krummrich <dakr@kernel.org>
parent 3edaefbf

rust/kernel/device.rs

+15 −1
Original line number Diff line number Diff line
@@ -232,13 +232,19 @@ pub trait DeviceContext: private::Sealed {} 
/// any of the bus callbacks, such as `probe()`.

pub struct Core;



/// The [`Bound`] context is the context of a bus specific device reference when it is guaranteed to

/// be bound for the duration of its lifetime.

pub struct Bound;



mod private {

    pub trait Sealed {}



    impl Sealed for super::Bound {}

    impl Sealed for super::Core {}

    impl Sealed for super::Normal {}

}



impl DeviceContext for Bound {}

impl DeviceContext for Core {}

impl DeviceContext for Normal {}
@@ -281,7 +287,14 @@ macro_rules! impl_device_context_deref { 
        // `__impl_device_context_deref!`.

        ::kernel::__impl_device_context_deref!(unsafe {

            $device,

            $crate::device::Core => $crate::device::Normal

            $crate::device::Core => $crate::device::Bound

        });



        // SAFETY: This macro has the exact same safety requirement as

        // `__impl_device_context_deref!`.

        ::kernel::__impl_device_context_deref!(unsafe {

            $device,

            $crate::device::Bound => $crate::device::Normal

        });

    };

}
@@ -304,6 +317,7 @@ fn from(dev: &$device<$src>) -> Self { 
macro_rules! impl_device_context_into_aref {

    ($device:tt) => {

        ::kernel::__impl_device_context_into_aref!($crate::device::Core, $device);

        ::kernel::__impl_device_context_into_aref!($crate::device::Bound, $device);

    };

}