Received: by 2002:a05:6a10:206:0:0:0:0 with SMTP id 6csp1690842pxj; Fri, 18 Jun 2021 12:46:37 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxnsBcqqVjMM9T9wkRLqLORGHU4RpalxdRa+8mhQLqQkk8CxeJ+BGrH/6iN61vNoT3b2x/2 X-Received: by 2002:a17:906:3b13:: with SMTP id g19mr11333720ejf.360.1624045597725; Fri, 18 Jun 2021 12:46:37 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1624045597; cv=none; d=google.com; s=arc-20160816; b=RIgFEQLgVlxcSNyBoI38Li6TtmUuqBzt9ZraE/Z97PSXs4mqmwtf8Hh+8c7ludlDvi IJM+loKgfSGuHW4hX8OAsQnl5HN8bMn+N5OEkDDScc2GgwustV/qI+OmtN47IIkw3nfd WIK9LNcJitsMfFu/awa9azBoacVW6I1ojOuFnABpfSd0+jozP/0ifvDqa4tZPphYjvcN nDEFbqU0mVxsNPzCVJIFaZwcwQ4vPHIUXaKz8v3U1dnYt9g1ZX3I1FRyhs+iRoZ9tsgN HF3TBHx9YhYHMFaOU+s0wprz/0K5beN8AIOD7WfOL8quF7wC7lm/jOLn7GOYfCkdiDea 8xoA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:content-language :in-reply-to:mime-version:user-agent:date:message-id:from:references :to:subject:ironport-sdr:ironport-sdr; bh=B0PuunadQ8Z+gkrC2YZ32ZlgZmlddPJEpC/uE+YP3go=; b=LZvyRWzzbCfajwqqF3Fth/oiH9BXpcoca1xg/29bQ/2ePshitsQKLOoQBDRQleKGjM LUffBk/uIPqsCFfl1tbjmnPEmwyc/FP/PEwmpYegVlfk2ToovkIGy6UCyvLMH16dUUTo KJkg8xiYwFEPyuJ1OPrI9Hm8uaHtw6GUVP9FHBK/nUDKDeVjvx3BykBNRfipncTi6d8V 4wMeKd5F1E7T8UI4iF1o1CBLTsJcruJtezU0n+oCXhmGSnSIjfUt6kiHkZwlKvAVEuzn ZSPRYcqiA4IGnjXeXOxNvDb2CVi02pBSidylLQX3EXMsxnKrV1gbnSsLqEL5J4aOVko0 6rXg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=intel.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id f18si9317193edq.570.2021.06.18.12.46.14; Fri, 18 Jun 2021 12:46:37 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233357AbhFRS5Z (ORCPT + 99 others); Fri, 18 Jun 2021 14:57:25 -0400 Received: from mga17.intel.com ([192.55.52.151]:53236 "EHLO mga17.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231689AbhFRS5Z (ORCPT ); Fri, 18 Jun 2021 14:57:25 -0400 IronPort-SDR: 8aWrnFxclmeZRzQd4lH3BVcSBvU2QNsrs2TBM3Vg5qeyxaK9EtGYo4q5lVVo4BEDYXAic1XTRV i/+xjbbr6lnw== X-IronPort-AV: E=McAfee;i="6200,9189,10019"; a="186983129" X-IronPort-AV: E=Sophos;i="5.83,284,1616482800"; d="scan'208";a="186983129" Received: from orsmga001.jf.intel.com ([10.7.209.18]) by fmsmga107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 18 Jun 2021 11:55:15 -0700 IronPort-SDR: ZkFD3CWwYBzYk5rAa38DDBPuBN6X3wrD+GCVgp8d31ytg/x4qKY7cvvNvp/1JBXoRykhawn8XS GcwCMmDs0SWA== X-IronPort-AV: E=Sophos;i="5.83,284,1616482800"; d="scan'208";a="485786540" Received: from rchatre-mobl3.amr.corp.intel.com (HELO [10.212.236.226]) ([10.212.236.226]) by orsmga001-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 18 Jun 2021 11:55:14 -0700 Subject: Re: [PATCH v4] x86/resctrl: Fix kernel-doc in pseudo_lock.c To: "Fabio M. De Francesco" , Fenghua Yu , Thomas Gleixner , Ingo Molnar , Borislav Petkov , x86@kernel.org, "H. Peter Anvin" , linux-kernel@vger.kernel.org References: <20210616181530.4094-1-fmdefrancesco@gmail.com> From: Reinette Chatre Message-ID: <1bdf84eb-b7d9-a2eb-88db-9ca55aa38d08@intel.com> Date: Fri, 18 Jun 2021 11:55:14 -0700 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.11.0 MIME-Version: 1.0 In-Reply-To: <20210616181530.4094-1-fmdefrancesco@gmail.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi Fabio, On 6/16/2021 11:15 AM, Fabio M. De Francesco wrote: > Add undocumented parameters detected by scripts/kernel-doc. > > Signed-off-by: Fabio M. De Francesco Before this patch: $ scripts/kernel-doc -none arch/x86/kernel/cpu/resctrl/pseudo_lock.c arch/x86/kernel/cpu/resctrl/pseudo_lock.c:169: warning: cannot understand function prototype: 'struct pseudo_lock_pm_req ' arch/x86/kernel/cpu/resctrl/pseudo_lock.c:201: warning: Function parameter or member 'plr' not described in 'pseudo_lock_cstates_constrain' arch/x86/kernel/cpu/resctrl/pseudo_lock.c:529: warning: Function parameter or member 'rdtgrp' not described in 'rdtgroup_monitor_in_progress' arch/x86/kernel/cpu/resctrl/pseudo_lock.c:529: warning: Excess function parameter 'r' description in 'rdtgroup_monitor_in_progress' arch/x86/kernel/cpu/resctrl/pseudo_lock.c:1152: warning: Function parameter or member 'rdtgrp' not described in 'pseudo_lock_measure_cycles' arch/x86/kernel/cpu/resctrl/pseudo_lock.c:1152: warning: Function parameter or member 'sel' not described in 'pseudo_lock_measure_cycles' $ After this patch: $ scripts/kernel-doc -none arch/x86/kernel/cpu/resctrl/pseudo_lock.c $ Thank you very much. Reviewed-by: Reinette Chatre Reinette