From patchwork Wed Jul 12 07:46:37 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Li X-Patchwork-Id: 118904 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:a6b2:0:b0:3e4:2afc:c1 with SMTP id c18csp983415vqm; Wed, 12 Jul 2023 01:02:19 -0700 (PDT) X-Google-Smtp-Source: APBJJlHYQj0CGFM0xvC61YWBr9aU0oLkypMDMGtPUv6w3zxOPEINnVxCpLMr+qJCaGmzQvQasYof X-Received: by 2002:a05:6512:b8b:b0:4fb:8ff3:1f72 with SMTP id b11-20020a0565120b8b00b004fb8ff31f72mr18691631lfv.1.1689148939566; Wed, 12 Jul 2023 01:02:19 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1689148939; cv=none; d=google.com; s=arc-20160816; b=kqpyCWCBOh5USwXtMVF1hhSactvUHgG+cQ9EnJGqAZNEFaze8O5oh9LcTuz4Vd6+Gm obZ+O8+Qe+LsdUxCCOT/jz4tEpHXy+9I445ULyXWdQLXVh3DcTkuN/dibVx4SfTI3uuj Khc8TARYG7uR+B0q7LYxFiRwQRs74BDRbve+N17ujlaHVP4svX386UEchzWo54j7McYw Iysdppty0oGxoD5wZkuI1Vo5/P75kV6Ph5zqkxM2iHNcXpxbqdtJ8J/q5/NgiZqZQyyq 0azWA0zT5V4OxxaLf4m9WhgJIHirOlcg3nae3MvLYI84LEC7LJJtbEZN3Y9t13n9oCUH TzNQ== 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=wUP25fjXsITKfFcPKUKIpm5tRdcQbV6rJVYA3rvx++A=; fh=aFjUZQ6Li6HM5CXl8iqN6G2CeUwVGKoxMV7X8urqtVY=; b=wfp0bCVVPUWQSm5bNK9hpcNlPf/fHbY2WIy/F5RyznVt2ij4gRX2OrRyoqIZrQqdCB z+sWuuJjXojIqY4cJC2So5kEEm3uQVo7MXR/7ULyp4cqJgMO2zbJC96I6MQDbqk/ruYe 1etOf0bUSz35fiLVPWHpBbWFuUNFeV8wXU6j5lOsVpOPN8mmBzCXAGyTXj6dhxAlqzDs xBYVmYJ49lwNG86Bwh8yBV8vSkWbhX9pRfbUi9c6W5glsXHBrZQsX39NZg43mG/gBSVg MB9FnkBUQQffLOtfuxKNRLgiGXUa36iXghyfJ0bILIe6UkzwkY+gq4AWxksgu/4IslGd MEHw== 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 i26-20020a50fc1a000000b0051ddbb7c57csi4214447edr.460.2023.07.12.01.01.49; Wed, 12 Jul 2023 01:02:19 -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 S231463AbjGLHq7 (ORCPT + 99 others); Wed, 12 Jul 2023 03:46:59 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33440 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231825AbjGLHqp (ORCPT ); Wed, 12 Jul 2023 03:46:45 -0400 Received: from out30-97.freemail.mail.aliyun.com (out30-97.freemail.mail.aliyun.com [115.124.30.97]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 13B5619B6 for ; Wed, 12 Jul 2023 00:46:42 -0700 (PDT) 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=ay29a033018045170;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=6;SR=0;TI=SMTPD_---0VnBzeAQ_1689147998; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0VnBzeAQ_1689147998) by smtp.aliyun-inc.com; Wed, 12 Jul 2023 15:46:39 +0800 From: Yang Li To: richard@nod.at Cc: chengzhihao1@huawei.com, linux-mtd@lists.infradead.org, linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next v2] ubifs: Fix some kernel-doc comments Date: Wed, 12 Jul 2023 15:46:37 +0800 Message-Id: <20230712074637.129248-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_BLOCKED,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE,UNPARSEABLE_RELAY,URIBL_BLOCKED, 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: 1771201038413114823 X-GMAIL-MSGID: 1771201038413114823 Add description of @time and @flags in ubifs_update_time(). to silence the warnings: fs/ubifs/file.c:1383: warning: Function parameter or member 'time' not described in 'ubifs_update_time' fs/ubifs/file.c:1383: warning: Function parameter or member 'flags' not described in 'ubifs_update_time' Reported-by: Abaci Robot Closes: https://bugzilla.openanolis.cn/show_bug.cgi?id=5848 Signed-off-by: Yang Li Reviewed-by: Zhihao Cheng --- --change in v2: According to Zhihao's suggestion, add a more accurate description to @flags. fs/ubifs/file.c | 3 +++ 1 file changed, 3 insertions(+) diff --git a/fs/ubifs/file.c b/fs/ubifs/file.c index 436b27d7c58f..860497532555 100644 --- a/fs/ubifs/file.c +++ b/fs/ubifs/file.c @@ -1375,6 +1375,9 @@ static inline int mctime_update_needed(const struct inode *inode, /** * ubifs_update_time - update time of inode. * @inode: inode to update + * @time: timespec structure to hold the current time value + * @flags: time updating control flag determines updating + * which time fields of @inode * * This function updates time of the inode. */