From patchwork Thu Jul 27 02:08:40 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Li X-Patchwork-Id: 126602 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:a985:0:b0:3e4:2afc:c1 with SMTP id t5csp799888vqo; Wed, 26 Jul 2023 19:39:20 -0700 (PDT) X-Google-Smtp-Source: APBJJlEFMsgmXQQ+EvK4gWIAl67gtbory0nsECv54xNmOAMvUn1NFUaOJLFkypZe2jXqyhUNSlBa X-Received: by 2002:a05:620a:4116:b0:767:3a10:d6de with SMTP id j22-20020a05620a411600b007673a10d6demr5174600qko.58.1690425560418; Wed, 26 Jul 2023 19:39:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1690425560; cv=none; d=google.com; s=arc-20160816; b=vpClKEiTw2tSVHEo8QSIDvTRjAy+YYfB3u6bkdVDVsLRwed+fXzkLtZri917kemDmJ NOcpOs5RP4N4MnGeUNfAhJ/illBrxL2zmgwVVtwU95vOi6cC2FveShitwhGDsCm5EPsR mTz8Q68zn6j/HhZEoCV1BaFSEIXjoDbncGA4bbrCz3VpkHyGNbhspG7CkHuh31T6gk7/ bo9zln+x8mYmSDTxP17dcHUUNmM+IkAwUawWNTDUwJ3vTdNgi7dhAjH+5q3s9KylNqNu bNPk/Jp7m0bFTYllsk6nCR6kytCv/csooutXdVYwjgK+K3OuC+oU4t6/EeIUL7eXDX9w MyZw== 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=4MPBaRKmakclpUeaiUGAu9sI8nHTUazWqmqTXnUazOQ=; fh=XjFs0gJ8ChDn4egVQ92bPLNfdyiY6bXDkYjjk+eIMBM=; b=NEhmEOxyKvfR/MMbupew8VQRWYqCfU6zgOeWKzEkuzartQ/UMBpnNEeQG/Ana7QZeq VVDValHIv/xgLIr8MHFz43OLDkMypI6XiJzX/6NTr3ardMvUvEtma7JB6ZUF0twzx6W6 bLQHzhUoJuW3q9ledRT31uC0u6Mubkf4DvWJ2oPs3vTps/WO9szf6lO/nCVXJfz0ujfV 6lfMiM2rJfj883SQXhWXALnk5IYByTu07Wxq3OMhJPH5kmO47DnVl79Iz25SlVOUVXLw J4dZjSJTndb6uStI2YT/i6hxnOUwvXEUtAKEQdX5rmA2qUyRuto4MHEMJ2ZTihc1gpxh mRpQ== 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 a5-20020a634d05000000b0054ff53233f2si319273pgb.567.2023.07.26.19.39.05; Wed, 26 Jul 2023 19:39:20 -0700 (PDT) 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 S230289AbjG0CIr (ORCPT + 99 others); Wed, 26 Jul 2023 22:08:47 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40250 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230093AbjG0CIq (ORCPT ); Wed, 26 Jul 2023 22:08:46 -0400 Received: from out30-119.freemail.mail.aliyun.com (out30-119.freemail.mail.aliyun.com [115.124.30.119]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CD3EA1BDA for ; Wed, 26 Jul 2023 19:08:44 -0700 (PDT) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R101e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045176;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=5;SR=0;TI=SMTPD_---0VoIhlPv_1690423721; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0VoIhlPv_1690423721) by smtp.aliyun-inc.com; Thu, 27 Jul 2023 10:08:41 +0800 From: Yang Li To: mporter@kernel.crashing.org, alex.bou9@gmail.com Cc: linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next] rapidio/tsi721: Fix some kernel-doc comments Date: Thu, 27 Jul 2023 10:08:40 +0800 Message-Id: <20230727020840.87684-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, T_SCC_BODY_TEXT_LINE,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: INBOX X-GMAIL-THRID: 1772539672569756527 X-GMAIL-MSGID: 1772539672569756527 Fix some kernel-doc comments to silence the warnings: drivers/rapidio/devices/tsi721.c:215: warning: Function parameter or member 'data' not described in 'tsi721_cread_dma' drivers/rapidio/devices/tsi721.c:215: warning: Excess function parameter 'val' description in 'tsi721_cread_dma' drivers/rapidio/devices/tsi721.c:238: warning: Function parameter or member 'data' not described in 'tsi721_cwrite_dma' drivers/rapidio/devices/tsi721.c:238: warning: Excess function parameter 'val' description in 'tsi721_cwrite_dma' drivers/rapidio/devices/tsi721.c:2548: warning: Function parameter or member 'attr' not described in 'tsi721_query_mport' drivers/rapidio/devices/tsi721.c:2548: warning: Excess function parameter 'mbox' description in 'tsi721_query_mport' Reported-by: Abaci Robot Closes: https://bugzilla.openanolis.cn/show_bug.cgi?id=5997 Signed-off-by: Yang Li Tested-by: Randy Dunlap Reviewed-by: Randy Dunlap --- drivers/rapidio/devices/tsi721.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/drivers/rapidio/devices/tsi721.c b/drivers/rapidio/devices/tsi721.c index 83323c3d10af..3e67001702bc 100644 --- a/drivers/rapidio/devices/tsi721.c +++ b/drivers/rapidio/devices/tsi721.c @@ -205,7 +205,7 @@ static int tsi721_maint_dma(struct tsi721_device *priv, u32 sys_size, * @hopcount: Number of hops to target device * @offset: Offset into configuration space * @len: Length (in bytes) of the maintenance transaction - * @val: Location to be read into + * @data: Location to be read into * * Generates a RapidIO maintenance read transaction. * Returns %0 on success and %-EINVAL or %-EFAULT on failure. @@ -228,7 +228,7 @@ static int tsi721_cread_dma(struct rio_mport *mport, int index, u16 destid, * @hopcount: Number of hops to target device * @offset: Offset into configuration space * @len: Length (in bytes) of the maintenance transaction - * @val: Value to be written + * @data: Value to be written * * Generates a RapidIO maintenance write transaction. * Returns %0 on success and %-EINVAL or %-EFAULT on failure. @@ -2539,7 +2539,7 @@ static int tsi721_messages_init(struct tsi721_device *priv) /** * tsi721_query_mport - Fetch inbound message from the Tsi721 MSG Queue * @mport: Master port implementing the Inbound Messaging Engine - * @mbox: Inbound mailbox number + * @attr: RIO mport device attributes * * Returns pointer to the message on success or NULL on failure. */