From patchwork Fri Nov 11 06:44:41 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bo Liu X-Patchwork-Id: 18505 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp580625wru; Thu, 10 Nov 2022 22:50:40 -0800 (PST) X-Google-Smtp-Source: AA0mqf6aWmJ3ITKHtYeA4/ZkpEdzItjorYJHUDVIg3YKo12pw5gZBFuQXduoPt+fxMAG/PtXEDj6 X-Received: by 2002:a17:902:9302:b0:187:3a43:3a9d with SMTP id bc2-20020a170902930200b001873a433a9dmr1141989plb.152.1668149439989; Thu, 10 Nov 2022 22:50:39 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1668149439; cv=none; d=google.com; s=arc-20160816; b=tD4Kj0FAxW04gJYgDaHV2I6Ux8epx0J86jCs4VGbPXe2OznWfGbiK732K9l94EFFnZ KMvbx55Li9UjlYxCadOVR4Msz2VzBYxbI0/tMSDnXRIpHA3dYzdxlw8y5yjSNHkYZcHw K0lOcOvWp4Sy0HGSm5G/q0AE+RWeSAm6jdrLaXXT53JycdYdOnpJAa4a5yfz9450FXPy h+Dbsm/48GWwoQo4gAYT0xYTD2Og39QciTcpKRDUTeOHNq7aAHrEq45B3yNH8FCj1zib jwaYx8d/v9QjGQTQM6B7Qj+R+wMrn87/4tj35NVF/T9LT8+7dCyNAe31b73HssiAdt+V zNLg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:abuse-reports-to:tuid:mime-version:message-id :date:subject:cc:to:from; bh=rWJ4mePApaZrGF1ghwf4iOQ3xQj1P5TBox8Mo7Cal0I=; b=lmpwEDVIJTMSWUXKHUVJuNdZMxt7C4dCdtOQR9qixqnF6ICufXnkDsqUtsKJ0JwqJH XxT2u3nZ+c6KU9bUrMANboEwL6ZLwtZ5RL1aspN0cqD6mIWM39jI0pftELIASvj+4vAf tjn5WX56mzI4szzi3rEuhoPxi0HYyfAl8vuuF+uW1NCUO8RfL7BZ8id0kNISGBOFjini 6b3HYGJvSWJWCI1jrmQHg4RL3jopyac6jkSTtPL2+NJA8Uk4fq1hYatpy4w8cAPl9Oab OprNVzrffFjLRdqR2lxsuxZP9SwjpBE3NRmZWyulFGypWgIZnnhN9N0AHSi2Bi40bWnJ ojjg== 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id 7-20020a630207000000b0047011874d9fsi1693245pgc.627.2022.11.10.22.50.26; Thu, 10 Nov 2022 22:50:39 -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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233052AbiKKGo5 (ORCPT + 99 others); Fri, 11 Nov 2022 01:44:57 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:36450 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232082AbiKKGoz (ORCPT ); Fri, 11 Nov 2022 01:44:55 -0500 Received: from unicom145.biz-email.net (unicom145.biz-email.net [210.51.26.145]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0FE466172; Thu, 10 Nov 2022 22:44:51 -0800 (PST) Received: from ([60.208.111.195]) by unicom145.biz-email.net ((D)) with ASMTP (SSL) id FHD00048; Fri, 11 Nov 2022 14:44:48 +0800 Received: from localhost.localdomain (10.200.104.97) by jtjnmail201603.home.langchao.com (10.100.2.3) with Microsoft SMTP Server id 15.1.2507.12; Fri, 11 Nov 2022 14:44:47 +0800 From: Bo Liu To: , , CC: , , Bo Liu Subject: [PATCH] async_tx: Fix some kernel-doc warnings Date: Fri, 11 Nov 2022 01:44:41 -0500 Message-ID: <20221111064441.2926-1-liubo03@inspur.com> X-Mailer: git-send-email 2.18.2 MIME-Version: 1.0 X-Originating-IP: [10.200.104.97] tUid: 20221111144448bc1def9f749add3061855c42b4d1d967 X-Abuse-Reports-To: service@corp-email.com Abuse-Reports-To: service@corp-email.com X-Complaints-To: service@corp-email.com X-Report-Abuse-To: service@corp-email.com X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_LOW, SPF_HELO_NONE,SPF_PASS 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?1749181466670783275?= X-GMAIL-MSGID: =?utf-8?q?1749181466670783275?= Fixes the following W=1 kernel build warning(s): crypto/async_tx/async_tx.c:136: warning: cannot understand function prototype: 'enum submit_disposition ' crypto/async_tx/async_tx.c:264: warning: Function parameter or member 'tx' not described in 'async_tx_quiesce' Signed-off-by: Bo Liu --- crypto/async_tx/async_tx.c | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/crypto/async_tx/async_tx.c b/crypto/async_tx/async_tx.c index 9256934312d7..8840731cefbb 100644 --- a/crypto/async_tx/async_tx.c +++ b/crypto/async_tx/async_tx.c @@ -33,7 +33,7 @@ static void __exit async_tx_exit(void) module_init(async_tx_init); module_exit(async_tx_exit); -/** +/* * __async_tx_find_channel - find a channel to carry out the operation or let * the transaction execute synchronously * @submit: transaction dependency and submission modifiers @@ -55,7 +55,7 @@ EXPORT_SYMBOL_GPL(__async_tx_find_channel); #endif -/** +/* * async_tx_channel_switch - queue an interrupt descriptor with a dependency * pre-attached. * @depend_tx: the operation that must finish before the new operation runs @@ -123,7 +123,7 @@ async_tx_channel_switch(struct dma_async_tx_descriptor *depend_tx, } -/** +/* * submit_disposition - flags for routing an incoming operation * @ASYNC_TX_SUBMITTED: we were able to append the new operation under the lock * @ASYNC_TX_CHANNEL_SWITCH: when the lock is dropped schedule a channel switch @@ -209,7 +209,7 @@ async_tx_submit(struct dma_chan *chan, struct dma_async_tx_descriptor *tx, } EXPORT_SYMBOL_GPL(async_tx_submit); -/** +/* * async_trigger_callback - schedules the callback function to be run * @submit: submission and completion parameters * @@ -256,9 +256,9 @@ async_trigger_callback(struct async_submit_ctl *submit) } EXPORT_SYMBOL_GPL(async_trigger_callback); -/** +/* * async_tx_quiesce - ensure tx is complete and freeable upon return - * @tx - transaction to quiesce + * @*tx - transaction to quiesce */ void async_tx_quiesce(struct dma_async_tx_descriptor **tx) {