mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-08-26 21:52:20 +00:00
38559da6af
In the `module!` macro, the `author` field is currently of type `String`.
Since modules can have multiple authors, this limitation prevents
specifying more than one.
Add an `authors` field as `Option<Vec<String>>` to allow creating
modules with multiple authors, and change the documentation and all
current users to use it. Eventually, the single `author` field may
be removed.
[ The `modinfo` key needs to still be `author`; otherwise, tooling
may not work properly, e.g.:
$ modinfo --author samples/rust/rust_print.ko
Rust for Linux Contributors
I have also kept the original `author` field (undocumented), so
that we can drop it more easily in a kernel cycle or two.
- Miguel ]
Suggested-by: Miguel Ojeda <ojeda@kernel.org>
Link: https://github.com/Rust-for-Linux/linux/issues/244
Reviewed-by: Charalampos Mitrodimas <charmitro@posteo.net>
Reviewed-by: Alice Ryhl <aliceryhl@google.com>
Reviewed-by: Andreas Hindborg <a.hindborg@kernel.org>
Signed-off-by: Guilherme Giacomo Simoes <trintaeoitogc@gmail.com>
Link: https://lore.kernel.org/r/20250309175712.845622-2-trintaeoitogc@gmail.com
[ Fixed `modinfo` key. Kept `author` field. Reworded message
accordingly. Updated my email. - Miguel ]
Signed-off-by: Miguel Ojeda <ojeda@kernel.org>
81 lines
2.0 KiB
Rust
81 lines
2.0 KiB
Rust
// SPDX-License-Identifier: GPL-2.0
|
|
|
|
//! This is a Rust implementation of the C null block driver.
|
|
//!
|
|
//! Supported features:
|
|
//!
|
|
//! - blk-mq interface
|
|
//! - direct completion
|
|
//! - block size 4k
|
|
//!
|
|
//! The driver is not configurable.
|
|
|
|
use kernel::{
|
|
alloc::flags,
|
|
block::mq::{
|
|
self,
|
|
gen_disk::{self, GenDisk},
|
|
Operations, TagSet,
|
|
},
|
|
error::Result,
|
|
new_mutex, pr_info,
|
|
prelude::*,
|
|
sync::{Arc, Mutex},
|
|
types::ARef,
|
|
};
|
|
|
|
module! {
|
|
type: NullBlkModule,
|
|
name: "rnull_mod",
|
|
authors: ["Andreas Hindborg"],
|
|
description: "Rust implementation of the C null block driver",
|
|
license: "GPL v2",
|
|
}
|
|
|
|
#[pin_data]
|
|
struct NullBlkModule {
|
|
#[pin]
|
|
_disk: Mutex<GenDisk<NullBlkDevice>>,
|
|
}
|
|
|
|
impl kernel::InPlaceModule for NullBlkModule {
|
|
fn init(_module: &'static ThisModule) -> impl PinInit<Self, Error> {
|
|
pr_info!("Rust null_blk loaded\n");
|
|
|
|
// Use a immediately-called closure as a stable `try` block
|
|
let disk = /* try */ (|| {
|
|
let tagset = Arc::pin_init(TagSet::new(1, 256, 1), flags::GFP_KERNEL)?;
|
|
|
|
gen_disk::GenDiskBuilder::new()
|
|
.capacity_sectors(4096 << 11)
|
|
.logical_block_size(4096)?
|
|
.physical_block_size(4096)?
|
|
.rotational(false)
|
|
.build(format_args!("rnullb{}", 0), tagset)
|
|
})();
|
|
|
|
try_pin_init!(Self {
|
|
_disk <- new_mutex!(disk?, "nullb:disk"),
|
|
})
|
|
}
|
|
}
|
|
|
|
struct NullBlkDevice;
|
|
|
|
#[vtable]
|
|
impl Operations for NullBlkDevice {
|
|
#[inline(always)]
|
|
fn queue_rq(rq: ARef<mq::Request<Self>>, _is_last: bool) -> Result {
|
|
mq::Request::end_ok(rq)
|
|
.map_err(|_e| kernel::error::code::EIO)
|
|
// We take no refcounts on the request, so we expect to be able to
|
|
// end the request. The request reference must be unique at this
|
|
// point, and so `end_ok` cannot fail.
|
|
.expect("Fatal error - expected to be able to end request");
|
|
|
|
Ok(())
|
|
}
|
|
|
|
fn commit_rqs() {}
|
|
}
|