From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from bali.collaboradmins.com (bali.collaboradmins.com [148.251.105.195]) (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 EB4D928E0F; Mon, 11 Aug 2025 00:32:50 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=148.251.105.195 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1754872373; cv=none; b=GCW3wKJepBFKEfoi5NFllPy84iEs3E21TfSuR58gK5attrr/pqmncgXYFZFSQ/5JW85PZpPI8svyjF2z0ptQOEf2WqpIE//1E+i7QTI2qcw0lC3CIcLaYvDALk2Ag96lL+28BpK9WRQPISCPPpunbC/6ma9fygqI1IJYKJygWEU= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1754872373; c=relaxed/simple; bh=xinGwPx1i1IGtEmdvCcveKvE/eB3Ay3a/gxCQwxTsaM=; h=From:Subject:Date:Message-Id:MIME-Version:Content-Type:To:Cc; b=RpHk64jeT1yfRBs4EOc7P/cnUOclzF+pB2qBkLVczfqf9XJ8z2DOYcG32GbIT+m+UUoZ7uyM+NHIcAV4g/OnFXOSLfVzL18RRn6de032X2abcemDl7uGx1lJOj1mYBEEZAiSZaTQbi56u2fGweaZZWReVGxv02zw/3G+v0YF9SM= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=collabora.com; spf=pass smtp.mailfrom=collabora.com; dkim=pass (2048-bit key) header.d=collabora.com header.i=@collabora.com header.b=B5WFR/ma; arc=none smtp.client-ip=148.251.105.195 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=collabora.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=collabora.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=collabora.com header.i=@collabora.com header.b="B5WFR/ma" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1754872363; bh=xinGwPx1i1IGtEmdvCcveKvE/eB3Ay3a/gxCQwxTsaM=; h=From:Subject:Date:To:Cc:From; b=B5WFR/maMiKtKBTKHaTn//wUkdoPPgf65wymb2voCJ/cve+H8Q2oupDPEs9f8WYso GXPBRxruOc536tayMbhMViaL2hjOw6DtdJJVpBDp52BNy/m5ha9T6tr7bx5Y+fAbg3 2+epYwjzBnDsgyge+gJESZj+sJNs3MCEQ20wXoIDWYBCy+pM1skRRnd+9qPv18flKw /CaojjEarhn5lIwFjhgI+NW9Hzfgh/oSCfybTkvjWtGN6RaCmFJG/r0xdc7xfJO8W5 La6beivNJ/e1dmK89E+X0OXlVAq0fXlic66cFOCvlccH4+7ivbOBUoNhu2rwbH4PWF 0yQQL8CThONSg== Received: from [192.168.0.23] (unknown [IPv6:2804:14d:72b4:82f6:67c:16ff:fe57:b5a3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: dwlsalmeida) by bali.collaboradmins.com (Postfix) with ESMTPSA id 73C5017E0299; Mon, 11 Aug 2025 02:32:38 +0200 (CEST) From: Daniel Almeida Subject: [PATCH v8 0/6] rust: add support for request_irq Date: Sun, 10 Aug 2025 21:32:13 -0300 Message-Id: <20250810-topics-tyr-request_irq2-v8-0-8163f4c4c3a6@collabora.com> Precedence: bulk X-Mailing-List: rust-for-linux@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit X-B4-Tracking: v=1; b=H4sIAA06mWgC/3WNQQ6CMBBFr2JmbU2t1IIr72GIKWWQSZDCtBIJ4 e5WEpcu30v++wsEZMIAl90CjBMF8n2CfL8D19r+gYLqxKCk0tIclYh+IBdEnFkwji8M8U48KmH RIBZVrnOdQVoPjA29t/KtTNxSiJ7n7WgyX/tr6r/NyQgp6uxcONmcjJPm6nzX2cqzPTj/hHJd1 w8u5071wgAAAA== X-Change-ID: 20250712-topics-tyr-request_irq2-ae7ee9b85854 To: Miguel Ojeda , Alex Gaynor , Boqun Feng , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Andreas Hindborg , Alice Ryhl , Trevor Gross , Danilo Krummrich , Greg Kroah-Hartman , "Rafael J. Wysocki" , Thomas Gleixner , Bjorn Helgaas , =?utf-8?q?Krzysztof_Wilczy=C5=84ski?= , Benno Lossin Cc: linux-kernel@vger.kernel.org, rust-for-linux@vger.kernel.org, linux-pci@vger.kernel.org, Joel Fernandes , Dirk Behme , Daniel Almeida X-Mailer: b4 0.14.2 Changes in v8: - Rebased on top of v6.17-rc1 - Used Completion instead of Atomics in the examples for non-threaded IRQs (Boqun) - Take in "impl PinInit" instead of T in [Threaded]Registration::new() (Boqun) - Propagated the changes above to the platform/pci accessors. - Used a Mutex instead of Atomics in the examples for threaded IRQs. - Added more links in the docs as appropriate (Alice) - Re-exported irq::flags::Flags through a "pub use" (Alice). - Note: left the above as optional as it does not hurt to specify the full path anyway. As a result, no modules were made private. - Added #[doc(inline)] as appropriate to the re-exports (Boqun). - Formatted all the examples using nightly rustfmt + "format_code_in_doc_comments" - Fixed a few issues pointed out by make rustdoc - Merged imports (Alice) - Defaulted ThreadedIrqHandler::handle() to WakeThread (Danilo) - Added tags (thanks, Joel & Dirk!) - Link to v7: https://lore.kernel.org/r/20250715-topics-tyr-request_irq2-v7-0-d469c0f37c07@collabora.com Changes in v7: - Rebased on top of driver-core-next - Added Flags::new(), which is a const fn. This lets us use build_assert!() to verify the casts (hopefully this is what you meant, Alice?) - Changed the Flags inner type to take c_ulong directly, to minimize casts (Thanks, Alice) - Moved the flag constants into Impl Flags, instead of using a separate module (Alice) - Reverted to using #[repr(u32)] in Threaded/IrqReturn (Thanks Alice, Benno) - Fixed all instances where the full path was specified for types in the prelude (Alice) - Removed 'static from the CStr used to perform the lookup in the platform accessor (Alice) - Renamed the PCI accessors, as asked by Danilo - Added more docs to Flags, going into more detail on what they do and how to use them (Miguel) - Fixed the indentation in some of the docs (Alice) - Added Alice's r-b as appropriate - Link to v6: https://lore.kernel.org/rust-for-linux/20250703-topics-tyr-request_irq-v6-0-74103bdc7c52@collabora.com/ Changes in v6: - Fixed some typos in the docs (thanks, Dirk!) - Reordered the arguments for the accessors in platform.rs (Danilo) - Renamed handle_on_thread() to handle_threaded() (Danilo) - Changed the documentation for Handler and ThreadedHandler to what Danilo suggested - Link to v5: https://lore.kernel.org/r/20250627-topics-tyr-request_irq-v5-0-0545ee4dadf6@collabora.com Changes in v5: Thanks, Danilo { - Removed extra scope in the examples. - Renamed Registration::register() to Registration::new(), - Switched to try_pin_init! in Registration::new() (thanks for the code and the help, Boqun and Benno) - Renamed the trait functions to handle() and handle_on_thread(). - Introduced IrqRequest with an unsafe pub(crate) constructor - Made both register() and the accessors that return IrqRequest public the idea is to allow both of these to work: // `irq` is an `irq::Registration` let irq = pdev.threaded_irq_by_name()? and // `req` is an `IrqRequest`. let req = pdev.irq_by_name()?; // `irq` is an `irq::Registration` let irq = irq::ThreadedRegistration::new(req)?; - Added another name in the byname variants. There's now one for the request part and the other one to register() - Reworked the examples in request.rs - Implemented the irq accessors in place for pci.rs - Split the platform accessor macros into two } - Added a rust helper for pci_irq_vectors if !CONFIG_PCI_MSI (thanks, Intel 0day bot) - Link to v4: https://lore.kernel.org/r/20250608-topics-tyr-request_irq-v4-0-81cb81fb8073@collabora.com Changes in v4: Thanks, Benno { - Split series into more patches (see patches 1-4) - Use cast() where possible - Merge pub use statements. - Add {Threaded}IrqReturn::into_inner() instead of #[repr(u32)] - Used AtomicU32 instead of SpinLock to add interior mutability to the handler's data. SpinLockIrq did not land yet. - Mention that `&self` is !Unpin and was initialized using pin_init in drop() - Fix the docs slightly } - Add {try_}synchronize_irq(). - Use Devres for the irq registration (see RegistrationInner). This idea was suggested by Danilo and Alice. - Added PCI accessors (as asked by Joel Fernandez) - Fix a major oversight: we were passing in a pointer to Registration in register_{threaded}_irq() but casting it to Handler/ThreadedHandler in the callbacks. - Make register() pub(crate) so drivers can only retrieve registrations through device-specific accessors. This forbids drivers from trying to register an invalid irq. - I think this will still go through a few rounds, so I'll defer the patch to update MAINTAINERS for now. - Link to v3: https://lore.kernel.org/r/20250514-topics-tyr-request_irq-v3-0-d6fcc2591a88@collabora.com Changes in v3: - Rebased on driver-core-next - Added patch to get the irq numbers from a platform device (thanks, Christian!) - Split flags into its own file. - Change iff to "if and only if" - Implement PartialEq and Eq for Flags - Fix some broken docs/markdown - Reexport most things so users can elide ::request from the path - Add a blanket implementation of ThreadedHandler and Handler for Arc/Box that just forwards the call to the T. This lets us have Arc and Box as handlers if Foo: Handler. - Rework the examples a bit. - Remove "as _" casts in favor of "as u64" for flags. This is needed to cast the individual flags into u64. - Use #[repr(u32)] for ThreadedIrqReturn and IrqReturn. - Wrapped commit messages to < 75 characters - Link to v2: https://lore.kernel.org/r/20250122163932.46697-1-daniel.almeida@collabora.com Changes in v2: - Added Co-developed-by tag to account for the work that Alice did in order to figure out how to do this without Opaque (Thanks!) - Removed Opaque in favor of plain T - Fixed the examples - Made sure that the invariants sections are the last entry in the docs - Switched to slot.cast() where applicable, - Mentioned in the safety comments that we require that T: Sync, - Removed ThreadedFnReturn in favor of IrqReturn, - Improved the commit message Link to v1: https://lore.kernel.org/rust-for-linux/20241024-topic-panthor-rs-request_irq-v1-1-7cbc51c182ca@collabora.com/ --- Daniel Almeida (6): rust: irq: add irq module rust: irq: add flags module rust: irq: add support for non-threaded IRQs and handlers rust: irq: add support for threaded IRQs and handlers rust: platform: add irq accessors rust: pci: add irq accessors rust/bindings/bindings_helper.h | 1 + rust/helpers/helpers.c | 1 + rust/helpers/irq.c | 9 + rust/helpers/pci.c | 8 + rust/kernel/irq.rs | 26 +++ rust/kernel/irq/flags.rs | 124 ++++++++++ rust/kernel/irq/request.rs | 486 ++++++++++++++++++++++++++++++++++++++++ rust/kernel/lib.rs | 1 + rust/kernel/pci.rs | 45 +++- rust/kernel/platform.rs | 142 ++++++++++++ 10 files changed, 841 insertions(+), 2 deletions(-) --- base-commit: 8f5ae30d69d7543eee0d70083daf4de8fe15d585 change-id: 20250712-topics-tyr-request_irq2-ae7ee9b85854 Best regards, -- Daniel Almeida