From patchwork Fri Sep 15 12:03:26 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: tip-bot2 for Thomas Gleixner X-Patchwork-Id: 140402 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:172:b0:3f2:4152:657d with SMTP id h50csp1009140vqi; Fri, 15 Sep 2023 05:34:13 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGUBX0oMAeWoVW6sFph8NldHmh8WI2miu8LZc1tZEOpulG8wilixPu/xvEEDNvLwsuV9/Cj X-Received: by 2002:a05:6358:7212:b0:133:291:f9ac with SMTP id h18-20020a056358721200b001330291f9acmr2372631rwa.25.1694781253436; Fri, 15 Sep 2023 05:34:13 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1694781253; cv=none; d=google.com; s=arc-20160816; b=RwqTX3e9qMwFSoGNIvgRnFZIHjLkH+MFTbNWUup3oAejP0RuSqnABtP7I7VOap8zyh AaunKgE660qX0qRHP3xWRHwEMI/AogIZACvUsrVUmGP+XI4Byt04V/UHUEN2OT/ijYRX tI+TNSOYWBL8ZBVfHElJPQ36mvoK7jdUV6M1RY2iqN2enRjjUMjV0wUgcXaDWjMxtXHY CTPCHtMA+fZz1Q0xrn8dvLvwKVQGre0tcUWmV6ckWtMZIlYv3NQQxB6avrXJrO8aAKFw a859VUbI3odk2c9veIf+QVqBBMmVLxmN96UL2zuTT8XHGxXsIcSk7yocGLATEvSCsstJ txcQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:robot-unsubscribe :robot-id:message-id:mime-version:references:in-reply-to:cc:subject :to:reply-to:sender:from:dkim-signature:dkim-signature:date; bh=n91F6OwJCEQx/AxwlimYmmS9ThSoGKd78npqs+cy3MU=; fh=eKeIeQq6ZJEPpCVRKsN4VFa+FaRfE4kjc161Ip6RZyg=; b=vRjvcaYJMRbgDablgY0qK6odqN9SAIbbuXltOX0IhAiMgGj0Ru65r42xCpUlo60/E3 bTwrG29TEt4gh/gdbFOwUKY9pqFYtZ2LZCEresTyCdgFZLMJZfmcuWxmKpMgE0Pp6mOX hkJ5+SH1d+3Psz8V6PBE6D7BQnQLYUXZYh6NqRGrUQPdIVGIPClJG3hKVdVvKkja6g0f yeXEDElKrN9dsqVFVRn0oqDXVOf8GwfPsRZJMmcZ8bs/UqAACLEJX3DRd+UNFBCtvE9x Bd+9TfdkWvZsQfjlHJVYgOvUNifBhCZ36yOIw13tfHv5iPTT4JcsGPsuaDHHayQnTLLs zWFg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=xnKujZeR; dkim=neutral (no key) header.i=@linutronix.de header.s=2020e header.b="1sG/SWop"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.32 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Received: from agentk.vger.email (agentk.vger.email. [23.128.96.32]) by mx.google.com with ESMTPS id u1-20020a63d341000000b00577646e2b6bsi3236853pgi.206.2023.09.15.05.34.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Sep 2023 05:34:13 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.32 as permitted sender) client-ip=23.128.96.32; Authentication-Results: mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=xnKujZeR; dkim=neutral (no key) header.i=@linutronix.de header.s=2020e header.b="1sG/SWop"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.32 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by agentk.vger.email (Postfix) with ESMTP id 2DFB482195FB; Fri, 15 Sep 2023 05:06:28 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at agentk.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234610AbjIOMGC (ORCPT + 32 others); Fri, 15 Sep 2023 08:06:02 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35466 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234600AbjIOMGA (ORCPT ); Fri, 15 Sep 2023 08:06:00 -0400 Received: from galois.linutronix.de (Galois.linutronix.de [IPv6:2a0a:51c0:0:12e:550::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AEA492D68; Fri, 15 Sep 2023 05:03:29 -0700 (PDT) Date: Fri, 15 Sep 2023 12:03:26 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1694779407; h=from:from:sender:sender:reply-to: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=n91F6OwJCEQx/AxwlimYmmS9ThSoGKd78npqs+cy3MU=; b=xnKujZeRswTQjFHSGYwpZOpNdumo2jCw3MXaxc82wIAZVyMbZukdWeo/7jI57PKlGgOHcO u3f+mTZJYioffDuVw62URgYGH43wFeL4zaqK9JiC/pwyjT6x5wam7/2bDWjiaNCYuWxX0f 1tzTMMMQNUjJLIhaSDc4T9aHY3luvhatvRTnSGItlzvKmtRx+1R8vkMc2iPHXk89r2euNh F5TavRTJEHmAT8jq/1RAmGJkGUDk257C3RoZjbcv+waUFdAQ6Z0kt9P5X0FvXkY19HrjGK T7CtoGzssFpPNrfAVit2DM+sTxHJ0TvjBTQcNIOut1+W8vtR4DXT72Z37Sunvg== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1694779407; h=from:from:sender:sender:reply-to: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=n91F6OwJCEQx/AxwlimYmmS9ThSoGKd78npqs+cy3MU=; b=1sG/SWopaK+p8X7dtqKUk29q9DNDAg/LsABEQaS0yAdfNm1SV9ZSkDV9dXEsyP0XejyGdJ G2BpDEpX+76WQ3Bw== From: "tip-bot2 for Yury Norov" Sender: tip-bot2@linutronix.de Reply-to: linux-kernel@vger.kernel.org To: linux-tip-commits@vger.kernel.org Subject: [tip: sched/core] sched/topology: Fix sched_numa_find_nth_cpu() comment Cc: Yury Norov , Ingo Molnar , Mel Gorman , x86@kernel.org, linux-kernel@vger.kernel.org In-Reply-To: <20230819141239.287290-7-yury.norov@gmail.com> References: <20230819141239.287290-7-yury.norov@gmail.com> MIME-Version: 1.0 Message-ID: <169477940678.27769.11961724945556415025.tip-bot2@tip-bot2> Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on agentk.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (agentk.vger.email [0.0.0.0]); Fri, 15 Sep 2023 05:06:28 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1777106947502333945 X-GMAIL-MSGID: 1777106947502333945 The following commit has been merged into the sched/core branch of tip: Commit-ID: 6d08ad2166f7770341ea56afad45fa41cd16ae62 Gitweb: https://git.kernel.org/tip/6d08ad2166f7770341ea56afad45fa41cd16ae62 Author: Yury Norov AuthorDate: Sat, 19 Aug 2023 07:12:38 -07:00 Committer: Ingo Molnar CommitterDate: Fri, 15 Sep 2023 13:48:11 +02:00 sched/topology: Fix sched_numa_find_nth_cpu() comment Reword sched_numa_find_nth_cpu() comment and make it kernel-doc compatible. Signed-off-by: Yury Norov Signed-off-by: Ingo Molnar Cc: Mel Gorman Link: https://lore.kernel.org/r/20230819141239.287290-7-yury.norov@gmail.com --- kernel/sched/topology.c | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/kernel/sched/topology.c b/kernel/sched/topology.c index a60ecf4..a7b50bb 100644 --- a/kernel/sched/topology.c +++ b/kernel/sched/topology.c @@ -2112,13 +2112,15 @@ static int hop_cmp(const void *a, const void *b) return -1; } -/* - * sched_numa_find_nth_cpu() - given the NUMA topology, find the Nth next cpu - * closest to @cpu from @cpumask. - * cpumask: cpumask to find a cpu from - * cpu: Nth cpu to find - * - * returns: cpu, or nr_cpu_ids when nothing found. +/** + * sched_numa_find_nth_cpu() - given the NUMA topology, find the Nth closest CPU + * from @cpus to @cpu, taking into account distance + * from a given @node. + * @cpus: cpumask to find a cpu from + * @cpu: CPU to start searching + * @node: NUMA node to order CPUs by distance + * + * Return: cpu, or nr_cpu_ids when nothing found. */ int sched_numa_find_nth_cpu(const struct cpumask *cpus, int cpu, int node) {