From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DFE011E2617; Fri, 6 Dec 2024 09:02:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733475721; cv=none; b=YJFGbab34V1i8yXyE24onS/Evaf4qUjIl9BUGqU8XVbXJiaq6lV4xVBJB/jYbMDkDmcet8QbN37WtIJaKTOcMnm2gWOVmwbOh2CTf4nIhi5HUoio6Q8W36+DCT/KODwBcU3Jc5GRdlGHpch0fHK4Z/2MSJOWrgbrbD4d6sTakGY= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733475721; c=relaxed/simple; bh=XWD3YWdZXUE2SZt16mOKszuwLSOfo+1lXG/AOJzR51Q=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=JLWJQUJ7NrxmMoh8NaAPSNOTClOEcu8oEWfu0MT5EC55P+zHngIsgGq6lTk2fDlp6LFXsiOgWrDT+j3x+u36jY3HiYwLqOk2a5KxgJDUfeg/f2W/nYXvq/KRMtJqxEc+7SVjlMxfQxEVcWI8/DQq1a8nz2VVjwMCvcnm9WP6Eu4= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=aujXnEVL; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="aujXnEVL" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 78A82C4CEDF; Fri, 6 Dec 2024 09:01:57 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1733475720; bh=XWD3YWdZXUE2SZt16mOKszuwLSOfo+1lXG/AOJzR51Q=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=aujXnEVLRamWYUKSNF0HSFX25gxTeSm2xe3+A4k6Wmv7MfvN4Pz2AbaeLlco0nuHo inrGBt/qQZRuL3RJhgaI08Ow6j794+h3EiHR8NDk5HpQeCwYcGs1faONQxyMgjBu8i b50vrlphiFAeVm0e1EfF2BB7FXYaD6nWxNmnr/ArOBaQVehUW6LTRYeZn++xdi5ZHn oxGSZJeDvVSWxhpteg/A2M8G7ymdPWy3JXPaf1ApieG16HmhvnUQ4RQzEm/X7na3TP KPb8+l1Y7YPDyVZlluDdDiUCOifzbPAsp1drMc17e4ABtM1pH32D+91yNy99njyJ+Q yLh1jRi7sGWQA== Date: Fri, 6 Dec 2024 10:01:54 +0100 From: Danilo Krummrich To: Lee Jones Cc: linux-kernel@vger.kernel.org, arnd@arndb.de, gregkh@linuxfoundation.org, ojeda@kernel.org, alex.gaynor@gmail.com, boqun.feng@gmail.com, gary@garyguo.net, bjorn3_gh@protonmail.com, benno.lossin@proton.me, a.hindborg@kernel.org, aliceryhl@google.com, tmgross@umich.edu, rust-for-linux@vger.kernel.org Subject: Re: [PATCH v3 3/5] samples: rust: Provide example using the new Rust MiscDevice abstraction Message-ID: References: <20241205162531.1883859-1-lee@kernel.org> <20241205162531.1883859-4-lee@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20241205162531.1883859-4-lee@kernel.org> On Thu, Dec 05, 2024 at 04:25:20PM +0000, Lee Jones wrote: > This sample driver demonstrates the following basic operations: > > * Register a Misc Device > * Create /dev/rust-misc-device > * Open the aforementioned character device > * Operate on the character device via a simple ioctl() > * Close the character device > > Signed-off-by: Lee Jones > --- > samples/rust/Kconfig | 10 ++++ > samples/rust/Makefile | 1 + > samples/rust/rust_misc_device.rs | 80 ++++++++++++++++++++++++++++++++ > 3 files changed, 91 insertions(+) > create mode 100644 samples/rust/rust_misc_device.rs > > diff --git a/samples/rust/Kconfig b/samples/rust/Kconfig > index b0f74a81c8f9..df384e679901 100644 > --- a/samples/rust/Kconfig > +++ b/samples/rust/Kconfig > @@ -20,6 +20,16 @@ config SAMPLE_RUST_MINIMAL > > If unsure, say N. > > +config SAMPLE_RUST_MISC_DEVICE > + tristate "Misc device" > + help > + This option builds the Rust misc device. > + > + To compile this as a module, choose M here: > + the module will be called rust_misc_device. > + > + If unsure, say N. > + > config SAMPLE_RUST_PRINT > tristate "Printing macros" > help > diff --git a/samples/rust/Makefile b/samples/rust/Makefile > index c1a5c1655395..ad4b97a98580 100644 > --- a/samples/rust/Makefile > +++ b/samples/rust/Makefile > @@ -2,6 +2,7 @@ > ccflags-y += -I$(src) # needed for trace events > > obj-$(CONFIG_SAMPLE_RUST_MINIMAL) += rust_minimal.o > +obj-$(CONFIG_SAMPLE_RUST_MISC_DEVICE) += rust_misc_device.o > obj-$(CONFIG_SAMPLE_RUST_PRINT) += rust_print.o > > rust_print-y := rust_print_main.o rust_print_events.o > diff --git a/samples/rust/rust_misc_device.rs b/samples/rust/rust_misc_device.rs > new file mode 100644 > index 000000000000..f50925713f1a > --- /dev/null > +++ b/samples/rust/rust_misc_device.rs > @@ -0,0 +1,80 @@ > +// SPDX-License-Identifier: GPL-2.0 > + > +// Copyright (C) 2024 Google LLC. > + > +//! Rust misc device sample. > + > +use kernel::{ > + c_str, > + ioctl::_IO, > + miscdevice::{MiscDevice, MiscDeviceOptions, MiscDeviceRegistration}, > + prelude::*, > +}; > + > +const RUST_MISC_DEV_HELLO: u32 = _IO('R' as u32, 9); > + > +module! { > + type: RustMiscDeviceModule, > + name: "rust_misc_device", > + author: "Lee Jones", > + description: "Rust misc device sample", > + license: "GPL", > +} > + > +struct RustMiscDeviceModule { > + _miscdev: Pin>>, Why do we add examples where we ask people to allocate those structures with kmalloc()? `MiscDevice` should switch to the generic `Registration` type in [1] and use `InPlaceModule`, such that those structures land in the .data section of the binary. [1] https://lore.kernel.org/rust-for-linux/20241205141533.111830-3-dakr@kernel.org/ > +} > + > +impl kernel::Module for RustMiscDeviceModule { > + fn init(_module: &'static ThisModule) -> Result { > + pr_info!("Initialising Rust Misc Device Sample\n"); > + > + let options = MiscDeviceOptions { > + name: c_str!("rust-misc-device"), > + }; > + > + Ok(Self { > + _miscdev: KBox::pin_init( > + MiscDeviceRegistration::::register(options), > + GFP_KERNEL, > + )?, > + }) > + } > +} > + > +struct RustMiscDevice; > + > +#[vtable] > +impl MiscDevice for RustMiscDevice { > + type Ptr = KBox; > + > + fn open() -> Result> { > + pr_info!("Opening Rust Misc Device Sample\n"); > + > + Ok(KBox::new(RustMiscDevice, GFP_KERNEL)?) > + } > + > + fn ioctl( > + _device: ::Borrowed<'_>, > + cmd: u32, > + _arg: usize, > + ) -> Result { > + pr_info!("IOCTLing Rust Misc Device Sample\n"); > + > + match cmd { > + RUST_MISC_DEV_HELLO => pr_info!("Hello from the Rust Misc Device\n"), > + _ => { > + pr_err!("IOCTL not recognised: {}\n", cmd); > + return Err(ENOIOCTLCMD); > + } > + } > + > + Ok(0) > + } > +} > + > +impl Drop for RustMiscDevice { > + fn drop(&mut self) { > + pr_info!("Exiting the Rust Misc Device Sample\n"); > + } > +} > -- > 2.47.0.338.g60cca15819-goog > >