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

rust: module: add trait `ModuleMetadata` 



In order to access static metadata of a Rust kernel module, add the
`ModuleMetadata` trait.

In particular, this trait provides the name of a Rust kernel module as
specified by the `module!` macro.

Signed-off-by: default avatarDanilo Krummrich <dakr@kernel.org>
Tested-by: default avatarDirk Behme <dirk.behme@de.bosch.com>
Tested-by: default avatarFabien Parent <fabien.parent@linaro.org>
Link: https://lore.kernel.org/r/20241219170425.12036-2-dakr@kernel.org


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

rust/kernel/lib.rs

+6 −0
Original line number Diff line number Diff line
@@ -116,6 +116,12 @@ fn init(module: &'static ThisModule) -> impl init::PinInit<Self, error::Error> { 
    }

}



/// Metadata attached to a [`Module`] or [`InPlaceModule`].

pub trait ModuleMetadata {

    /// The name of the module as specified in the `module!` macro.

    const NAME: &'static crate::str::CStr;

}



/// Equivalent to `THIS_MODULE` in the C API.

///

/// C header: [`include/linux/init.h`](srctree/include/linux/init.h)

rust/macros/module.rs

+4 −0
Original line number Diff line number Diff line
@@ -228,6 +228,10 @@ pub(crate) fn module(ts: TokenStream) -> TokenStream { 
                kernel::ThisModule::from_ptr(core::ptr::null_mut())

            }};



            impl kernel::ModuleMetadata for {type_} {{

                const NAME: &'static kernel::str::CStr = kernel::c_str!(\"{name}\");

            }}



            // Double nested modules, since then nobody can access the public items inside.

            mod __module_init {{

                mod __module_init {{