From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from galois.linutronix.de (Galois.linutronix.de [193.142.43.55]) (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 CF3EF14F112 for ; Tue, 17 Feb 2026 16:31:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=193.142.43.55 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771345869; cv=none; b=HubJJ/wmOFPrMJ9iuiv62uqVnmnWdjI3OfXhzkBq72J8jK2ePasjwilnFXlLa36iwbO+Lc/hXkHOw4cblBC0WMzz1tDaoETvyKfia25TwIFVJHaUESulIRWZMR6hDyzbUlXb8UrYL3FbIZrczqQBsoEqrpaJ2aBCWLNhe+32yKw= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771345869; c=relaxed/simple; bh=KcS1VkSw3KHx65dBDypTjDd97mm1dI71IeQTMzlpHPs=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=dEI/5Hv8E+pXmL3sXvmLHOT0jz1sE+2PKS7s7peeNu5AiBLtx13GoG03DnQLsXmsA5MOZ+WRmK9TQQdGnL0p7paYN1sPZi7tLS6GVu8T3hb7MXH76Htj0M69hdQ1MjLOay5b8Q8c5+UiThYlamrpR3mYrV3NqK5RO5BmIX5IqFk= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linutronix.de; spf=pass smtp.mailfrom=linutronix.de; dkim=pass (2048-bit key) header.d=linutronix.de header.i=@linutronix.de header.b=xrlqIUJV; dkim=permerror (0-bit key) header.d=linutronix.de header.i=@linutronix.de header.b=Qqp+s8ol; arc=none smtp.client-ip=193.142.43.55 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linutronix.de Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linutronix.de Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linutronix.de header.i=@linutronix.de header.b="xrlqIUJV"; dkim=permerror (0-bit key) header.d=linutronix.de header.i=@linutronix.de header.b="Qqp+s8ol" Date: Tue, 17 Feb 2026 17:31:05 +0100 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1771345866; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=KcS1VkSw3KHx65dBDypTjDd97mm1dI71IeQTMzlpHPs=; b=xrlqIUJVG+oD61V/I3m5uby1gyq9RY+7tvemHPm7owQYEAnBal5itPsbweOyUmqO/QLxJW v6u6yqiYGcAiMDrnlfn+Ze7sj5SBxYJ8YEjEv09bK0Bu0z5kkZ7a/2axSFkFLOPeOjwlyf 6X/Hw4RnGggNXUcvMGlhnaTR3p5HnR3vg+iwOFEp7OU0Y/6Udva5vl6mfpx/1J1Skal6oV q2UmKgZz9sBu0ymcWq8Dxxjhm/uGsoZmuhfZEOxeLc2xpSLkQKd1NjOjfXmshTfGctxPJC HX+d60hsKDYFm8ui619T32U4ukdNbV44cK7a1vrckmw4HWHCxRKzdKX2UF9SaQ== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1771345866; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=KcS1VkSw3KHx65dBDypTjDd97mm1dI71IeQTMzlpHPs=; b=Qqp+s8olnNWXZ4VtcwcgPfjmfRvTMwaKSCu2wvjl197WVggOvsxx54xovEvMcAZl6S7Ilt 4hNGr+wKlHrHGcAA== From: Sebastian Andrzej Siewior To: Thomas =?utf-8?Q?Wei=C3=9Fschuh?= Cc: "Paul E. McKenney" , linux-kernel@vger.kernel.org Subject: Re: [PATCH] stop_machine: Fix the documentation for a NULL cpus argument Message-ID: <20260217163105.tbuNIiP6@linutronix.de> References: <20260217-stop_machine-comment-v1-1-a6271c97113b@linutronix.de> 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-Disposition: inline Content-Transfer-Encoding: quoted-printable In-Reply-To: <20260217-stop_machine-comment-v1-1-a6271c97113b@linutronix.de> On 2026-02-17 14:11:11 [+0100], Thomas Wei=C3=9Fschuh wrote: > A recent refactoring of the kernel-docs for stop machine changed the > description of the cpus parameter from "NULL =3D any online cpu" > to "NULL =3D run on each online CPU". >=20 > However the callback is only executed on a single CPU, not all of them. > The old wording was a bit ambiguous and could have been read both ways. >=20 > Reword the documentation to be correct again and hopefully also clearer. It is the first online CPU. It temporary freezes all CPUs and runs the function the first online CPU. I would prefer this over "unspecified". Unless you point that it does hold and CPU hotplug locks. > Fixes: fc6f89dc7078 ("stop_machine: Improve kernel-doc function-header co= mments") > Signed-off-by: Thomas Wei=C3=9Fschuh Sebastian