From nobody Tue Apr 7 15:27:33 2026 Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.15]) (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 A2FC52D0C92 for ; Thu, 26 Feb 2026 10:49:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.175.65.15 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772102956; cv=none; b=U0HsIm2MOCJ+RXsS9hErnsYYRpgDO8w9Lh0sxxGwQCpWenWjrxA5t8d7u4xxZnTkvcplNDggfGcbXz94qR16LeDEUSItqEOk84j+EyQaCPlnlw0VNkzSAb/mkHQYkb+VZ+4aODwY2LDL2+Zj3xh1BlTdnKf8jE2h5ZVNCsXXGJg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772102956; c=relaxed/simple; bh=EjllPe2xOg6gemOtYgaAWfieX1fzQTiRvmoL4VG/II0=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=R5wulQ4wbBbSTW8NcabNX7PjMlw+VPDw0xZ0bJ/OBDRiI4XW+b5gWYxjt9rsil2wL2x6mgNoohFc5m2jioHzRHtf890MHisuKHGtIpfffJ4pvNbv69cRjGfXQcG09UJmb83zY4ki0BC53CPsi+Z1k3t+TRnsikMKXJ3O10trtcw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=intel.com; spf=pass smtp.mailfrom=intel.com; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b=ECfTW/3r; arc=none smtp.client-ip=198.175.65.15 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=intel.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=intel.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b="ECfTW/3r" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1772102956; x=1803638956; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=EjllPe2xOg6gemOtYgaAWfieX1fzQTiRvmoL4VG/II0=; b=ECfTW/3rm1nhFr5xgaOGNygJ4pIOVUAy5NNnjBfRXpnmwJSXobxN7Jvg PcX73XZMB2+FVeQMV1CnHtNMAPeVTvQTytDH10bsTdzMWoFipRAWxQ4gU XOQypaBBBSIqEWwoUeE2qhDSJJhB6VMZnbMyllelUvw6kzRpPs2j+HB9D BZtl0Qemp2dBxuCCQ0O9M518KrbmCFL8B7XyehXF5zFJfUeO0YIp1R4G8 8RmTadVavhEe34rFWNDGX6lylrID1T/BnIY3BM2YioGbtn+fcqrBh5pb1 j4jSkoY8UddYCu0vJTt9RMSyU0WR3blNqblX/42PDHhKDl0s9AHZ3pWCn Q==; X-CSE-ConnectionGUID: 4xt8imTxTZ28y7QCm6D6+w== X-CSE-MsgGUID: metVah9iTKWLyTkTOCWLJA== X-IronPort-AV: E=McAfee;i="6800,10657,11712"; a="76766066" X-IronPort-AV: E=Sophos;i="6.21,312,1763452800"; d="scan'208";a="76766066" Received: from orviesa002.jf.intel.com ([10.64.159.142]) by orvoesa107.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 26 Feb 2026 02:49:16 -0800 X-CSE-ConnectionGUID: sTf+kV18S0a0MVweyNcY3w== X-CSE-MsgGUID: 2i9Hfxc5Q8agCnM4sxQWDQ== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.21,312,1763452800"; d="scan'208";a="247064294" Received: from jraag-z790m-itx-wifi.iind.intel.com ([10.190.239.23]) by orviesa002.jf.intel.com with ESMTP; 26 Feb 2026 02:49:14 -0800 From: Mallesh Koujalagi To: tj@kernel.org, jiangshanlai@gmail.com, peterz@infradead.org Cc: linux-kernel@vger.kernel.org, anshuman.gupta@intel.com, raag.jadav@intel.com, Mallesh Koujalagi Subject: [PATCH] workqueue: Update schedule_work() documentation to reflect per-CPU nature Date: Thu, 26 Feb 2026 16:17:00 +0530 Message-ID: <20260226104659.3227091-2-mallesh.koujalagi@intel.com> X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The function documentation for schedule_work(), schedule_delayed_work(), and schedule_delayed_work_on() still described them as using "global" or "kernel-global" workqueues, which is misleading after commit a2be943b46b4 ("workqueue: replace use of system_wq with system_percpu_wq"). These functions now use system_percpu_wq, which is a per-CPU workqueue where work items are executed on the CPU where they were queued. Update the documentation to accurately reflect this CPU affinity behavior. Fixes: a2be943b46b4 ("workqueue: replace use of system_wq with system_percp= u_wq") Signed-off-by: Mallesh Koujalagi --- include/linux/workqueue.h | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/include/linux/workqueue.h b/include/linux/workqueue.h index a4749f56398f..fc5744402a66 100644 --- a/include/linux/workqueue.h +++ b/include/linux/workqueue.h @@ -712,14 +712,14 @@ static inline bool schedule_work_on(int cpu, struct w= ork_struct *work) } =20 /** - * schedule_work - put work task in global workqueue + * schedule_work - put work task in per-CPU workqueue * @work: job to be done * - * Returns %false if @work was already on the kernel-global workqueue and + * Returns %false if @work was already on the system per-CPU workqueue and * %true otherwise. * - * This puts a job in the kernel-global workqueue if it was not already - * queued and leaves it in the same position on the kernel-global + * This puts a job in the system per-CPU workqueue if it was not already + * queued and leaves it in the same position on the system per-CPU * workqueue otherwise. * * Shares the same memory-ordering properties of queue_work(), cf. the @@ -796,12 +796,12 @@ extern void __warn_flushing_systemwide_wq(void) }) =20 /** - * schedule_delayed_work_on - queue work in global workqueue on CPU after = delay + * schedule_delayed_work_on - queue work in per-CPU workqueue on CPU after= delay * @cpu: cpu to use * @dwork: job to be done * @delay: number of jiffies to wait * - * After waiting for a given time this puts a job in the kernel-global + * After waiting for a given time this puts a job in the system per-CPU * workqueue on the specified CPU. */ static inline bool schedule_delayed_work_on(int cpu, struct delayed_work *= dwork, @@ -811,11 +811,11 @@ static inline bool schedule_delayed_work_on(int cpu, = struct delayed_work *dwork, } =20 /** - * schedule_delayed_work - put work task in global workqueue after delay + * schedule_delayed_work - put work task in per-CPU workqueue after delay * @dwork: job to be done * @delay: number of jiffies to wait or 0 for immediate execution * - * After waiting for a given time this puts a job in the kernel-global + * After waiting for a given time this puts a job in the system per-CPU * workqueue. */ static inline bool schedule_delayed_work(struct delayed_work *dwork, --=20 2.34.1