From patchwork Mon Nov 20 09:28:29 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: 167004 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:9910:0:b0:403:3b70:6f57 with SMTP id i16csp2079128vqn; Mon, 20 Nov 2023 01:28:40 -0800 (PST) X-Google-Smtp-Source: AGHT+IEDU0VUQosuJdPr3DZHO+0TEQYV4mjENgNm/83EVU9qSNoTsBhR3pSzcUAVuQmS0OeR7BKz X-Received: by 2002:a05:6808:a9b:b0:3a9:c2fe:335c with SMTP id q27-20020a0568080a9b00b003a9c2fe335cmr8435230oij.52.1700472519865; Mon, 20 Nov 2023 01:28:39 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1700472519; cv=none; d=google.com; s=arc-20160816; b=FfdgGYHpRww2gfe5KsffVM0212X0JVY2RjBRLc0PPJsCu/W3I0nQZ5rHDo7xxdqZVG Kw2UrxZobakatjeyB05JjFRGmHYZ+Do8pCvtDjMqYmHdYAFNP4z4UP7bVzPJIzfa8oCt YlBBqKXGNhODQ4LMxonJHqJrXGxvtuS1NPsp8nGn7LvBP5h7v6Ew4Zko5xnL4iB0qOZ5 6znOSKIlbHGyZ7I7W7yFbxU5oshYfiZrKNpXiEW+b0vDo1ubjyTM5TIv1xtpeTJb5eO2 3Eb1tHyMksfobpS2gQePuoTIbW2O+zOwixno1Idi8YWsVa77f4bOy1ZFSTRYWZ8ZXLHT i/hg== 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=AL6a3mfrD+bM/yYnjRJE4SkN/bnHM3Nv1byO+diWrh4=; fh=F9mZWNpCxwgX5OHSqcg9kiy+eLd082BXxZUhmNzmaIo=; b=hcAQdD0odNtUscTIBe3CfuPM3rvNQfXQgr9LnhEit7wCo0EFOjJtzGn0rxxjLDtfyV yQ4GpKE+sKX1D9pfr9P+aZcjw99uL5TlRv3yaPgi4NHnYkvlq2NQuTMEsah4ysgWCo0F ztk90ksdO3tG4sJmI+bOZ46++pRj5Am+3WRZjLMAOpz7oAUQBt9YSh+hWAE/aFv4SCIW WMcLlst/MstZ1s7aNei59GRUdBfpNKlJsz4FR7jgt8PoQDKwZKHEapDvU0KlrmgVqIPy YlRfYpuP9f/WfjMAZ/kzVX9o2PZbpyzFbB+d3pEwloiSQ3PObEYSQVsShRJ8/jgcunvy 2PYg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=QvoF+6yc; 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:7 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 snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id dh4-20020a056a020b8400b005bdc949fee3si8360415pgb.880.2023.11.20.01.28.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 20 Nov 2023 01:28:39 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=QvoF+6yc; 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:7 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 snail.vger.email (Postfix) with ESMTP id 93A58806CC0A; Mon, 20 Nov 2023 01:28:38 -0800 (PST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232349AbjKTJ2i (ORCPT + 27 others); Mon, 20 Nov 2023 04:28:38 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38148 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232212AbjKTJ2h (ORCPT ); Mon, 20 Nov 2023 04:28:37 -0500 Received: from galois.linutronix.de (Galois.linutronix.de [IPv6:2a0a:51c0:0:12e:550::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id F39DC99; Mon, 20 Nov 2023 01:28:33 -0800 (PST) Date: Mon, 20 Nov 2023 09:28:29 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1700472511; 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=AL6a3mfrD+bM/yYnjRJE4SkN/bnHM3Nv1byO+diWrh4=; b=QvoF+6ycThwORS8pHiC2q2Rno8UACvNFfIYEJn3kpUIKHY8gA/Cis/7zWMrLR7yE2/JbU9 S/KX2R/JLyiSyuqXr2rd5eMPIbEntWc8+LNnMr+BbHACjd4BZ4uJTwGK7iees4suWXqU/u IK2Sab6gljxnqEGs2/kdpns27+Lbk8GEjI+UDCDi84lEK5TMAvVI3PDWK8jnSSdmBkSW2H vzbaNM1eS+9aoALPVrY/gmPulBWxRWv6eCxrNHdefSpwtD7vWjAG7blPxqwd9+5U9dC6aL 5zUlb7AoBWMs5AJWrb2BLMQQiDAakWZMv0l8ApWP0RGZAEKFL6LaAF+7TxMwLQ== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1700472511; 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=AL6a3mfrD+bM/yYnjRJE4SkN/bnHM3Nv1byO+diWrh4=; b=J/FkAav5MVyHeobbA2Y4TFiA5DRUraDTUgDEK75vRQBvADq6TKeW8EvoKR0tND8qDNNTWh 9p0KgSYeezj5rtDA== From: "tip-bot2 for Borislav Petkov (AMD)" Sender: tip-bot2@linutronix.de Reply-to: linux-kernel@vger.kernel.org To: linux-tip-commits@vger.kernel.org Subject: [tip: x86/cleanups] x86/mtrr: Document missing function parameters in kernel-doc Cc: kernel test robot , "Borislav Petkov (AMD)" , x86@kernel.org, linux-kernel@vger.kernel.org In-Reply-To: <202311130104.9xKAKzke-lkp@intel.com> References: <202311130104.9xKAKzke-lkp@intel.com> MIME-Version: 1.0 Message-ID: <170047250972.398.12119323318343960939.tip-bot2@tip-bot2> Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net 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 (snail.vger.email [0.0.0.0]); Mon, 20 Nov 2023 01:28:38 -0800 (PST) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1782457407694879637 X-GMAIL-MSGID: 1783074672986500755 The following commit has been merged into the x86/cleanups branch of tip: Commit-ID: 4e15b91c5b7919c530c27f39c7f2d392bf0a95e3 Gitweb: https://git.kernel.org/tip/4e15b91c5b7919c530c27f39c7f2d392bf0a95e3 Author: Borislav Petkov (AMD) AuthorDate: Mon, 13 Nov 2023 14:52:52 +01:00 Committer: Borislav Petkov (AMD) CommitterDate: Mon, 20 Nov 2023 10:19:27 +01:00 x86/mtrr: Document missing function parameters in kernel-doc Add text explaining what they do. No functional changes. Closes: https://lore.kernel.org/oe-kbuild-all/202311130104.9xKAKzke-lkp@intel.com/ Reported-by: kernel test robot Signed-off-by: Borislav Petkov (AMD) Link: https://lore.kernel.org/r/202311130104.9xKAKzke-lkp@intel.com --- arch/x86/kernel/cpu/mtrr/generic.c | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/arch/x86/kernel/cpu/mtrr/generic.c b/arch/x86/kernel/cpu/mtrr/generic.c index 2d6aa5d..d352477 100644 --- a/arch/x86/kernel/cpu/mtrr/generic.c +++ b/arch/x86/kernel/cpu/mtrr/generic.c @@ -428,6 +428,10 @@ void __init mtrr_copy_map(void) * from the x86_init.hyper.init_platform() hook. It can be called only once. * The MTRR state can't be changed afterwards. To ensure that, X86_FEATURE_MTRR * is cleared. + * + * @var: MTRR variable range array to use + * @num_var: length of the @var array + * @def_type: default caching type */ void mtrr_overwrite_state(struct mtrr_var_range *var, unsigned int num_var, mtrr_type def_type) @@ -492,13 +496,15 @@ static u8 type_merge(u8 type, u8 new_type, u8 *uniform) /** * mtrr_type_lookup - look up memory type in MTRR * + * @start: Begin of the physical address range + * @end: End of the physical address range + * @uniform: output argument: + * - 1: the returned MTRR type is valid for the whole region + * - 0: otherwise + * * Return Values: * MTRR_TYPE_(type) - The effective MTRR type for the region * MTRR_TYPE_INVALID - MTRR is disabled - * - * Output Argument: - * uniform - Set to 1 when the returned MTRR type is valid for the whole - * region, set to 0 else. */ u8 mtrr_type_lookup(u64 start, u64 end, u8 *uniform) {