From nobody Sun Feb 8 10:44:20 2026 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 2534DBA4A for ; Sat, 11 Jan 2025 06:31:57 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736577118; cv=none; b=TMHESvz9Rd/+VgT7kCzGo8M7n/SNde0ffN2sD+ZOBzJ+QcTnJRjgcRF1dhix1OA7h+TP4dLWc0iud6WngFyGW0M2hUgYE83nYpiwI8+Za1QVHHrLhHN1/BvETkGsY70ETyeVHTS/QlmdYx9ueQZXGknu7fXEWh9c0sv2ROsOGzY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736577118; c=relaxed/simple; bh=Ctk0KjyRB9aI1dQvhs6Bnlj4Sb+MLXp9vEBYtlGu9q4=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=T6ZIrIwXTVvTBPV2yfs1GKleJzqCJ+DVNz/X9y1cS7hHrPd2ibqf2zR63i9wACeFXX9PLEUTEFS280F6qkmOEaESsCwMdTTQv5u84xtoljObk7tSs79KO+/ahUd+1BA7+kn/FOKH7RBL1x116NPE6qGskJIz8qhczxBtNmNh6zQ= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=BcJVoWan; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="BcJVoWan" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=34NcRcTBw2yE6roMWmXWu2CpIXQxC/6VwfzQ7J1aco0=; b=BcJVoWannYnTsSjtlD8I4qhwWQ DdiuL500arW9fH4WUdUZD2Xy7cxhI3etbg9Qf3ldeFPMf5hDIzR2yGYblHQRqOp5F8btO2Kaf70uK HpdIsXj2SUK0Cfwu2OFVHOr/AML/gaxhLzn7j5gpvsdlzcQkzuI5gbO1XokPdlqktc4C6oekgNAg/ BrQfnQV4AHHAYb5iJeOJS+iwzz+3bILphD2n/7kdn5aegD65TLCA2cOvdS8q2xLCvZ9K9LbcvjRUz FuBXG236ug2QDnSjr9hOGxRIGOHDVN+UJhS3PpxuiSFcMZ+yAPYuLXa1AKYlz2G4vMVLL7zphTdd5 ljocUt2g==; Received: from [50.53.2.24] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.98 #2 (Red Hat Linux)) id 1tWV2K-00000000Hj4-2xib; Sat, 11 Jan 2025 06:31:56 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Anna-Maria Behnsen , Frederic Weisbecker , Thomas Gleixner Subject: [PATCH] timer/migration: fix kernel-doc warnings for union tmigr_state Date: Fri, 10 Jan 2025 22:31:56 -0800 Message-ID: <20250111063156.910903-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.47.1 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" Use the correct kernel-doc notation for nested structs/unions to eliminate warnings: timer_migration.h:119: warning: Incorrect use of kernel-doc format: = * struct - split state of tmigr_group timer_migration.h:134: warning: Function parameter or struct member 'active= ' not described in 'tmigr_state' timer_migration.h:134: warning: Function parameter or struct member 'migrat= or' not described in 'tmigr_state' timer_migration.h:134: warning: Function parameter or struct member 'seq' n= ot described in 'tmigr_state' Signed-off-by: Randy Dunlap Cc: Anna-Maria Behnsen Cc: Frederic Weisbecker Cc: Thomas Gleixner --- kernel/time/timer_migration.h | 21 +++++++++------------ 1 file changed, 9 insertions(+), 12 deletions(-) --- linux-next-20250108.orig/kernel/time/timer_migration.h +++ linux-next-20250108/kernel/time/timer_migration.h @@ -110,22 +110,19 @@ struct tmigr_cpu { * union tmigr_state - state of tmigr_group * @state: Combined version of the state - only used for atomic * read/cmpxchg function - * @struct: Split version of the state - only use the struct members to + * &anon struct: Split version of the state - only use the struct members = to * update information to stay independent of endianness + * @active: Contains each mask bit of the active children + * @migrator: Contains mask of the child which is migrator + * @seq: Sequence counter needs to be increased when an update + * to the tmigr_state is done. It prevents a race when + * updates in the child groups are propagated in changed + * order. Detailed information about the scenario is + * given in the documentation at the begin of + * timer_migration.c. */ union tmigr_state { u32 state; - /** - * struct - split state of tmigr_group - * @active: Contains each mask bit of the active children - * @migrator: Contains mask of the child which is migrator - * @seq: Sequence counter needs to be increased when an update - * to the tmigr_state is done. It prevents a race when - * updates in the child groups are propagated in changed - * order. Detailed information about the scenario is - * given in the documentation at the begin of - * timer_migration.c. - */ struct { u8 active; u8 migrator;