From patchwork Thu Oct 12 02:48:43 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 151672 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2908:b0:403:3b70:6f57 with SMTP id ib8csp945821vqb; Wed, 11 Oct 2023 19:50:48 -0700 (PDT) X-Google-Smtp-Source: AGHT+IF4qttDJaP9gT+2ix9lKfPAgv4WP39cuOi3+cYbvpMGJ8sTQGEuyg1ZD6RsZXMNgWy+E8nC X-Received: by 2002:a05:6358:cc28:b0:143:92d5:1fdb with SMTP id gx40-20020a056358cc2800b0014392d51fdbmr20544093rwb.0.1697079047705; Wed, 11 Oct 2023 19:50:47 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697079047; cv=none; d=google.com; s=arc-20160816; b=lPYiMI1pV1WHaSsIcH7FI7T+XnseD76wCt1dXsCT3h/N1tk3LBUwJVBs9bOhWpjyil MJyXT5I7LFmNrmggljpEe7IMd+NA0dydkfD6K9eph4IOFZ4k64kFSBA561tV0loTggSe h8TCgpMK7Ac7W+Xzc+jD+ligXjaX4+e1XvKdXMGDKrdo69IDy0fhx3HSpeQ5bOE4D8st ky0CjApexlV3LYGoviYWvhWAEXH1ore1nO0Ewo6htxPN1qS1XENSqO/KLmr8QlEryNJf sGNrk88mhunT6GL7EMhD/vaw70IFpE4Fky/WrlQk3IIdL4/sUFCIcs+cgxe1xfIIKptC Wq9w== 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 :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=Dn9zCcvrcxqpmwWd8vgmyiOH+lNjJ7UYM9Um5cJkFUc=; fh=ZbvLlniUsxGLukUHdtjOOGtwnXITbomFxOFWw6lgkU0=; b=ip6q44BV1kZ03ANxxNnMfjbUa0wl9P27Bi5xTDvMzu9D+LwETfBq+85d2TykJoTy12 uiPepCcZj2LitMbdntI6x3bsl4U6b1G2K6/2yTmOBa7az/DxqOLm7yBwweq4iWKDD6wT VQmf8cC4qZ1A/Tum+Ko269lFVj/O/QpYRIpNyJksQgpwfcBjwzoq/0QvUu6/8B8kdOQ9 hr1IJUdizAQwLG7scJG7AvPtt/Npw+Uf/zNgvJ8kISvEkSE5YdrO8EcwjWXOoBpxj5My OJj7Kwotqn9Q8kGfAEDA/hhTIqWvfpAWNPGf3JGPuY3lsib7qysDgOoJGRa1EquRKlwJ 0h0A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Dmc1dCSA; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from groat.vger.email (groat.vger.email. [23.128.96.35]) by mx.google.com with ESMTPS id cf5-20020a056a02084500b005a0110eb91dsi1123977pgb.560.2023.10.11.19.50.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Oct 2023 19:50:47 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) client-ip=23.128.96.35; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Dmc1dCSA; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id D828D8086503; Wed, 11 Oct 2023 19:50:13 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1376873AbjJLCtH (ORCPT + 18 others); Wed, 11 Oct 2023 22:49:07 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56878 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1347034AbjJLCsv (ORCPT ); Wed, 11 Oct 2023 22:48:51 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 01F76BA for ; Wed, 11 Oct 2023 19:48:49 -0700 (PDT) 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:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=Dn9zCcvrcxqpmwWd8vgmyiOH+lNjJ7UYM9Um5cJkFUc=; b=Dmc1dCSAj9y4yj18SrmRTBq5DX QyQgL9ZcjrfABJ2mJhXR55d7MjfpBZLI0Z9IYQ1EdineFmwnZrfJEgbqZ1JcUwnwTTNZdxG5zKzIp NC02PoJBvDRgnHl7cvLD6MBdFqh/KevDaw7n56YS/gKJhDHceEANfRdhwQICGmP+rbWqA7QW/zMdk jlOCXF6JBqXseT7ocQR2CphbizutlWw4aOU6hEqtkgm2LfKzY+EuuNp4LSONnzhQ85otJ31w1q7ci OZj/mXKC3HGP2K1RbdyaxJjfojrgX4f6dy9bcXwq8dMvH9EvI3d1bxQnJrHfHqILjf11WlQYdNV0V bqvmA6fw==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1qqlkm-00HDiv-2e; Thu, 12 Oct 2023 02:48:48 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tomas Winkler , Arnd Bergmann , Greg Kroah-Hartman Subject: [PATCH 5/7] misc: mei: hw-me.c: fix kernel-doc warnings Date: Wed, 11 Oct 2023 19:48:43 -0700 Message-ID: <20231012024845.29169-6-rdunlap@infradead.org> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20231012024845.29169-1-rdunlap@infradead.org> References: <20231012024845.29169-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Wed, 11 Oct 2023 19:50:13 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779516359467778508 X-GMAIL-MSGID: 1779516359467778508 Fix kernel-doc warnings in hw-me.c: hw-me.c:1391: warning: contents before sections hw-me.c:1475: warning: contents before sections hw-me.c:1501: warning: contents before sections hw-me.c:1525: warning: contents before sections Signed-off-by: Randy Dunlap Cc: Tomas Winkler Cc: Arnd Bergmann Cc: Greg Kroah-Hartman --- drivers/misc/mei/hw-me.c | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff -- a/drivers/misc/mei/hw-me.c b/drivers/misc/mei/hw-me.c --- a/drivers/misc/mei/hw-me.c +++ b/drivers/misc/mei/hw-me.c @@ -1379,6 +1379,8 @@ EXPORT_SYMBOL_GPL(mei_me_irq_thread_hand /** * mei_me_polling_thread - interrupt register polling thread * + * @_dev: mei device + * * The thread monitors the interrupt source register and calls * mei_me_irq_thread_handler() to handle the firmware * input. @@ -1388,8 +1390,6 @@ EXPORT_SYMBOL_GPL(mei_me_irq_thread_hand * time increases yet again by MEI_POLLING_TIMEOUT_ACTIVE * up to MEI_POLLING_TIMEOUT_IDLE. * - * @_dev: mei device - * * Return: always 0 */ int mei_me_polling_thread(void *_dev) @@ -1468,12 +1468,12 @@ static const struct mei_hw_ops mei_me_hw /** * mei_me_fw_type_nm() - check for nm sku * + * @pdev: pci device + * * Read ME FW Status register to check for the Node Manager (NM) Firmware. * The NM FW is only signaled in PCI function 0. * __Note__: Deprecated by PCH8 and newer. * - * @pdev: pci device - * * Return: true in case of NM firmware */ static bool mei_me_fw_type_nm(const struct pci_dev *pdev) @@ -1494,12 +1494,12 @@ static bool mei_me_fw_type_nm(const stru /** * mei_me_fw_type_sps_4() - check for sps 4.0 sku * + * @pdev: pci device + * * Read ME FW Status register to check for SPS Firmware. * The SPS FW is only signaled in the PCI function 0. * __Note__: Deprecated by SPS 5.0 and newer. * - * @pdev: pci device - * * Return: true in case of SPS firmware */ static bool mei_me_fw_type_sps_4(const struct pci_dev *pdev) @@ -1519,11 +1519,11 @@ static bool mei_me_fw_type_sps_4(const s /** * mei_me_fw_type_sps_ign() - check for sps or ign sku * + * @pdev: pci device + * * Read ME FW Status register to check for SPS or IGN Firmware. * The SPS/IGN FW is only signaled in pci function 0 * - * @pdev: pci device - * * Return: true in case of SPS/IGN firmware */ static bool mei_me_fw_type_sps_ign(const struct pci_dev *pdev)