From patchwork Tue Dec 6 06:31:41 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Li X-Patchwork-Id: 30100 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:f944:0:0:0:0:0 with SMTP id q4csp2663162wrr; Mon, 5 Dec 2022 22:40:54 -0800 (PST) X-Google-Smtp-Source: AA0mqf7x7cjLARWqjmsWiHwSEXWLa/TULzB19qg6J0Xif0G0w/4iU0BdNm3opQPgZFNXjfmt2Zbp X-Received: by 2002:a62:b402:0:b0:56e:8f96:6b2e with SMTP id h2-20020a62b402000000b0056e8f966b2emr89085860pfn.18.1670308854072; Mon, 05 Dec 2022 22:40:54 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1670308854; cv=none; d=google.com; s=arc-20160816; b=FQtVQ2KO0ADL/sx7+QOEqFx/4bWrMODaSqgs4HIKOMarjTNxHAqnEh+qFXzS0AWk4b lae+hXt1U7aLjnBcGGwu2EIN2JpsIDH45U8RiRd3+a7SpOKVPcvC+74kt+agzS+aQbTn WCuQ2gNA7IAdRnARV5KdzbU/gs4AgGAW9xv8KQDjkvpb2sXOLowitluYimlS0KpCVBwH 1+WF7sCvU11QvgsaaJUUamJua0HekRPyIePxHBktRtB+s/Hi1WzgbCOG8SI22P6/knMq DLRsyB+fTEeu79RUCZAzk7pBFjAKXAvi64+fSuUKg5zMujDQS68AjjAO+1FWtPHZIDzG PPmQ== 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=gtJAx2h/0Oxz0CrTXF+qwEFYiB3zfDnBNaTLMrQUaDk=; b=XYXcRZhlyFwD/S+j5eoU9lHsuVserT3T+Wn4qAkvVxgaU1PPOcz2zuCDxDHXMDmeQh N5xEW995tgLOyfhDf6lQDidMtqU5xZV7y3rtVFvPIHTZo4usC0k+r2L3N4domG6KJu6u 4/+g1j/9T7eoSZMorAkW1bHXiCrU9a9wri2hNtxlMY8V8RjH0cJRlxAc/sep3c5FMA2+ RnB1j3bWFisCsqfjGQYy0QnAn/k1dQWbEV9kFX0kOxHSTljh+IwhiaFNntYyJuaAG+f5 K90IiZ44xr48ZWUswHfVnm9+wJPosKpedE5u/AVrRQy1UYdn69w55GWD36oDxcGsIoj2 vnEw== 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 v11-20020a17090a520b00b001fe39932aa3si18561571pjh.48.2022.12.05.22.40.37; Mon, 05 Dec 2022 22:40:54 -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 S233804AbiLFGbw (ORCPT + 99 others); Tue, 6 Dec 2022 01:31:52 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58612 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229457AbiLFGbu (ORCPT ); Tue, 6 Dec 2022 01:31:50 -0500 Received: from out30-6.freemail.mail.aliyun.com (out30-6.freemail.mail.aliyun.com [115.124.30.6]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BB43821E35 for ; Mon, 5 Dec 2022 22:31:48 -0800 (PST) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R181e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045176;MF=yang.lee@linux.alibaba.com;NM=0;PH=DS;RN=8;SR=0;TI=SMTPD_---0VWdx-.o_1670308304; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0VWdx-.o_1670308304) by smtp.aliyun-inc.com; Tue, 06 Dec 2022 14:31:45 +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] nvdimm: Fix some kernel-doc comments Date: Tue, 6 Dec 2022 14:31:41 +0800 Message-Id: <20221206063142.52876-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,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?1751445777022236929?= X-GMAIL-MSGID: =?utf-8?q?1751445777022236929?= Make the description of @nvdimm to @ndd in nvdimm_init_nsarea() and nvdimm_allocated_dpa() to clear the below 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:841: warning: Function parameter or member 'ndd' not described in 'nvdimm_allocated_dpa' drivers/nvdimm/dimm_devs.c:841: warning: Excess function parameter 'nvdimm' description in 'nvdimm_allocated_dpa' Link: https://bugzilla.openanolis.cn/show_bug.cgi?id=3361 Reported-by: Abaci Robot Signed-off-by: Yang Li --- 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 1fc081dcf631..17b56171c2c2 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) { @@ -833,7 +833,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,