From patchwork Wed Feb 8 02:31:58 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Li X-Patchwork-Id: 54145 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp3210857wrn; Tue, 7 Feb 2023 18:40:57 -0800 (PST) X-Google-Smtp-Source: AK7set9FA2NHEK+nBQqEjpD7Y0fq+htVL5FAhfrrwLJSIZ+yB7RzC4sdqkL8JIuIyBl1eOyo9Za6 X-Received: by 2002:a17:90b:3892:b0:230:8519:3e2e with SMTP id mu18-20020a17090b389200b0023085193e2emr6761121pjb.8.1675824057128; Tue, 07 Feb 2023 18:40:57 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1675824057; cv=none; d=google.com; s=arc-20160816; b=t/0eVYFmO82o+xcOdXhkFgmKnhmv0lcHT84liE/WbiryE94lu/vpzzihdAPzHP2vRQ mwujuy16piEY7MDungfbc7VHze3si0csd38TuieU4rYOk1AObbvymUDnAVDzAIPswyNq 4GwnnqASrwC9Pm3kfRCGmKNlZ9YL7vpnPA8OeSC0bkNHuKGkeWWm2FQWpLTLPb2ep+l2 fczN3+1WUj5kdV7GHmJbI3Pj3cc2emSMmDh4SylsJ5gOe32VZuqXIM0fHgTk3LOyeIGe U+qvqaP87a5l6qR4zFkC+PkND+Vn7XQD0zUwIZL/DEAKBehI+IDSt3fnhAugy3FGckYh 4gTA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from; bh=geF0F1GR8RkjszCbHL0IUwiBVgCsRlHEDqsB8ifCwDE=; b=J2tLi2Jq891smC3HxBw7fYCmjk9Y1o4SXZnmozqniJI3XA1n9V1iBoqZsL6/Aatje2 Nq1HugNJZydtanAmTP1OALCPkAwsQ8H+idx16BEg8UXgvqQsdGFiw38Ng0u3v5dsra9F Ko5HXBVMUvXs+CtxmezcaEQ3Cr0s3f2Dv3g5RB0F+D5V6L9CpZYoKlDk1o3WLtLvirQm u1jyAd1PvwubvNL0sJ8gLrckIFkUEHZTBxX2OgGswFgopeR3mcg/eXbH1IYemkngur6F hWYM6Qe8wgI6T1IwH7iecypEkLljb9AXpNZadlW+oy3k64xv1Zf486uWLGS4D9vpmnTw shyg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id n10-20020a638f0a000000b004ded6db2d2csi15939849pgd.473.2023.02.07.18.40.44; Tue, 07 Feb 2023 18:40:57 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229807AbjBHCcM (ORCPT + 99 others); Tue, 7 Feb 2023 21:32:12 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48574 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230248AbjBHCcJ (ORCPT ); Tue, 7 Feb 2023 21:32:09 -0500 Received: from out30-118.freemail.mail.aliyun.com (out30-118.freemail.mail.aliyun.com [115.124.30.118]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C536A199EF; Tue, 7 Feb 2023 18:32:01 -0800 (PST) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R911e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018046059;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=6;SR=0;TI=SMTPD_---0Vb9eAsn_1675823518; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0Vb9eAsn_1675823518) by smtp.aliyun-inc.com; Wed, 08 Feb 2023 10:31:59 +0800 From: Yang Li To: rafael@kernel.org Cc: lenb@kernel.org, linux-acpi@vger.kernel.org, linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next] ACPI: CPPC: Fix some kernel-doc comments Date: Wed, 8 Feb 2023 10:31:58 +0800 Message-Id: <20230208023158.69934-1-yang.lee@linux.alibaba.com> X-Mailer: git-send-email 2.20.1.7.g153144c MIME-Version: 1.0 X-Spam-Status: No, score=-9.9 required=5.0 tests=BAYES_00, ENV_AND_HDR_SPF_MATCH,RCVD_IN_MSPIKE_H2,SPF_HELO_NONE,SPF_PASS, UNPARSEABLE_RELAY,USER_IN_DEF_SPF_WL 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-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1757228886548959713?= X-GMAIL-MSGID: =?utf-8?q?1757228886548959713?= Add the description of @pcc_ss_id in pcc_data_alloc(). Add the description of @cpu_num in cppc_get_transition_latency(). clear the below warnings: drivers/acpi/cppc_acpi.c:607: warning: Function parameter or member 'pcc_ss_id' not described in 'pcc_data_alloc' drivers/acpi/cppc_acpi.c:1616: warning: Function parameter or member 'cpu_num' not described in 'cppc_get_transition_latency' Reported-by: Abaci Robot Link: https://bugzilla.openanolis.cn/show_bug.cgi?id=3983 Signed-off-by: Yang Li --- drivers/acpi/cppc_acpi.c | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/drivers/acpi/cppc_acpi.c b/drivers/acpi/cppc_acpi.c index 02d83c807271..bc7b304944a7 100644 --- a/drivers/acpi/cppc_acpi.c +++ b/drivers/acpi/cppc_acpi.c @@ -596,6 +596,9 @@ bool __weak cpc_supported_by_cpu(void) /** * pcc_data_alloc() - Allocate the pcc_data memory for pcc subspace * + * @pcc_ss_id: The PCC Subspace index as parsed in the PCC client + * ACPI package. + * * Check and allocate the cppc_pcc_data memory. * In some processor configurations it is possible that same subspace * is shared between multiple CPUs. This is seen especially in CPUs @@ -1604,6 +1607,8 @@ EXPORT_SYMBOL_GPL(cppc_set_perf); /** * cppc_get_transition_latency - returns frequency transition latency in ns * + * @cpu_num: the number of the specified cpu for per_cpu() + * * ACPI CPPC does not explicitly specify how a platform can specify the * transition latency for performance change requests. The closest we have * is the timing information from the PCCT tables which provides the info