From patchwork Mon Feb 20 07:12:56 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Li X-Patchwork-Id: 59298 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp1175166wrn; Sun, 19 Feb 2023 23:29:24 -0800 (PST) X-Google-Smtp-Source: AK7set+S+8xQh8dQAymTNeItpAz9geNQXLNpKCDHAxOLVCMOADJGdObGcaSq4qXgQ1IBFzIGp6r3 X-Received: by 2002:a05:6a20:1585:b0:c7:13bf:695e with SMTP id h5-20020a056a20158500b000c713bf695emr471784pzj.18.1676878164355; Sun, 19 Feb 2023 23:29:24 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1676878164; cv=none; d=google.com; s=arc-20160816; b=XMH76UiPmkHLCEQhhODUkhtDie54JsGF2n6XatqTc/LO8x9AWQvIaW7V97OXiP7YO/ +2X+8MC9ziswlnK24XfjMCKPLWY1zrLoqwfcaOLlIDG0Jj8rfwyQNN4We5dcQIEOY4IB DOlCGJxO5Qq7eW0EeHZlms2//Hc++JEjQhWnWoIweamSoL9/EZQ4SaOEBitmVVtQa363 VBBI+nB8KRD4UiLTukoonMBndfyYtlam08esknPlyYcMo4rTmce+qIESHhacw7B6Ryro YVOfLzu03oxrK4PfbTuy/cAs5ksVYumZVbmRPrHzGyYMGkJfli8shrYVlE9hE4VXuH8L rgFw== 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=NbItOaK2uIbTzL3u9vZKczTCkhhrFycs7VzEtLL3qO4=; b=EKMPe9mgaD4vnHATVxX0JTezfuQ3bhiap/zgzjBnG8IKFyVczUk3SEKYjSgN1o3OIk QqcwPpS4ZV37qQ0BOwXxlRV4aV7I9dot8i8GwxEmgRy06fRtL1EQfa/D0RfSnWWm5s7z 4HiyA+LpDzJk9mUOsrwoqT4Uwdn2v1vvlC76PlYziq8LIoPNGWgP8g47eBOt2/x3Ngyw cKizAYjeA/pmPkn4v1CPclFHU0fKioPrhIWTxXn62eUbZiXIrzkDcKCDEfBXmma5UbDs /h9EsT3iE1yEKx3EyGxhynEjuj9glVlhjXpWZBr2k21gd6Oor5Y52DrGq1hBaCoFb9Vb mFvQ== 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 x13-20020a63cc0d000000b005023dfa3c69si7720081pgf.405.2023.02.19.23.29.11; Sun, 19 Feb 2023 23:29:24 -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 S229638AbjBTHNY (ORCPT + 99 others); Mon, 20 Feb 2023 02:13:24 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55120 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229700AbjBTHNX (ORCPT ); Mon, 20 Feb 2023 02:13:23 -0500 Received: from out30-124.freemail.mail.aliyun.com (out30-124.freemail.mail.aliyun.com [115.124.30.124]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B18E783E2 for ; Sun, 19 Feb 2023 23:13:00 -0800 (PST) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R131e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045192;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=8;SR=0;TI=SMTPD_---0Vc1ux49_1676877177; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0Vc1ux49_1676877177) by smtp.aliyun-inc.com; Mon, 20 Feb 2023 15:12:58 +0800 From: Yang Li To: dan.j.williams@intel.com Cc: vishal.l.verma@intel.com, dave.jiang@intel.com, ira.weiny@intel.com, nvdimm@lists.linux.dev, linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next] libnvdimm: Fix some kernel-doc comments Date: Mon, 20 Feb 2023 15:12:56 +0800 Message-Id: <20230220071256.72513-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_DNSWL_NONE,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?1758334197682020203?= X-GMAIL-MSGID: =?utf-8?q?1758334197682020203?= Make the description of @nvdimm to @ndd in function nvdimm_init_nsarea() and nvdimm_allocated_dpa () to silence the warnings: drivers/nvdimm/dimm_devs.c:59: warning: Function parameter or member 'ndd' not described in 'nvdimm_init_nsarea' drivers/nvdimm/dimm_devs.c:59: warning: Excess function parameter 'nvdimm' description in 'nvdimm_init_nsarea' drivers/nvdimm/dimm_devs.c:844: warning: Function parameter or member 'ndd' not described in 'nvdimm_allocated_dpa' drivers/nvdimm/dimm_devs.c:844: warning: Excess function parameter 'nvdimm' description in 'nvdimm_allocated_dpa Reported-by: Abaci Robot Link: https://bugzilla.openanolis.cn/show_bug.cgi?id=4118 Signed-off-by: Yang Li Reviewed-by: Ira Weiny --- drivers/nvdimm/dimm_devs.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/drivers/nvdimm/dimm_devs.c b/drivers/nvdimm/dimm_devs.c index 957f7c3d17ba..fc152e6016ca 100644 --- a/drivers/nvdimm/dimm_devs.c +++ b/drivers/nvdimm/dimm_devs.c @@ -53,7 +53,7 @@ static int validate_dimm(struct nvdimm_drvdata *ndd) /** * nvdimm_init_nsarea - determine the geometry of a dimm's namespace area - * @nvdimm: dimm to initialize + * @ndd: dimm to initialize */ int nvdimm_init_nsarea(struct nvdimm_drvdata *ndd) { @@ -836,7 +836,7 @@ struct resource *nvdimm_allocate_dpa(struct nvdimm_drvdata *ndd, /** * nvdimm_allocated_dpa - sum up the dpa currently allocated to this label_id - * @nvdimm: container of dpa-resource-root + labels + * @ndd: container of dpa-resource-root + labels * @label_id: dpa resource name of the form pmem- */ resource_size_t nvdimm_allocated_dpa(struct nvdimm_drvdata *ndd,