From nobody Wed Apr 1 20:44:25 2026 Received: from PH7PR06CU001.outbound.protection.outlook.com (mail-westus3azon11010060.outbound.protection.outlook.com [52.101.201.60]) (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 0E9BA2D6E64 for ; Wed, 1 Apr 2026 14:57:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=52.101.201.60 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775055423; cv=fail; b=sIR6yr6/JlHjjWBkvC/3xV3cFFLjN4h1QtY87eqDoy72xVEOIKj8PKDM7aE5NM1WLjmjIgFiTVFuMPPiqCrj18EqN4k5IJfhHWs7Y5HqGTux9wQcZzgXX+LgMA2lx6TKrKRUYy/qaz6oddVdwjj+GOAVyr2NzR1bOttqFFZ1hf8= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775055423; c=relaxed/simple; bh=9kODHol7xzn2K/IdL9BWU2S2dkkIzkmnH97bqmLzoos=; h=From:To:Cc:Subject:Date:Message-ID:Content-Type:MIME-Version; b=PnR5FFiu8g6gOG1FonYI3pR1qKjlTRzsoRMmDYSiig20Mrs1iZc0xdSRPI40cxa+59i8vt8VpNLO8dOu2bV6SHFUpqkgeHmRUvqH1aE2E2gBk16ocT5Wn/lWYGzFN4cNbuVmlbKHJDZ/v452+9RbBEykFobnN/UQNPclAHLH/xg= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=nvidia.com; spf=fail smtp.mailfrom=nvidia.com; dkim=pass (2048-bit key) header.d=Nvidia.com header.i=@Nvidia.com header.b=OQckk7GL; arc=fail smtp.client-ip=52.101.201.60 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=nvidia.com Authentication-Results: smtp.subspace.kernel.org; spf=fail smtp.mailfrom=nvidia.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=Nvidia.com header.i=@Nvidia.com header.b="OQckk7GL" ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=TZh8VKBnR2o0GXcKWndv27tLUXltRbRNBfLLHKgcVzttH+dIj+0Q79+GxUhx2Ou+TOjceWexZWGK9EYrpsgkVw7Q0qGAcGFxS+k1WeoiUn4jciS6KgoF+CBbwmcwyahmV1+NeVB88GO4IB06ds86CUQnOuiU762kxkQOowJ8CClAXnoZ1oHtvEsJWcPMm7qnPfWwebpIvw8i/j+tP91xU8C3eHt21FapOk5Lx01I3hJranc5VedsH6hInezhLIRqNZzdJxgirexv6gE38+SEfb6KSxwwIx5aFyK0QQulZsd0H8xLuOcH/n3nzq1XNA0ruzla9zGnIfLp12KiS1RYSQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=bknf7i3PAnxgKEQ4FqBk1Nel3XhC8eto+2wOUYykE0k=; b=ieOxiIGzaAsToTlYqdhxMiwhzrnh6/+RPSEMuuOYMDgswpIC0c7rh268vaz32DS/9vb/p2UjGVflRBjAMPSq28oZO8abhpHWJqHS9dxohfY6gqLcT3GrT9oT1jkk2cwcVd2LS4+K9BG0U1icgeM8fMr7IuW9tooJvHj72MC9YHD4gx/Q6cioUbpB/KKP0+K8Ls+RkwpglpbgUAtsnTs3x4TxTJle0W9n94QSt45tfO+FDKMSwPDb5Gohzm91UDXP4uNmnC0rU6D9xysGMaDg2rcnMzmhOgrJxKcUb9EXiq16S8y7rt59ZfgIvTrg/M5NnLwXeHWfa8PEDuvN4+YTlQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nvidia.com; dmarc=pass action=none header.from=nvidia.com; dkim=pass header.d=nvidia.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=bknf7i3PAnxgKEQ4FqBk1Nel3XhC8eto+2wOUYykE0k=; b=OQckk7GL4WjOR1BXjQLPut9DC/aCOIZBuXllnbjELCICsxDLz8PibNhE6+TTTfvk81d991PHEAAsaP6QCpLm2SDigwcYKThSehKWm+qHBxmjnJIWhT3faoXMgxoEvrjr2Agfm7zEfTDBcMwmzWeJiBGnJH2B5bELPYhNtBvVRyaDBe8fodos/KoSBKs/yRYpWY6vPPnglgInr9UkgGDpqg/YSi/KyO1rOD/KESoIrip5w7lmThpA9033al29GNWgNKIXJ2Q7RZGsghd495U12oMJf20UnjNtNsffoV7XvmAbhombYowqlWjVTDWHMv3E1rNSLrlwgTfysBI+SPr51Q== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nvidia.com; Received: from CY8PR12MB7171.namprd12.prod.outlook.com (2603:10b6:930:5c::20) by SA0PR12MB4479.namprd12.prod.outlook.com (2603:10b6:806:95::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9769.10; Wed, 1 Apr 2026 14:56:58 +0000 Received: from CY8PR12MB7171.namprd12.prod.outlook.com ([fe80::4487:395f:3abf:ad9]) by CY8PR12MB7171.namprd12.prod.outlook.com ([fe80::4487:395f:3abf:ad9%4]) with mapi id 15.20.9769.011; Wed, 1 Apr 2026 14:56:58 +0000 From: Yury Norov To: Valentin Schneider , Ingo Molnar , Peter Zijlstra , Juri Lelli , Vincent Guittot , Dietmar Eggemann , Steven Rostedt , Ben Segall , Mel Gorman , K Prateek Nayak , Yury Norov , linux-kernel@vger.kernel.org Cc: Yury Norov Subject: [PATCH] sched: topology: cleanup comments Date: Wed, 1 Apr 2026 10:56:52 -0400 Message-ID: <20260401145654.16241-1-ynorov@nvidia.com> X-Mailer: git-send-email 2.43.0 Content-Transfer-Encoding: quoted-printable X-ClientProxiedBy: BN9PR03CA0160.namprd03.prod.outlook.com (2603:10b6:408:f4::15) To CY8PR12MB7171.namprd12.prod.outlook.com (2603:10b6:930:5c::20) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CY8PR12MB7171:EE_|SA0PR12MB4479:EE_ X-MS-Office365-Filtering-Correlation-Id: 73fe035a-400f-4d48-05a8-08de8ffeec6a X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|366016|7416014|1800799024|376014|10070799003|921020|18002099003|56012099003; X-Microsoft-Antispam-Message-Info: JGQkNj0h69aSt/UY7yXDUcZVs5tFTzPB/RfEWIjxJtJ4AJ3wrMkvu1pc3RbvEJijRcc6Ph2HfjgQMcc/EGAPHv0Bl5P0uvBOqy5MJxY0HTLwcSgh/TVmX+QvYyRiAfAp+ftmg6tpPEz5X/GuvZvyX4+EuhYrVhNxbocqS3HsdSaYYPwUKUNfldE01naZjmScZ53K/aLkgzwN3dG3ZHMYFnviwOdXu77z7oERmzYvhWOWKPl9ZO030awOP+4lF7RTrw6CK11ngYwOwrUmS8Gw5eDW3PT9JlncHLq1LsrO8YRt7gR0Og/Cjy5Kw5tuWul3Z3StkSu8YR2vfW2o963jb2js9eRie0J+folJilsOzDvpkmKbxaUa/1xobIZZ49ZbeDSf8hsp85xFTbaf+mwzaSJ75p7jF7R4NCGQCGnW86Dcp3Mu/rq3zYP1YhDQa1bE+lF7K3yVAWcAOggoRHhRWtdys5EEDX5kIxliRhvIdEI68OlYLQDRaC01ZtNF7ZUwjTUF+jfJJD7XvGYksyOQNUfsJOCgLZTU0a6RPr3H/c1QkAGisPu5TbYICBrpoOUuvqcWUf1nMPDhdueHRN0DzLFhaDz7G0xFDQuwtHZACHBpjPF27KStpAcl7aS4GOdEHXNNLXqlnX0zH0611mF8g0RhoDc0WnL7lM6O14FElO9w+WXYrn6XeNP45mmikKlzGkPcbmmRgm+JjXrZQvEMrCLLIjRaQclA1EC2nILIaA3g/V2DE5WwlFjXo8PxGucCjTWQNZO/b+TMnt78hklJHg== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:CY8PR12MB7171.namprd12.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(366016)(7416014)(1800799024)(376014)(10070799003)(921020)(18002099003)(56012099003);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?V4IlPyC6W9MtOWd/Ll+yQRtnUeyOqlJmS9H5fCOGXm3iwGlvoAI5vJtv9aYe?= =?us-ascii?Q?27qOwx5eSUp+PAirSoNG8olJUGwTNvSHUaLgzeNZhIwhgC6q9aMmpT5pBgM3?= =?us-ascii?Q?IdnsvgT8saHWY3yR4N+lSAcJWLRzZ2Re62M4cJAeYb/XZOcAyo8qPMVqmzbM?= =?us-ascii?Q?pFM72/B/RNFTaTHApjW/ZcpglyNIIaF6T1tCMPwa3F5BoerVd5pig1Z1QCa0?= =?us-ascii?Q?2flLgobv+yqIzshSkGHcJ304z2LOgbURyzqScEDqJo+1tsBNTA+4Hr9Kkapp?= =?us-ascii?Q?qXAzQtwcmHQw3o/KvPnqxU1DH+mv2pgwWVH7hsGblsg2HytBoBewY0mCmjbq?= =?us-ascii?Q?xXYbh+P5IGy+zCuwLMmlZbRO4vc8U6fgNZuyFgXPSDEWzVWufVZM+61X6lJQ?= =?us-ascii?Q?xX3HJ0Xn7rddn3fIP0/RCMGeAw5ceelEVK6sRaQioAWUuiefRyqq9KnQazdX?= =?us-ascii?Q?gwKoAClvHabT6fODfwB7Rsb8Zyc/S8TmBBMu4Owh//mW17zBCv1G0FwObrjo?= =?us-ascii?Q?uN+ANsHJeoJgYmLo2DMoy3Tsk4NTR7uhxrEp6Z7HMjVVbM05ywmx+GyOTwO/?= =?us-ascii?Q?bO5UzgabtrpCdQE5GazXujCoSn0rbK/w4pZXWVqd+aUUW7BGwr1fvdzochjx?= =?us-ascii?Q?8MOnV7FNNoQ/KV0addDnxEjk0Ru7zIs+NqgP/tBpMTCyNUibIlAZC7NKnUnP?= =?us-ascii?Q?PSLg2VWCiAwSralup90ZC2cSfSANc9T5jmKKxDwV+3j1uOmwdUJYQcuD3Ss6?= =?us-ascii?Q?K3lhq65FcZ3SY4XNQd3JXgVSgbkJWH6Avdv28/zix2hyQeknQ4Tc1PgUHEEO?= =?us-ascii?Q?mbrDQQJCPCpeF4uLoRwkENaSSCoywflX6HXoDdGKjF8j0Hqpwupd0U97RTpA?= =?us-ascii?Q?e6w8oHyKVXde4bMa1w72BFUGZHTflQ545o7wmkL1gTHhfiQAB+m0ttRIyg/n?= =?us-ascii?Q?/SCPhrpWmaogGxg8nv3/z9tX2aqJHeOo3JiQQhODE6vqhQ+IJy7+UHRp5VvX?= =?us-ascii?Q?VIPyQueQtyf4Fi5k1MO5qLJB8AmNvkyVdJP8e1QHoCLxflFR2igaeAeCTmC+?= =?us-ascii?Q?DglI6BbBwm5p0uzcWrnIrLlUAnZkmmlH0WupRUTlKk0HTVG3javLYVgzI1r6?= =?us-ascii?Q?9K8UMOqOK7bfl9aPdaSh+S4g9iJ5kltPdPl7RT4mWwTwtWKH+m17c75hN5gG?= =?us-ascii?Q?yDZQhbRSa7Pv1gUqo0wxUZZ7hSByEU+0jAH3pnkqbGbIVt0yvaUnhwBwjWx7?= =?us-ascii?Q?Uph4Mz2tfQotw76i0+3O+PNI7AcJOo+F6PerZMFK3t/E+/GaOWUYHci586gG?= =?us-ascii?Q?fghTvSdr4n9eLSbF4LjmIdW1Fqbt3Fdk1BY6pzUP3yjfK+y5njjBOGu2Xy7y?= =?us-ascii?Q?r+qhGWe6IoSds3Dv3Sb/v2VlFX62uiFtVZSZ0hNU1ZRf6mC+AFMdms0b0yW3?= =?us-ascii?Q?1g7Us1bo4mODJMUppqghtsfohh3w1nazCvC1f4diBkCZIk2n0GUXWFjBJH37?= =?us-ascii?Q?CcfHQxW5Yf+kN8JpCyInrLrfux6dLefz8KYPPrLqWl/va/dsmU6u3gQPfCCi?= =?us-ascii?Q?eAdJij51qcE1fHCWpXtgtWLp2gcf2C55uBoR1ZQeuIUZN7uzW1UJAvR07Hze?= =?us-ascii?Q?9/wconhmlGXS74gCbAJuKiBATSPaW3XYgAQPna6UsP+hF6G7HhwtfGqFGJh5?= =?us-ascii?Q?hexqzHPbYcQFSCmHggeIro8sWY43HBfMsp9akLPcLoavoARYQTkvloRWPjCI?= =?us-ascii?Q?12awY4YN66jznb4igrU06iehKZhiKlLeb4KVsDybouphD9zoxasQ?= X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-Network-Message-Id: 73fe035a-400f-4d48-05a8-08de8ffeec6a X-MS-Exchange-CrossTenant-AuthSource: CY8PR12MB7171.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Apr 2026 14:56:58.5488 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 1PezGYe0t/QMkKTQiXDikUQuV6lgx/6jA1+y/R0G9YIU81cXjQVZ/miCYrpz/r+TEZgJ1EFDa/Mqj37oVTp/CQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA0PR12MB4479 Content-Type: text/plain; charset="utf-8" sched_numa_find_closest() top comment is almost kernel-doc formatted, but doesn't appear to be a valid kernel-doc. Fix that, and while there reword NUMA-level comment, highlighting that 'NUMA level' is a synonym to the number of hops. Signed-off-by: Yury Norov --- kernel/sched/topology.c | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/kernel/sched/topology.c b/kernel/sched/topology.c index 43150591914b..1e7b89ad6d11 100644 --- a/kernel/sched/topology.c +++ b/kernel/sched/topology.c @@ -841,7 +841,7 @@ int group_balance_cpu(struct sched_group *sg) * * We want to construct domains and groups to represent this. The way we go * about doing this is to build the domains on 'hops'. For each NUMA level= we - * construct the mask of all nodes reachable in @level hops. + * construct the mask of all nodes reachable at that number of hops. * * For the above NUMA topology that gives 3 levels: * @@ -2237,13 +2237,13 @@ void sched_domains_numa_masks_clear(unsigned int cp= u) } } =20 -/* +/** * sched_numa_find_closest() - given the NUMA topology, find the cpu * closest to @cpu from @cpumask. - * cpumask: cpumask to find a cpu from - * cpu: cpu to be close to + * @cpus: cpumask to find a cpu from + * @cpu: cpu to be close to * - * returns: cpu, or nr_cpu_ids when nothing found. + * Return: @cpu, or nr_cpu_ids when nothing found. */ int sched_numa_find_closest(const struct cpumask *cpus, int cpu) { --=20 2.43.0