From nobody Mon Jun 15 01:24:12 2026 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 AAD0E3A872B; Tue, 7 Apr 2026 10:38:02 +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=1775558282; cv=none; b=CROc+DVyI5yFyPM5oeZ/R3SHKcQznokN1E4hnoaNrD9YLWWlG8I+AgBmH8cY2Flooxf2qP/bj9/cQsoxIvBksgjXn+XjGEVJdHDtLg6PgwR6nZ/9Mn1G48Tx4k1fXRGwf4PjMF+beJN6l1ROAnD1b9rIgBSe5SULvILPFJEFnig= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775558282; c=relaxed/simple; bh=LQuTGRFuMGDvZhUjpEenEBzJ7iSFUxEEIm0vvNjcSrc=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=PvLQEkpYzecDrBN9JsQLucZI25MjHY57L7E4sYu2cPLYhHeGBJT1vVK8BueFScHQCDSaQNJVBUGsqUsYT4AuLTPrTUpNW9iowEw2Wzg9LvlxYyYwNk+pDEjb9lc8+raG9HTP9ifC8sWN2dBysElq986EcK1bLFUHLK4uoqtGI+M= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=mo27DZ7L; 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="mo27DZ7L" Received: by smtp.kernel.org (Postfix) with ESMTPS id 57AEAC2BCAF; Tue, 7 Apr 2026 10:38:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1775558282; bh=LQuTGRFuMGDvZhUjpEenEBzJ7iSFUxEEIm0vvNjcSrc=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=mo27DZ7LUJRy3kchDB12+n0zxwumSJYOrIQQ7Crfxc9X8+K1fL5egG+Sq++tHUSa2 6U5E/aMnS+OxW3QnbSWtyRrgDfggm/mEHuNTOMAChZsqguV0Wj3ES7GsaUhivmpSag 39rDkjvXSpa1UEsuByZIB/Pguats6eQTjwsr7yEBNzBVgAoccSiWLdzH2+9/7z+6fa CXhWuQmQXN88jkcFYuHzIli39vPfHNk9wG5db0L9KO7pWHTr1JDLmgFTfgOtNlDhva +YSdMt2nmXXLQs+Eo/yGPh/UbJ2v/0SXvpvf2bF6i/9CImcR4yQo2SXG6GnY3YG7H5 8oZhUTrTQZ2Mw== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 460F8EDB7F2; Tue, 7 Apr 2026 10:38:02 +0000 (UTC) From: Aakash Bollineni via B4 Relay Date: Tue, 07 Apr 2026 16:07:50 +0530 Subject: [PATCH v4 1/3] rust: helpers: add workqueue helpers 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="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260407-workqueue-v3-final-v4-1-c27da7e5f175@multicorewareinc.com> References: <20260407-workqueue-v3-final-v4-0-c27da7e5f175@multicorewareinc.com> In-Reply-To: <20260407-workqueue-v3-final-v4-0-c27da7e5f175@multicorewareinc.com> To: Miguel Ojeda , Alex Gaynor , Wedson Almeida Filho , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Alice Ryhl , Tejun Heo , Lai Jiangshan , Boqun Feng , Benno Lossin , Andreas Hindborg Cc: rust-for-linux@vger.kernel.org, linux-kernel@vger.kernel.org, Aakash Bollineni X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=ed25519-sha256; t=1775558278; l=2221; i=aakash.bollineni@multicorewareinc.com; s=20260402; h=from:subject:message-id; bh=TWgLPab5a3CzaBmRxYd/7ukOEqxyGwyfOaFPDSJ64gE=; b=zo4gPOq4vS0XvmtPiBtrRr47cvqZfr/jy8n+BMKHrWdz7Vd3vGX4+IrFVc6Z0G6cF/U8PY1kw R5HSl2Z/VZKA7g19CIzCKRo8yIV/ChITjZkZyPY7yah9WRP2M72rWHX X-Developer-Key: i=aakash.bollineni@multicorewareinc.com; a=ed25519; pk=r3Gonl+2k+8RozN9U/XwfICQdnRlAcLeeAfsExmurdE= X-Endpoint-Received: by B4 Relay for aakash.bollineni@multicorewareinc.com/20260402 with auth_id=711 X-Original-From: Aakash Bollineni Reply-To: aakash.bollineni@multicorewareinc.com From: Aakash Bollineni Add C-helpers to bridge the Rust workqueue abstraction with the kernel's C workqueue macros. These helpers wrap core workqueue functions that are either inline or macros in C, making them accessible to Rust FFI. New wrappers: - rust_helper_work_pending(): Wraps work_pending(). - rust_helper_cancel_work_sync(): Wraps cancel_work_sync(). - rust_helper_cancel_delayed_work_sync(): Wraps cancel_delayed_work_sync(). - rust_helper_init_delayed_work(): Performs robust initialization of a delayed_work structure, ensuring the correct timer function (delayed_work_timer_fn) and lockdep maps are initialized using standard kernel macros. These helpers are essential for supporting safe cancellation and correct DelayedWork lifecycle management in the Rust workqueue API. Signed-off-by: Aakash Bollineni --- rust/helpers/workqueue.c | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/rust/helpers/workqueue.c b/rust/helpers/workqueue.c index ce1c3a5b2150..85a6c0b9e4d5 100644 --- a/rust/helpers/workqueue.c +++ b/rust/helpers/workqueue.c @@ -14,3 +14,35 @@ __rust_helper void rust_helper_init_work_with_key(struct= work_struct *work, INIT_LIST_HEAD(&work->entry); work->func =3D func; } + +__rust_helper bool rust_helper_work_pending(struct work_struct *work) +{ + return work_pending(work); +} + +__rust_helper bool rust_helper_cancel_work_sync(struct work_struct *work) +{ + return cancel_work_sync(work); +} + +__rust_helper bool rust_helper_cancel_delayed_work_sync(struct delayed_wor= k *dwork) +{ + return cancel_delayed_work_sync(dwork); +} + +__rust_helper void rust_helper_init_delayed_work(struct delayed_work *dwor= k, + work_func_t func, + const char *name, + struct lock_class_key *key, + const char *tname, + struct lock_class_key *tkey) +{ + INIT_DELAYED_WORK(dwork, func); + lockdep_init_map(&dwork->work.lockdep_map, name, key, 0); + timer_init_key(&dwork->timer, dwork->timer.function, TIMER_IRQSAFE, tname= , tkey); +} + +__rust_helper void *rust_helper_get_dwork_timer_fn(void) +{ + return (void *)delayed_work_timer_fn; +} --=20 2.43.0 From nobody Mon Jun 15 01:24:12 2026 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 AAD933A8733; Tue, 7 Apr 2026 10:38:02 +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=1775558282; cv=none; b=R/VCNiySIau0Fb+i7Cg/RfJP2ljUyxpyJTeMg5FZ6Vf7Ly94FxXDP1u7T/wlLPlTyCY/o+AWA70pL1HFE+IsanwuqiIVpjma5Dq0RQRZt2RslxPAMPWWw7szSLAkJd5Tg1gLO+EFbpxGwywoXY5/vOPXWSWmG7bKZs2Xi0QQUTo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775558282; c=relaxed/simple; bh=73Ap8HpT5wQ0URFhCJ2NSMxYSz4/x4tBiWn0uJOPhRU=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=QWxS90L7v2wYjKWXdHS9qVXAa9HcVbO/bo0sdFtzFnJHgCfcaWppKzEqT72+IDQ6541u8ZVKZeqkLCk4OYPhNWiRmLV6NpSMBZZBWOHFOE+kw+GGjsy0i6/tqCuBTa3avE3gE/Wds+dJ0CchkH9Xir5wkM1uszV34SWfgDycb9U= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=KRPEccRP; 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="KRPEccRP" Received: by smtp.kernel.org (Postfix) with ESMTPS id 6D345C2BCB1; Tue, 7 Apr 2026 10:38:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1775558282; bh=73Ap8HpT5wQ0URFhCJ2NSMxYSz4/x4tBiWn0uJOPhRU=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=KRPEccRPHMoWx4oYgmmgz+CIsZ5AI7T2g9gpcz5LySNPM7jQ+uSLj1O1LzKL50Ohs qcR1gbfRsWsbsUD8QB1Or+CyN40cIQiNl9dStrQu75lvC+32/RODRQy7Fk0jN1phuH B7q8NR2uZML/TXylefrOwA0EnqkyEYsP5EiB0go5OJJxLiqIZTVfILdgxb4105qifo SmgesJUUoSqaK4mzHj9/GaOFzy4adh0xbuxVQkxhgQySyLm9AGV2Ps+UpdCGOxk/Av 3Uf292YcssB7FNDJHq0acmcX78PAVAPQUEWWo/nNaw0T2+WiA5E/cv7cJQn6W0heNm cJgXMfGYuoGag== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 5B763EDB7F4; Tue, 7 Apr 2026 10:38:02 +0000 (UTC) From: Aakash Bollineni via B4 Relay Date: Tue, 07 Apr 2026 16:07:51 +0530 Subject: [PATCH v4 2/3] rust: workqueue: add safe cancellation and status methods 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="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260407-workqueue-v3-final-v4-2-c27da7e5f175@multicorewareinc.com> References: <20260407-workqueue-v3-final-v4-0-c27da7e5f175@multicorewareinc.com> In-Reply-To: <20260407-workqueue-v3-final-v4-0-c27da7e5f175@multicorewareinc.com> To: Miguel Ojeda , Alex Gaynor , Wedson Almeida Filho , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Alice Ryhl , Tejun Heo , Lai Jiangshan , Boqun Feng , Benno Lossin , Andreas Hindborg Cc: rust-for-linux@vger.kernel.org, linux-kernel@vger.kernel.org, Aakash Bollineni X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=ed25519-sha256; t=1775558278; l=18687; i=aakash.bollineni@multicorewareinc.com; s=20260402; h=from:subject:message-id; bh=WSWED5bbLZL5zS2OHEwoyfXY5cHu6AZstK42St966aQ=; b=0YR7FAaZHSUCWG3zp1/uNh91Pca/hLHbTMOwEYDrwowV9/TPe9G8zefy2ODIRbwGl+MDI3Bs0 4pHF+cyR5QwBUu67P9/SYNgv7xU0vtEylr+EiBJTDznD1XOlUtDBldq X-Developer-Key: i=aakash.bollineni@multicorewareinc.com; a=ed25519; pk=r3Gonl+2k+8RozN9U/XwfICQdnRlAcLeeAfsExmurdE= X-Endpoint-Received: by B4 Relay for aakash.bollineni@multicorewareinc.com/20260402 with auth_id=711 X-Original-From: Aakash Bollineni Reply-To: aakash.bollineni@multicorewareinc.com From: Aakash Bollineni Modernize the Rust workqueue by adding methods for status checking and cancellation of work and delayed work items. Specifically, this patch adds: - is_pending(): Returns true if the work item is currently enqueued. - cancel(): Attempts to cancel the work item before it runs. - cancel_sync(): Synchronously cancels the work item, waiting for it to finish if it's already running. Reclaims ownership if the work was pending. Signed-off-by: Aakash Bollineni --- rust/kernel/workqueue.rs | 333 ++++++++++++++++++++++++++++++++++++++++++-= ---- 1 file changed, 298 insertions(+), 35 deletions(-) diff --git a/rust/kernel/workqueue.rs b/rust/kernel/workqueue.rs index 706e833e9702..94a52c278776 100644 --- a/rust/kernel/workqueue.rs +++ b/rust/kernel/workqueue.rs @@ -448,8 +448,26 @@ pub unsafe trait WorkItemPointer: RawWo= rkItem { /// The provided `work_struct` pointer must originate from a previous = call to [`__enqueue`] /// where the `queue_work_on` closure returned true, and the pointer m= ust still be valid. /// + /// The implementation must ensure that the pointer is reclaimed (e.g.= , via `from_raw`) + /// before calling the `run` method of the underlying [`WorkItem`]. + /// /// [`__enqueue`]: RawWorkItem::__enqueue unsafe extern "C" fn run(ptr: *mut bindings::work_struct); + + /// Reclaims ownership of the pointer from the work item. + /// + /// This is called when a work item is successfully cancelled, allowin= g the caller + /// to recover the original pointer (e.g., `Arc` or `KBox`) that was "= leaked" + /// during enqueuing. + /// + /// # Safety + /// + /// The provided `work_struct` pointer must originate from a previous = call to [`__enqueue`] + /// where the `queue_work_on` closure returned true, and the work item= must have been + /// successfully cancelled (i.e., `cancel_work` returned true). + /// + /// [`__enqueue`]: RawWorkItem::__enqueue + unsafe fn reclaim(ptr: *mut bindings::work_struct) -> Self; } =20 /// Defines the method that should be called when this work item is execut= ed. @@ -516,6 +534,156 @@ pub fn new(name: &'static CStr, key: Pin<&'static Loc= kClassKey>) -> impl PinInit }) } =20 + /// Returns whether the work item is currently pending. + /// + /// # Warning + /// + /// This method is inherently racy. A work item can be enqueued or sta= rt running + /// immediately after this check returns. Do not rely on this for corr= ectness + /// logic (e.g., as a guard for unsafe operations); use it only for de= bugging or + /// non-critical status reporting. + /// + /// # Examples + /// + /// ``` + /// # use kernel::workqueue::{self, new_work, Work, WorkItem, HasWork}; + /// # use kernel::impl_has_work; + /// # use kernel::sync::Arc; + /// # #[pin_data] + /// # struct MyStruct { #[pin] work: Work } + /// # impl_has_work! { impl HasWork for MyStruct { self.work } } + /// # impl WorkItem for MyStruct { + /// # type Pointer =3D Arc; + /// # fn run(_this: Arc) {} + /// # } + /// let my_struct =3D Arc::pin_init(pin_init!(MyStruct { + /// work <- new_work!("MyStruct::work"), + /// }), kernel::alloc::flags::GFP_KERNEL).unwrap(); + /// assert!(!my_struct.work.is_pending()); + /// workqueue::system().enqueue(my_struct.clone()); + /// assert!(my_struct.work.is_pending()); + /// # let _ =3D my_struct.work.cancel(); + /// ``` + #[inline] + pub fn is_pending(&self) -> bool { + // SAFETY: `self.work` is a valid pointer to a `work_struct`. + unsafe { bindings::work_pending(self.work.get()) } + } + + /// Cancels the work item. + /// + /// If the work item was successfully cancelled (i.e., it was pending = and had not yet + /// started running), the original pointer is reclaimed and returned. + /// + /// # Guarantees + /// + /// This method is non-blocking and may return while the work item is = still running + /// on another CPU. If it returns `None`, the work item might be about= to start, + /// is currently running, or has already finished. + /// + /// # Safety + /// + /// This is safe because ownership is only reclaimed if the kernel con= firms (via + /// `cancel_work` returning true) that the work item is no longer in a= ny queue and + /// will not be executed by the workqueue for this specific enqueue ev= ent. + /// + /// [`cancel_sync`]: Work::cancel_sync + /// + /// # Examples + /// + /// ``` + /// # use kernel::workqueue::{self, new_work, Work, WorkItem, HasWork}; + /// # use kernel::impl_has_work; + /// # use kernel::sync::Arc; + /// # #[pin_data] + /// # struct MyStruct { #[pin] work: Work } + /// # impl_has_work! { impl HasWork for MyStruct { self.work } } + /// # impl WorkItem for MyStruct { + /// # type Pointer =3D Arc; + /// # fn run(_this: Arc) {} + /// # } + /// let my_struct =3D Arc::pin_init(pin_init!(MyStruct { + /// work <- new_work!("MyStruct::work"), + /// }), kernel::alloc::flags::GFP_KERNEL).unwrap(); + /// workqueue::system().enqueue(my_struct.clone()); + /// assert!(my_struct.work.is_pending()); + /// let reclaimed =3D my_struct.work.cancel(); + /// assert!(reclaimed.is_some()); + /// assert!(!my_struct.work.is_pending()); + /// ``` + pub fn cancel(&self) -> Option + where + T: WorkItem, + { + let work_ptr =3D self.work.get(); + // SAFETY: `work_ptr` is a valid pointer to a `work_struct`. + if unsafe { bindings::cancel_work(work_ptr) } { + // SAFETY: The work item was successfully cancelled and is gua= ranteed not to run, + // so we can safely reclaim the ownership leaked during `enque= ue`. + Some(unsafe { T::Pointer::reclaim(work_ptr) }) + } else { + None + } + } + + /// Synchronously cancels the work item. + /// + /// This method waits for the work item to finish if it is currently r= unning. + /// If the work item was successfully cancelled from the queue, the po= inter is + /// reclaimed and returned. + /// + /// # Guarantees + /// + /// After this method returns, the work item is guaranteed to be: + /// - Not pending in any queue. + /// - Not running on any CPU. + /// + /// This makes it safe to use during teardown (e.g., driver `remove` o= r object `drop`) + /// to ensure no background tasks are accessing resources that are abo= ut to be freed. + /// + /// # Safety + /// + /// Same as [`cancel`], it only reclaims ownership if the kernel confi= rms the work + /// was still pending and is now removed. + /// + /// [`cancel`]: Work::cancel + /// + /// # Examples + /// + /// ``` + /// # use kernel::workqueue::{self, new_work, Work, WorkItem, HasWork}; + /// # use kernel::impl_has_work; + /// # use kernel::sync::Arc; + /// # #[pin_data] + /// # struct MyStruct { #[pin] work: Work } + /// # impl_has_work! { impl HasWork for MyStruct { self.work } } + /// # impl WorkItem for MyStruct { + /// # type Pointer =3D Arc; + /// # fn run(_this: Arc) {} + /// # } + /// let my_struct =3D Arc::pin_init(pin_init!(MyStruct { + /// work <- new_work!("MyStruct::work"), + /// }), kernel::alloc::flags::GFP_KERNEL).unwrap(); + /// workqueue::system().enqueue(my_struct.clone()); + /// let reclaimed =3D my_struct.work.cancel_sync(); + /// assert!(reclaimed.is_some()); + /// ``` + pub fn cancel_sync(&self) -> Option + where + T: WorkItem, + { + let work_ptr =3D self.work.get(); + // SAFETY: `work_ptr` is a valid pointer to a `work_struct`. + if unsafe { bindings::cancel_work_sync(work_ptr) } { + // SAFETY: The work item was successfully cancelled/waited for= , and is guaranteed + // not to run again unless re-enqueued. We reclaim the ownersh= ip leaked during + // `enqueue`. + Some(unsafe { T::Pointer::reclaim(work_ptr) }) + } else { + None + } + } + /// Get a pointer to the inner `work_struct`. /// /// # Safety @@ -674,25 +842,14 @@ pub fn new( pin_init!(Self { dwork <- Opaque::ffi_init(|slot: *mut bindings::delayed_work| { // SAFETY: The `WorkItemPointer` implementation promises t= hat `run` can be used as - // the work item function. + // the work item function. We use the C-helper to ensure t= he timer function + // and data are initialized correctly according to kernel = macros. unsafe { - bindings::init_work_with_key( - core::ptr::addr_of_mut!((*slot).work), + bindings::init_delayed_work( + slot, Some(T::Pointer::run), - false, work_name.as_char_ptr(), work_key.as_ptr(), - ) - } - - // SAFETY: The `delayed_work_timer_fn` function pointer ca= n be used here because - // the timer is embedded in a `struct delayed_work`, and o= nly ever scheduled via - // the core workqueue code, and configured to run in irqsa= fe context. - unsafe { - bindings::timer_init_key( - core::ptr::addr_of_mut!((*slot).timer), - Some(bindings::delayed_work_timer_fn), - bindings::TIMER_IRQSAFE, timer_name.as_char_ptr(), timer_key.as_ptr(), ) @@ -702,6 +859,89 @@ pub fn new( }) } =20 + /// Returns whether the work item is currently pending. + /// + /// # Warning + /// + /// This method is inherently racy. See [`Work::is_pending`]. + /// + /// # Examples + /// + /// See [`Work::is_pending`]. + /// + /// [`Work::is_pending`]: Work::is_pending + #[inline] + pub fn is_pending(&self) -> bool { + // SAFETY: `self.dwork` is reaching into a valid Opaque. + unsafe { + let ptr: *mut bindings::delayed_work =3D self.dwork.get(); + bindings::work_pending(core::ptr::addr_of_mut!((*ptr).work)) + } + } + + /// Cancels the delayed work item. + /// + /// If the work item was successfully cancelled (i.e., it was pending = and had not yet + /// started running), the original pointer is reclaimed and returned. + /// + /// # Guarantees + /// + /// See [`Work::cancel`]. + /// + /// # Safety + /// + /// Same as [`Work::cancel`]. + /// + /// [`cancel_sync`]: DelayedWork::cancel_sync + /// [`Work::cancel`]: Work::cancel + /// + /// # Examples + /// + /// See [`Work::cancel`]. + pub fn cancel(&self) -> Option + where + T: WorkItem, + { + let dwork_ptr =3D self.dwork.get(); + // SAFETY: `dwork_ptr` is a valid pointer to a `delayed_work`. + if unsafe { bindings::cancel_delayed_work(dwork_ptr) } { + // SAFETY: The work item was successfully cancelled and is gua= ranteed not to run, + // so we can safely reclaim the ownership leaked during `enque= ue`. + Some(unsafe { T::Pointer::reclaim(core::ptr::addr_of_mut!((*dw= ork_ptr).work)) }) + } else { + None + } + } + + /// Synchronously cancels the delayed work item. + /// + /// This method waits for the work item to finish if it is currently r= unning. + /// If the work item was successfully cancelled from the queue, the po= inter is + /// reclaimed and returned. + /// + /// # Guarantees + /// + /// See [`Work::cancel_sync`]. + /// + /// # Safety + /// + /// Same as [`Work::cancel_sync`]. + pub fn cancel_sync(&self) -> Option + where + T: WorkItem, + { + let dwork_ptr =3D self.dwork.get(); + // SAFETY: `dwork_ptr` is a valid pointer to a `delayed_work`. + if unsafe { bindings::cancel_delayed_work_sync(dwork_ptr) } { + // SAFETY: The work item was successfully cancelled/waited for= , and is guaranteed + // not to run again unless re-enqueued. We reclaim the ownersh= ip leaked during + // `enqueue`. + Some(unsafe { T::Pointer::reclaim(core::ptr::addr_of_mut!((*dw= ork_ptr).work)) }) + } else { + None + } + } + /// Get a pointer to the inner `delayed_work`. /// /// # Safety @@ -781,22 +1021,11 @@ unsafe fn raw_get_work( unsafe fn work_container_of( ptr: *mut $crate::workqueue::Work<$work_type $(, $id)?>, ) -> *mut Self { - // SAFETY: The caller promises that the pointer points at = a field of the right type - // in the right kind of struct. - let ptr =3D unsafe { $crate::workqueue::Work::raw_get(ptr)= }; - - // SAFETY: The caller promises that the pointer points at = a field of the right type - // in the right kind of struct. - let delayed_work =3D unsafe { - $crate::container_of!(ptr, $crate::bindings::delayed_w= ork, work) - }; - - let delayed_work: *mut $crate::workqueue::DelayedWork<$wor= k_type $(, $id)?> =3D - delayed_work.cast(); - - // SAFETY: The caller promises that the pointer points at = a field of the right type - // in the right kind of struct. - unsafe { $crate::container_of!(delayed_work, Self, $field)= } + // SAFETY: The caller promises that the pointer points at = the `work` field + // of a `delayed_work` struct, which is itself the `dwork`= field of a + // `DelayedWork` wrapper, which is the `$field` field of a= `Self` struct. + let ptr =3D ptr.cast::<$crate::workqueue::DelayedWork<$wor= k_type $(, $id)?>>(); + unsafe { $crate::container_of!(ptr, Self, $field) } } } )*}; @@ -827,6 +1056,15 @@ unsafe impl WorkItemPointer for= Arc =20 T::run(arc) } + + unsafe fn reclaim(ptr: *mut bindings::work_struct) -> Self { + // The `__enqueue` method always uses a `work_struct` stored in a = `Work`. + let ptr =3D ptr.cast::>(); + // SAFETY: This computes the pointer that `__enqueue` got from `Ar= c::into_raw`. + let ptr =3D unsafe { T::work_container_of(ptr) }; + // SAFETY: This pointer comes from `Arc::into_raw` and we've been = given back ownership. + unsafe { Arc::from_raw(ptr) } + } } =20 // SAFETY: The `work_struct` raw pointer is guaranteed to be valid for the= duration of the call to @@ -874,7 +1112,8 @@ unsafe impl RawDelayedWorkItem f= or Arc { } =20 -// SAFETY: TODO. +// SAFETY: The `WorkItemPointer` implementation for `Pin>` is safe= because `KBox::from_raw` +// correctly reconstructs the box that was leaked during `enqueue` (via `K= Box::into_raw`). unsafe impl WorkItemPointer for Pin> where T: WorkItem, @@ -883,18 +1122,35 @@ unsafe impl WorkItemPointer fo= r Pin> unsafe extern "C" fn run(ptr: *mut bindings::work_struct) { // The `__enqueue` method always uses a `work_struct` stored in a = `Work`. let ptr =3D ptr.cast::>(); - // SAFETY: This computes the pointer that `__enqueue` got from `Ar= c::into_raw`. + // SAFETY: This computes the pointer that `__enqueue` got from `KB= ox::into_raw`. let ptr =3D unsafe { T::work_container_of(ptr) }; - // SAFETY: This pointer comes from `Arc::into_raw` and we've been = given back ownership. + // SAFETY: This pointer comes from `KBox::into_raw` and we've been= given back ownership. let boxed =3D unsafe { KBox::from_raw(ptr) }; // SAFETY: The box was already pinned when it was enqueued. let pinned =3D unsafe { Pin::new_unchecked(boxed) }; =20 T::run(pinned) } + + unsafe fn reclaim(ptr: *mut bindings::work_struct) -> Self { + // The `__enqueue` method always uses a `work_struct` stored in a = `Work`. + let ptr =3D ptr.cast::>(); + // SAFETY: This computes the pointer that `__enqueue` got from `KB= ox::into_raw`. + let ptr =3D unsafe { T::work_container_of(ptr) }; + // SAFETY: This pointer comes from `KBox::into_raw` and we've been= given back ownership. + let boxed =3D unsafe { KBox::from_raw(ptr) }; + // SAFETY: The box was already pinned when it was enqueued. + unsafe { Pin::new_unchecked(boxed) } + } } =20 -// SAFETY: TODO. +// SAFETY: The `work_struct` raw pointer is guaranteed to be valid for the= duration of the call to +// the closure because we have exclusive ownership of the `KBox`, and we d= on't drop it ourselves. +// If `queue_work_on` returns true, it is further guaranteed to be valid u= ntil a call to the +// function pointer in `work_struct` because we leak the memory it points = to, and only reclaim it +// if the closure returns false (not reachable for KBox as it must succeed= ) or in +// `WorkItemPointer::run`, which is what the function pointer in the `work= _struct` must be +// pointing to. unsafe impl RawWorkItem for Pin> where T: WorkItem, @@ -1022,3 +1278,10 @@ pub fn system_bh_highpri() -> &'static Queue { // SAFETY: `system_bh_highpri_wq` is a C global, always available. unsafe { Queue::from_raw(bindings::system_bh_highpri_wq) } } + +/// Returns the strong count of an [`Arc`] for testing purposes. +/// +/// # Safety +/// +/// This is intended for use in KUnit tests and sample modules ONLY. +#[cfg(CONFIG_KUNIT)] --=20 2.43.0 From nobody Mon Jun 15 01:24:12 2026 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 AABC43A7F46; Tue, 7 Apr 2026 10:38:02 +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=1775558282; cv=none; b=T9govRjFdBNVHvTqsEpGDMb90+7UScpsGiKOn7tW1OlNydIqC0OPHyegKzIM15dOZb+WPmWFjX6nPKa5sE3l0hGEn0nStMkvPwRavu9zxMeJSK3yz2oFf1v57Pf1dDftH27CkY8uN10kaobVd72xo7LQlbiH0+6YFELpW6/KV6s= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775558282; c=relaxed/simple; bh=/9k+6onDDMDi3QEezO5k7YfJTT5rkI3BeapXVLByvbc=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=Ovl8Plt6KLnfnk1bN9xUXOfNHFdE+GR+Fr3bnAM9YVFpeBa6zJV7TA8JsRyUgNVNhPVlKkNA5LrzG/vBE+0/rXdbvpArBLn8JIEcxAyDY7H5Suodmz/fouOCTcECsLnIaWmfs7uCUKpe3fwe/L2vO7jLqWdeZvuri4L1CJpvABw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=M1yEouAh; 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="M1yEouAh" Received: by smtp.kernel.org (Postfix) with ESMTPS id 7EDA8C2BCB2; Tue, 7 Apr 2026 10:38:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1775558282; bh=/9k+6onDDMDi3QEezO5k7YfJTT5rkI3BeapXVLByvbc=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=M1yEouAhjA+SWj0nxmqtk7Pk72phogBMLCT4fC1F158bMMXCMToR6JGIWxRe6c/9Q hiULoh0U+hBue7+FV+OThchxgK6SSFJI63XLIofItrl2+tAqz6iNJcxDI9S16L1j/y Lg7zHoMHR8NfJK36rEGyVAXQu45ybRT5fCoX6pllE4cobp0sTtWoMDWdbJVVoohlXo 2GqquUy909CFIYxc86phF5MgpZkWbYdyxdgaeZvetRwAHPV3HTXHUd742TpIWW0VEI 1nH5pjHxLN6bP1ALQQHE5tUgLRjfoqQNy51lr3RKY7vCXIatWqsqy7h2gse6zUA61X CvZ9a4yYvujew== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 72B42EDB7F6; Tue, 7 Apr 2026 10:38:02 +0000 (UTC) From: Aakash Bollineni via B4 Relay Date: Tue, 07 Apr 2026 16:07:52 +0530 Subject: [PATCH v4 3/3] rust: workqueue: add KUnit and sample stress tests 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="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260407-workqueue-v3-final-v4-3-c27da7e5f175@multicorewareinc.com> References: <20260407-workqueue-v3-final-v4-0-c27da7e5f175@multicorewareinc.com> In-Reply-To: <20260407-workqueue-v3-final-v4-0-c27da7e5f175@multicorewareinc.com> To: Miguel Ojeda , Alex Gaynor , Wedson Almeida Filho , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Alice Ryhl , Tejun Heo , Lai Jiangshan , Boqun Feng , Benno Lossin , Andreas Hindborg Cc: rust-for-linux@vger.kernel.org, linux-kernel@vger.kernel.org, Aakash Bollineni , kernel test robot X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=ed25519-sha256; t=1775558278; l=12592; i=aakash.bollineni@multicorewareinc.com; s=20260402; h=from:subject:message-id; bh=8AEmcEeh6WDrhhTL0z1p/9bqh2sG1YHRoh3/Ue89E7o=; b=hfW3jgvTSqnu0LXdRoD07zFZ5b+SCWL3VFTef14RBwRJ5rj8/Al9q/fZi8c3gpv6G8ws/uF+p 04FhAXkaxcdBWd70dNwkwKuPsOTB6rmgKYi3C8zO5lx7aT75iLArV5w X-Developer-Key: i=aakash.bollineni@multicorewareinc.com; a=ed25519; pk=r3Gonl+2k+8RozN9U/XwfICQdnRlAcLeeAfsExmurdE= X-Endpoint-Received: by B4 Relay for aakash.bollineni@multicorewareinc.com/20260402 with auth_id=711 X-Original-From: Aakash Bollineni Reply-To: aakash.bollineni@multicorewareinc.com From: Aakash Bollineni To ensure the safety and correctness of the improved workqueue API, this patch adds comprehensive testing infrastructure: 1. KUnit Tests: Adds an internal 'rust_kernel_workqueue' test suite to rust/kernel/workqueue.rs. 2. Sample Module: Updates samples/rust/rust_workqueue_test.rs for stress verification. Reported-by: kernel test robot Closes: https://lore.kernel.org/oe-kbuild-all/202604071427.209bk.JHO@intel.= com/ v4: Fixed rustfmt and build errors in samples/rust/rust_workqueue_test.rs. Signed-off-by: Aakash Bollineni --- rust/kernel/workqueue.rs | 130 ++++++++++++++++++++++++ samples/rust/Kconfig | 10 ++ samples/rust/Makefile | 2 + samples/rust/rust_workqueue_test.rs | 192 ++++++++++++++++++++++++++++++++= ++++ 4 files changed, 334 insertions(+) diff --git a/rust/kernel/workqueue.rs b/rust/kernel/workqueue.rs index 94a52c278776..d25e0fa9d44c 100644 --- a/rust/kernel/workqueue.rs +++ b/rust/kernel/workqueue.rs @@ -1285,3 +1285,133 @@ pub fn system_bh_highpri() -> &'static Queue { /// /// This is intended for use in KUnit tests and sample modules ONLY. #[cfg(CONFIG_KUNIT)] + +#[macros::kunit_tests(rust_kernel_workqueue)] +mod tests { + use super::*; + use crate::sync::Arc; + + #[pin_data] + struct TestWorkItem { + #[pin] + work: Work, + value: i32, + } + + impl_has_work! { + impl HasWork for TestWorkItem { self.work } + } + + impl WorkItem for TestWorkItem { + type Pointer =3D Arc; + fn run(_this: Arc) {} + } + + #[pin_data] + struct TestDelayedWorkItem { + #[pin] + delayed_work: DelayedWork, + value: i32, + } + + impl_has_delayed_work! { + impl HasDelayedWork for TestDelayedWorkItem { self.delayed_w= ork } + } + + impl WorkItem for TestDelayedWorkItem { + type Pointer =3D Arc; + fn run(_this: Arc) {} + } + + #[test] + fn test_work_cancel_reclaim() { + let item =3D Arc::pin_init( + pin_init!(TestWorkItem { + work <- new_work!("TestWorkItem::work"), + value: 42, + }), + GFP_KERNEL, + ) + .expect("Failed to allocate TestWorkItem"); + + let initial_count =3D arc_count(&item); + + // Enqueue + let _ =3D system().enqueue(item.clone()); + + // Cancel and Reclaim (if it was pending) + if let Some(reclaimed) =3D item.work.cancel() { + assert!(arc_count(&item) =3D=3D initial_count + 1); + drop(reclaimed); + assert!(arc_count(&item) =3D=3D initial_count); + } + } + + #[test] + fn test_work_cancel_sync_reclaim() { + let item =3D Arc::pin_init( + pin_init!(TestWorkItem { + work <- new_work!("TestWorkItem::work"), + value: 42, + }), + GFP_KERNEL, + ) + .expect("Failed to allocate TestWorkItem"); + + let initial_count =3D arc_count(&item); + + // Enqueue + let _ =3D system().enqueue(item.clone()); + + // Cancel Sync and Reclaim + if let Some(reclaimed) =3D item.work.cancel_sync() { + assert!(arc_count(&item) =3D=3D initial_count + 1); + drop(reclaimed); + assert!(arc_count(&item) =3D=3D initial_count); + } + } + + #[test] + fn test_work_stress_enqueue_cancel() { + let item =3D Arc::pin_init( + pin_init!(TestWorkItem { + work <- new_work!("TestWorkItem::work"), + value: 42, + }), + GFP_KERNEL, + ) + .expect("Failed to allocate TestWorkItem"); + + for _ in 0..100 { + if let Ok(_) =3D system().enqueue(item.clone()) { + let _ =3D item.work.cancel_sync(); + } + } + + assert_eq!(arc_count(&item), 1); + } + + #[test] + fn test_delayed_work_cancel_reclaim() { + let item =3D Arc::pin_init( + pin_init!(TestDelayedWorkItem { + delayed_work <- new_delayed_work!("TestDelayedWorkItem::de= layed_work"), + value: 42, + }), + GFP_KERNEL, + ) + .expect("Failed to allocate TestDelayedWorkItem"); + + let initial_count =3D arc_count(&item); + + // Enqueue delayed (use a longer delay to ensure it stays pending) + let _ =3D system().enqueue_delayed(item.clone(), 1000); + + // Cancel and Reclaim + if let Some(reclaimed) =3D item.delayed_work.cancel() { + assert!(arc_count(&item) =3D=3D initial_count + 1); + drop(reclaimed); + assert!(arc_count(&item) =3D=3D initial_count); + } + } +} diff --git a/samples/rust/Kconfig b/samples/rust/Kconfig index c49ab9106345..b3f078f77ca2 100644 --- a/samples/rust/Kconfig +++ b/samples/rust/Kconfig @@ -172,6 +172,16 @@ config SAMPLE_RUST_SOC =20 If unsure, say N. =20 +config SAMPLE_RUST_WORKQUEUE + tristate "Workqueue" + help + This option builds the Rust workqueue robust stress test sample. + + To compile this as a module, choose M here: + the module will be called rust_workqueue_test. + + If unsure, say N. + config SAMPLE_RUST_HOSTPROGS bool "Host programs" help diff --git a/samples/rust/Makefile b/samples/rust/Makefile index 6c0aaa58cccc..261aa67b6502 100644 --- a/samples/rust/Makefile +++ b/samples/rust/Makefile @@ -20,3 +20,5 @@ obj-$(CONFIG_SAMPLE_RUST_SOC) +=3D rust_soc.o rust_print-y :=3D rust_print_main.o rust_print_events.o =20 subdir-$(CONFIG_SAMPLE_RUST_HOSTPROGS) +=3D hostprogs + +obj-$(CONFIG_SAMPLE_RUST_WORKQUEUE) +=3D rust_workqueue_test.o diff --git a/samples/rust/rust_workqueue_test.rs b/samples/rust/rust_workqu= eue_test.rs new file mode 100644 index 000000000000..e21296fdb34d --- /dev/null +++ b/samples/rust/rust_workqueue_test.rs @@ -0,0 +1,192 @@ +// SPDX-License-Identifier: GPL-2.0 + +//! Robust stress test for Rust workqueue API. + +use kernel::prelude::*; +use kernel::sync::Arc; +use kernel::time::msecs_to_jiffies; +use kernel::workqueue::{self, new_work, Work, WorkItem}; + +#[pin_data] +struct TestWorkItem { + #[pin] + work: Work, + value: i32, +} + +kernel::impl_has_work! { + impl HasWork for TestWorkItem { self.work } +} + +impl WorkItem for TestWorkItem { + type Pointer =3D Arc; + + fn run(this: Arc) { + pr_info!( + "Rust workqueue test: Work item running (value: {})\n", + this.value + ); + } +} + +#[pin_data] +struct TestDelayedWorkItem { + #[pin] + delayed_work: workqueue::DelayedWork, + value: i32, +} + +// SAFETY: The `delayed_work` field is at a fixed offset and is valid for = the lifetime of +// `TestDelayedWorkItem`. +unsafe impl workqueue::HasDelayedWork for TestDelayedWorkItem {} + +impl WorkItem for TestDelayedWorkItem { + type Pointer =3D Arc; + + fn run(this: Arc) { + pr_info!( + "Rust workqueue test: Delayed work item running (value: {})\n", + this.value + ); + } +} + +struct RustWorkqueueTest; + +impl kernel::Module for RustWorkqueueTest { + fn init(_module: &'static ThisModule) -> Result { + pr_info!("Rust workqueue test: starting robust verification (v4)\n= "); + + // 1. Basic Lifecycle with Refcount Validation (Standard Work) + { + let work_item =3D Arc::pin_init( + pin_init!(TestWorkItem { + work <- new_work!("TestWorkItem::work"), + value: 42, + }), + GFP_KERNEL, + )?; + + let initial_count =3D workqueue::arc_count(&work_item); + pr_info!("Initial Arc strong count: {}\n", initial_count); + + // Enqueue + let enqueued_item =3D work_item.clone(); + + if let Err(returned_item) =3D workqueue::system().enqueue(enqu= eued_item) { + pr_warn!("Work already pending, unexpected!\n"); + let _ =3D returned_item; + } else { + pr_info!( + "Work enqueued successfully. Strong count: {}\n", + workqueue::arc_count(&work_item) + ); + } + + // Cancel immediately + if let Some(reclaimed) =3D work_item.work.cancel() { + let count_after_cancel =3D workqueue::arc_count(&work_item= ); + pr_info!( + "Success: Work cancelled and Arc reclaimed. Strong cou= nt: {}\n", + count_after_cancel + ); + + if count_after_cancel !=3D initial_count + 1 { + pr_err!( + "ERROR: Refcount mismatch after cancel! Expected {= }, got {}\n", + initial_count + 1, + count_after_cancel + ); + return Err(ENXIO); + } + drop(reclaimed); + if workqueue::arc_count(&work_item) !=3D initial_count { + pr_err!("ERROR: Refcount mismatch after drop!\n"); + return Err(ENXIO); + } + } else { + pr_info!("Work already running or finished.\n"); + } + } + + // 2. Stress Testing: Enqueue/Cancel Sync Loop + { + pr_info!("Starting stress test (1000 iterations)...\n"); + let work_item =3D Arc::pin_init( + pin_init!(TestWorkItem { + work <- new_work!("TestWorkItem::work"), + value: 99, + }), + GFP_KERNEL, + )?; + + for i in 0..1000 { + let _ =3D workqueue::system().enqueue(work_item.clone()); + let _ =3D work_item.work.cancel_sync(); + if i % 250 =3D=3D 0 { + pr_info!("Stress test progress: {}/1000\n", i); + } + } + + if workqueue::arc_count(&work_item) !=3D 1 { + pr_err!("ERROR: Refcount leak detected after stress test!\= n"); + return Err(ENXIO); + } else { + pr_info!("Stress test completed successfully.\n"); + } + } + + // 3. Delayed Work Cancellation Test + { + let delayed_item =3D Arc::pin_init( + pin_init!(TestDelayedWorkItem { + delayed_work <- + workqueue::new_delayed_work!("TestDelayedWorkItem::del= ayed_work"), + value: 7, + }), + GFP_KERNEL, + )?; + + let initial_count =3D workqueue::arc_count(&delayed_item); + + // Schedule with a long delay (5 seconds) + if let Err(returned) =3D + workqueue::system().enqueue_delayed(delayed_item.clone(), = msecs_to_jiffies(5000)) + { + drop(returned); + } else { + pr_info!( + "Delayed work enqueued. count: {}\n", + workqueue::arc_count(&delayed_item) + ); + } + + if let Some(reclaimed) =3D delayed_item.delayed_work.cancel() { + pr_info!("Success: Delayed work reclaimed. No leak.\n"); + drop(reclaimed); + } + + if workqueue::arc_count(&delayed_item) !=3D initial_count { + pr_err!("ERROR: Refcount leak after delayed cancel!\n"); + return Err(ENXIO); + } + } + + pr_info!("Rust workqueue test: all robust checks passed\n"); + Ok(RustWorkqueueTest) + } +} + +impl Drop for RustWorkqueueTest { + fn drop(&mut self) { + pr_info!("Rust workqueue test: exit\n"); + } +} + +module! { + type: RustWorkqueueTest, + name: "rust_workqueue_test", + authors: ["Aakash Bollineni"], + description: "Robust stress test for Rust workqueue API", + license: "GPL", +} --=20 2.43.0