From patchwork Sun Oct 8 09:52:28 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: 149721 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:a888:0:b0:403:3b70:6f57 with SMTP id x8csp1293421vqo; Sun, 8 Oct 2023 02:52:59 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFgSA0yGO3T6zw+1Imh1ICtlojp3fTmwIqi7GASGFNFHE8dNYTp4xRIXmeS0t8t8St92Bot X-Received: by 2002:a05:6870:f10b:b0:1b0:3cd4:76d5 with SMTP id k11-20020a056870f10b00b001b03cd476d5mr14656761oac.37.1696758779672; Sun, 08 Oct 2023 02:52:59 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1696758779; cv=none; d=google.com; s=arc-20160816; b=xWfpGUhxUwkyg+jWdbu2Ee10o+vZPqmzBPg9gpYBsZ0hPViQ+qzEShcHc9klunRYyM IowdAik42ZYQo/TJ1Ir2aL+Pvjuk7IGcqYLPoj4YQ0rqMGqlaMeMEKm8x+0rYxrppayf vFWbviPiP2yTxwTWKSTFel8xmYvVq+IC+R6t4oZ0lowgWjS/SiGKFb4qBvcghuvJUoNG p0lG0eZhoqbFQNK2V/pqUpUSAyMa6kuSjEcBaUVaH+/qDnoY0c9huBCXl7LdKxdJLIHS iO1AE911XGNzlb5YAU+DE0/oMBCcpkjLlMT1pjUk7wnyPKMSQHq+JT1u83N59fR6d8xA lsIw== 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=b6MlXoe96JWyM6gHh38vzeZaUjP/cVbpZxqfXw9dQ/o=; fh=vDu67ZHB7NO/GfTsU8XqB/J519j9duaed+YVExTkjjU=; b=dKHMnl6apW7pyWt9kfag1rz9f8xNXqCgwZ3sE6D1iI52senh4EKW7bozdc1B9H+gSt GOkZLi5CLRbfqdpEWmuyEDg44sbOtGVeOZsQ3fynbLVSXDuFNejothW3Gjfzu+kVn1AT fQkFAMUljme0c33slygkESLaaHqTeQz1ZINa25X9zLy2qzXV40zOhPLqk8mv7J5/6zE8 pPUBNL9566fCVB9zJg+ttoJA0gZFBXGNO0ZvDfDqWq738oR5uGDXtTQlXaU819K375Ja 2UyYuswY3uDYWnWgT7MwNTIA0hMQ2GKpCF6d6v8cMQZeF1P0MlVGVUrm82J+yO6XmWHc 4ToA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=T51m2Nxb; dkim=neutral (no key) header.i=@linutronix.de; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:6 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 pete.vger.email (pete.vger.email. [2620:137:e000::3:6]) by mx.google.com with ESMTPS id t1-20020a17090340c100b001bb8e3f3475si7409396pld.52.2023.10.08.02.52.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 08 Oct 2023 02:52:59 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:6 as permitted sender) client-ip=2620:137:e000::3:6; Authentication-Results: mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=T51m2Nxb; dkim=neutral (no key) header.i=@linutronix.de; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:6 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 pete.vger.email (Postfix) with ESMTP id 7F56C803DAD7; Sun, 8 Oct 2023 02:52:57 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at pete.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344587AbjJHJwe (ORCPT + 17 others); Sun, 8 Oct 2023 05:52:34 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48612 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1343527AbjJHJwc (ORCPT ); Sun, 8 Oct 2023 05:52:32 -0400 Received: from galois.linutronix.de (Galois.linutronix.de [193.142.43.55]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 38CB7B6; Sun, 8 Oct 2023 02:52:31 -0700 (PDT) Date: Sun, 08 Oct 2023 09:52:28 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1696758749; 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=b6MlXoe96JWyM6gHh38vzeZaUjP/cVbpZxqfXw9dQ/o=; b=T51m2NxbfbfbRt+/B0+xu2v9fAKiAPr3MZ7axCkMCrpw3XqISP0A0YPhWGGiDLYcYMrInk QohgUPywpYv6owA2pYj9XzeomYKx/vKrlZHfkGAsjBEP5EqCGrswsbVu0txrQLEbctsuYz A/8Ic+tIw6PPadRkSkLlCxqh+OHWo4dXULTJJGbd3mHAU4PDcRuHxJHlS655hP758IaoOQ LA99if7J6wqiwnguSvUxkGD9iOhhcIOEkp9X08ss2IXh64QmuYeZYFdCV/i34d/QgwMOEP fVh2f7hxxSFIy8iLU26Mp+0XhDO3V174O4SwebS9L2l0XMzSm3p61Qs1xJ8u1w== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1696758749; 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=b6MlXoe96JWyM6gHh38vzeZaUjP/cVbpZxqfXw9dQ/o=; b=eMh2OmzzjJxmZ+Kbn7ZkcFr7MC/DMASPVshvFEoap/Zh7XwrKcY3FGAbhc/e+GF2DtjanE HHkTfGM1SK2p4xDg== From: "tip-bot2 for Randy Dunlap" Sender: tip-bot2@linutronix.de Reply-to: linux-kernel@vger.kernel.org To: linux-tip-commits@vger.kernel.org Subject: [tip: x86/urgent] x86/resctrl: Fix kernel-doc warnings Cc: kernel test robot , Randy Dunlap , Ingo Molnar , x86@kernel.org, linux-kernel@vger.kernel.org In-Reply-To: <20231006235132.16227-1-rdunlap@infradead.org> References: <20231006235132.16227-1-rdunlap@infradead.org> MIME-Version: 1.0 Message-ID: <169675874835.3135.5688248795172710200.tip-bot2@tip-bot2> Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails X-Spam-Status: No, score=2.7 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, RCVD_IN_SBL_CSS,SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on pete.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 (pete.vger.email [0.0.0.0]); Sun, 08 Oct 2023 02:52:57 -0700 (PDT) X-Spam-Level: ** X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779180534089158669 X-GMAIL-MSGID: 1779180534089158669 The following commit has been merged into the x86/urgent branch of tip: Commit-ID: 025d5ac978cc3b47874cc1c03ab096a78b49f278 Gitweb: https://git.kernel.org/tip/025d5ac978cc3b47874cc1c03ab096a78b49f278 Author: Randy Dunlap AuthorDate: Fri, 06 Oct 2023 16:51:32 -07:00 Committer: Ingo Molnar CommitterDate: Sun, 08 Oct 2023 11:45:16 +02:00 x86/resctrl: Fix kernel-doc warnings The kernel test robot reported kernel-doc warnings here: monitor.c:34: warning: Cannot understand * @rmid_free_lru A least recently used list of free RMIDs on line 34 - I thought it was a doc line monitor.c:41: warning: Cannot understand * @rmid_limbo_count count of currently unused but (potentially) on line 41 - I thought it was a doc line monitor.c:50: warning: Cannot understand * @rmid_entry - The entry in the limbo and free lists. on line 50 - I thought it was a doc line We don't have a syntax for documenting individual data items via kernel-doc, so remove the "/**" kernel-doc markers and add a hyphen for consistency. Fixes: 6a445edce657 ("x86/intel_rdt/cqm: Add RDT monitoring initialization") Fixes: 24247aeeabe9 ("x86/intel_rdt/cqm: Improve limbo list processing") Reported-by: kernel test robot Signed-off-by: Randy Dunlap Signed-off-by: Ingo Molnar Link: https://lore.kernel.org/r/20231006235132.16227-1-rdunlap@infradead.org --- arch/x86/kernel/cpu/resctrl/monitor.c | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/arch/x86/kernel/cpu/resctrl/monitor.c b/arch/x86/kernel/cpu/resctrl/monitor.c index ded1fc7..f136ac0 100644 --- a/arch/x86/kernel/cpu/resctrl/monitor.c +++ b/arch/x86/kernel/cpu/resctrl/monitor.c @@ -30,15 +30,15 @@ struct rmid_entry { struct list_head list; }; -/** - * @rmid_free_lru A least recently used list of free RMIDs +/* + * @rmid_free_lru - A least recently used list of free RMIDs * These RMIDs are guaranteed to have an occupancy less than the * threshold occupancy */ static LIST_HEAD(rmid_free_lru); -/** - * @rmid_limbo_count count of currently unused but (potentially) +/* + * @rmid_limbo_count - count of currently unused but (potentially) * dirty RMIDs. * This counts RMIDs that no one is currently using but that * may have a occupancy value > resctrl_rmid_realloc_threshold. User can @@ -46,7 +46,7 @@ static LIST_HEAD(rmid_free_lru); */ static unsigned int rmid_limbo_count; -/** +/* * @rmid_entry - The entry in the limbo and free lists. */ static struct rmid_entry *rmid_ptrs;