From nobody Mon Jun 8 22:53:29 2026 Received: from mail-pg1-f177.google.com (mail-pg1-f177.google.com [209.85.215.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7883C2F83B5 for ; Tue, 26 May 2026 02:21:11 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.177 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1779762072; cv=none; b=NGA1f13qResPhQ8K0lppVFdHS0K8D7sq8puGdCX9BR6JtwEXpJ9Xxfqq67gl7baIZpd9S4kbl1G7ErhKvvGfmoOFaa0PcxGtKu8ZlvrdAiu3QbZMcjp3JPY+wF973KskhOliLwJjpTjucnHDcBA8s4Xc/IIe/Z41rFbNOBj+wrU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1779762072; c=relaxed/simple; bh=8s96aYjEf8QXUo2LCf+8jP1IDbw7kHSYOPIvgWrt4I0=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=uqROunG1smlqOWsJIBWixYFkGCBChwIWUa6g7byv61hp/+iTw/MOpU2O69CNC/M8usAJ4udu7K7FdUAgoe3vjvgEs1Ct0Wd7w/cuMsmOjjYpzHYuTgpPyK/U1YnbIcloSG+i4OU2TOPgwbhzrcMCf8ZUdGEdGCffCpjufYaY/68= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=LElzSXzP; arc=none smtp.client-ip=209.85.215.177 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="LElzSXzP" Received: by mail-pg1-f177.google.com with SMTP id 41be03b00d2f7-c8025f1c227so7929778a12.2 for ; Mon, 25 May 2026 19:21:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1779762071; x=1780366871; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=HOdVORY2mmUngNwXnJOGwSWAIBrRq9mHOSN4bPLyK9s=; b=LElzSXzPMYw/eNdb+vBfIzgyjClEo5aaBV6/C6i+Ryo51pgXb3xSTZcj6tMDqDyv2z WwBRT+nURvU9w5RwkFG/59rzhaALSltU4oVDgccDgnQJQH6Ut0NAawai7dSfkTpmiPYb wXZW7BZcK4JwiBKnFz4JEjvsvFr6ec+f+pchKrwwgbyVAKZ6vLLFFcAcsh5SKAUQXiWm jxJOw6ZEIcvdmjiCjsr9RjxJwWfESVShBM/j80S772GcsIl82t1Aw9Jyn/7VPT19nv5a VM7XzNvZY6wozNk++YPbUkmYfDphxIoaKNbBzdlBTEem9aiIv1/KkClL1PUWJK4UM8u/ vOlg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1779762071; x=1780366871; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=HOdVORY2mmUngNwXnJOGwSWAIBrRq9mHOSN4bPLyK9s=; b=leEXKfC/5cRGEBy0VeKm7/R88FyKoBNihXUOsuHUQkkLPHwN1a1ihidvPNdWUd921G cCnV3queFp1k0vYVbqA1+F8Qp8qISAQxrKq/uFCkvRBU4TZ6J9ia+EHGoxPJzj7Jx/F5 FRjqabveUuchUgoQyEoLdf6OXiQEgcLx6hXapS/G0ihTELo4xtKGh99FX7ky8MHluf78 vaKHaBpMNba4RIMcNNC8mSlyF02rIHrdw4z8q1jz4SQ6l6kiPST56D5adxssXb0N9cCC mU0imhf9hupCPKiGLput/BOENvmnbRI9J62scfsuR+Z/Zhcr3RY4Vo20MxERThGkBwTB itCQ== X-Forwarded-Encrypted: i=1; AFNElJ9mO+5/gqz/Mf6Bd0evZTWKMharNa6PopJIERh/R38x1H/YJ0KIorksgZLlVfaDUhE9WWYuFVDpSZ70LuY=@vger.kernel.org X-Gm-Message-State: AOJu0YwQY7RkqmgJGTkKmCtEOhemSjffAMWo5G6bmU11aaTHrvU+cDp8 /S2xXtgEOg/BQbidEmhnYBVb6+DddvH2ATB4zJ/ZbyVWbcXgm1RYd/u7 X-Gm-Gg: Acq92OF4z1FF4VSOAzeV2hzQXuj62OPCmdDFY1u4ItbYq6+JsfS7LmS4tvzcfAfh1P2 zv/Ew8KGm+vYqVLVi+AcBMC/tlcWAe4pvfiu9EuCt9mxrmx+6/HjH/BStEr5KqztuPVk5u7CDaI GccyEIJ2U5MsQe2DxZ7WHUUUwHA+VSgvQVoID/3a0zrZXyiz2aIN+fjgXwAs/+UEoM1jkhMS/cE kkfJj6Ib5m8N/2EtiSd1pgefS0w3ZhtXKYsp4nYKrpIKevcLVgo+nn1B2+knBSRaMhL6craR+uE +1ZQcRd1fnmY/QgYW2SnC0lEv6wXibBM9YikCk96xXZOO3ofi2umjomIkHXjK8p5dRVdEIAKkbq RjJnLrQI0upHAz6sglxbBtGo+TE/ChNH71vekovqzMv5csi1dwsH6lbDCBhxEV72y0yPqBZq9dh +plxsqAOBjNoh+EQb68T/7w0R5z3u170TGUHYgsSf1U8m6 X-Received: by 2002:a05:6a21:594:b0:3a7:1d55:b634 with SMTP id adf61e73a8af0-3b328f562bemr15656254637.38.1779762070791; Mon, 25 May 2026 19:21:10 -0700 (PDT) Received: from osman.mioffice.cn ([43.224.245.178]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-c852058557bsm8911347a12.30.2026.05.25.19.21.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 25 May 2026 19:21:10 -0700 (PDT) From: Zhan Xusheng X-Google-Original-From: Zhan Xusheng To: Anna-Maria Behnsen Cc: Frederic Weisbecker , Thomas Gleixner , Gabriele Monaco , linux-kernel@vger.kernel.org, Zhan Xusheng Subject: [PATCH] timers/migration: Update stale @online doc to @available Date: Tue, 26 May 2026 10:21:06 +0800 Message-ID: <20260526022106.1302279-1-zhanxusheng@xiaomi.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" Commit 8312cab5ff47 ("timers/migration: Rename 'online' bit to 'available'") renamed the 'online' field of struct tmigr_cpu to 'available'. The kdoc comment above the struct still describes the old field name. Update the kdoc to reflect the actual field name and use the 'available' wording in the description. Fixes: 8312cab5ff47 ("timers/migration: Rename 'online' bit to 'available'") Signed-off-by: Zhan Xusheng --- kernel/time/timer_migration.h | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/kernel/time/timer_migration.h b/kernel/time/timer_migration.h index 70879cde6fdd..06646aaa1417 100644 --- a/kernel/time/timer_migration.h +++ b/kernel/time/timer_migration.h @@ -75,15 +75,16 @@ struct tmigr_group { /** * struct tmigr_cpu - timer migration per CPU group * @lock: Lock protecting the tmigr_cpu group information - * @online: Indicates whether the CPU is online; In deactivate path - * it is required to know whether the migrator in the top - * level group is to be set offline, while a timer is - * pending. Then another online CPU needs to be notified to - * take over the migrator role. Furthermore the information - * is required in CPU hotplug path as the CPU is able to go - * idle before the timer migration hierarchy hotplug AP is - * reached. During this phase, the CPU has to handle the - * global timers on its own and must not act as a migrator. + * @available: Indicates whether the CPU is available for handling + * global timers; in the deactivate path it is required to + * know whether the migrator in the top level group is to + * be set offline, while a timer is pending. Then another + * available CPU needs to be notified to take over the + * migrator role. Furthermore the information is required + * in CPU hotplug path as the CPU is able to go idle before + * the timer migration hierarchy hotplug AP is reached. + * During this phase, the CPU has to handle the global + * timers on its own and must not act as a migrator. * @idle: Indicates whether the CPU is idle in the timer migration * hierarchy * @remote: Is set when timers of the CPU are expired remotely --=20 2.43.0