From patchwork Thu Dec 21 05:31:13 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 181997 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:2483:b0:fb:cd0c:d3e with SMTP id q3csp200261dyi; Wed, 20 Dec 2023 21:31:35 -0800 (PST) X-Google-Smtp-Source: AGHT+IEp2+dkKgRzq9GZk7JrlVe+Lp69VuJXTUJVx9QQuZUHkD+Kr8p0gwYfbaEKbuQyVokmTm+u X-Received: by 2002:a17:907:6d02:b0:a26:85e0:d86f with SMTP id sa2-20020a1709076d0200b00a2685e0d86fmr2298479ejc.67.1703136695125; Wed, 20 Dec 2023 21:31:35 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1703136695; cv=none; d=google.com; s=arc-20160816; b=kAHNc8kdZJ96ZAW06U1hS05oYUxYlJEx+P4L9Qque9ar0QWH2cY0SmX3ZZGlkM8fzp 7jv56kVYWjhstwWqfvfUn5e/mGZbvffQiZwjg0b67KT71iJcTibDXpX4K7EGBMf2lP6a 9k7+5Rk7t4L6HYJZw/flMxTkz4lqo9j7Pbq/CpeM4Gmk65ShQZJKdtypPRGWlx+/B+iI 1y0K/H+7KBkhKm8fhI1Es1IVePF1Vm4rNOv5JqjIF5wxct6dCxkM5XGTEBBD34rgMA54 CGLdCRmdyDbrW92iAWzZ3Ungi6fHPwJjr13RYjd7SEFV97H2vQDF82JoOCJUj4G/+SW4 e0gA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:cc:to :from:dkim-signature; bh=75JO6X/i95NW3ovT3L7Gh3dXza7a+3wXyZ9aCajAIGI=; fh=1r2vng9r+ZGtVyPw+SIBpkpQG60a30aIZkVWCz3AB5A=; b=NyxJMpKWMW47ABIOd7i0oS6Pfqbj7PSDAD3Vue3M2/S2+L1/idXmrPCSz6AJqJWhzJ KnoaFZXADHdk1Hpm0RDjWa1pJMEM1C1IIimVBpW4KgWsd7gZGLttl4V1JqHdH3W3p9IU bqBWMap9Ks+V5EBndKli47jaUi/uunrvtzm9O4RO1ItDJE+u+agSWnImdqDHqdC41Z0/ jfGLX0yxycx4r7w1ozcxCrODFnDbiiKbaYABklz63f9J9MR/+keZd/GkGYvmqYMDsIuT zt+saiPgNj9u94t+8+b2lqReTMcBf+hEBSwUFKqgTDLCdnXzbIoBu8iFCrnsLP78M6/T cBeA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=nAwN43VP; spf=pass (google.com: domain of linux-kernel+bounces-7861-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-7861-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id lv16-20020a170906bc9000b00a234083ad88si483655ejb.1051.2023.12.20.21.31.34 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 20 Dec 2023 21:31:35 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-7861-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=nAwN43VP; spf=pass (google.com: domain of linux-kernel+bounces-7861-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-7861-ouuuleilei=gmail.com@vger.kernel.org" Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id B88721F2413D for ; Thu, 21 Dec 2023 05:31:34 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id B29C0BE4B; Thu, 21 Dec 2023 05:31:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="nAwN43VP" X-Original-To: linux-kernel@vger.kernel.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DC4E4B641; Thu, 21 Dec 2023 05:31:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=75JO6X/i95NW3ovT3L7Gh3dXza7a+3wXyZ9aCajAIGI=; b=nAwN43VP3EEarggAdn3LPVcO9h AjPq9q5BHgqZnpC/NDIzhjPMbsr2qLn1y36CXuxg4OTj7XK+dOvYAYyqwTVlfZ2n1H8wev+qtRCz2 +/b6jzdfy0jAs31RGlRv4SNYzzaeLmI67tfs/J3UtPx5E1a60dpMLN/nJ5QJg2+PyAKJDcP5i5Plv 7curl6BPVTNl25OPqcj9qZ3RU8DavnpHT32JNFnvMnuep9ky4Zr/nHUnN7rkHHL2Xh4DVWaE8dudq Di1TCdBpXrOvvFUEcakhe5fmTT2kfdbnH4bGuh/R4xeZfZrTyp7ychsRD7AMYLr8h08KT1PCHhO7g B33whBVQ==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rGBeM-001kOC-2I; Thu, 21 Dec 2023 05:31:14 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Sathya Prakash Veerichetty , Kashyap Desai , Sumit Saxena , Sreekanth Reddy , mpi3mr-linuxdrv.pdl@broadcom.com, "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH] scsi: mpi3mr: fix mpi3mr_fw.c kernel-doc warnings Date: Wed, 20 Dec 2023 21:31:13 -0800 Message-ID: <20231221053113.32191-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1785868263049993285 X-GMAIL-MSGID: 1785868263049993285 Use correct format for function return values. Delete blank lines that are reported as "bad line:". mpi3mr_fw.c:482: warning: No description found for return value of 'mpi3mr_get_reply_desc' mpi3mr_fw.c:1066: warning: bad line: mpi3mr_fw.c:1109: warning: bad line: mpi3mr_fw.c:1249: warning: No description found for return value of 'mpi3mr_revalidate_factsdata' Signed-off-by: Randy Dunlap Cc: Sathya Prakash Veerichetty Cc: Kashyap Desai Cc: Sumit Saxena Cc: Sreekanth Reddy Cc: mpi3mr-linuxdrv.pdl@broadcom.com Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org --- drivers/scsi/mpi3mr/mpi3mr_fw.c | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff -- a/drivers/scsi/mpi3mr/mpi3mr_fw.c b/drivers/scsi/mpi3mr/mpi3mr_fw.c --- a/drivers/scsi/mpi3mr/mpi3mr_fw.c +++ b/drivers/scsi/mpi3mr/mpi3mr_fw.c @@ -475,7 +475,7 @@ int mpi3mr_process_admin_reply_q(struct * @op_reply_q: op_reply_qinfo object * @reply_ci: operational reply descriptor's queue consumer index * - * Returns reply descriptor frame address + * Returns: reply descriptor frame address */ static inline struct mpi3_default_reply_descriptor * mpi3mr_get_reply_desc(struct op_reply_qinfo *op_reply_q, u32 reply_ci) @@ -1063,7 +1063,6 @@ enum mpi3mr_iocstate mpi3mr_get_iocstate * @mrioc: Adapter instance reference * * Free the DMA memory allocated for IOCTL handling purpose. - * * Return: None */ @@ -1106,7 +1105,6 @@ static void mpi3mr_free_ioctl_dma_memory /** * mpi3mr_alloc_ioctl_dma_memory - Alloc memory for ioctl dma * @mrioc: Adapter instance reference - * * This function allocates dmaable memory required to handle the * application issued MPI3 IOCTL requests. @@ -1241,7 +1239,7 @@ static int mpi3mr_issue_and_process_mur( * during reset/resume * @mrioc: Adapter instance reference * - * Return zero if the new IOCFacts parameters value is compatible with + * Return: zero if the new IOCFacts parameters value is compatible with * older values else return -EPERM */ static int