linux-kernel - [PATCH] ntfs: dir.c: fix kernel-doc function parameter warnings

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <20231219045414.24670-1-rdunlap@infradead.org>
Date: Mon, 18 Dec 2023 20:54:14 -0800
From: Randy Dunlap <rdunlap@...radead.org>
To: linux-kernel@...r.kernel.org
Cc: Randy Dunlap <rdunlap@...radead.org>,
	Anton Altaparmakov <anton@...era.com>,
	Namjae Jeon <linkinjeon@...nel.org>,
	linux-ntfs-dev@...ts.sourceforge.net,
	Andrew Morton <akpm@...ux-foundation.org>
Subject: [PATCH] ntfs: dir.c: fix kernel-doc function parameter warnings

Correct the kernel-doc function parameter warnings for function
ntfs_dir_fsync() to prevent the following kernel-doc warnings:

dir.c:1489: warning: Function parameter or member 'start' not described in 'ntfs_dir_fsync'
dir.c:1489: warning: Function parameter or member 'end' not described in 'ntfs_dir_fsync'
dir.c:1489: warning: Excess function parameter 'dentry' description in 'ntfs_dir_fsync'

Signed-off-by: Randy Dunlap <rdunlap@...radead.org>
Cc: Anton Altaparmakov <anton@...era.com>
Cc: Namjae Jeon <linkinjeon@...nel.org>
Cc: linux-ntfs-dev@...ts.sourceforge.net
Cc: Andrew Morton <akpm@...ux-foundation.org>
---
 fs/ntfs/dir.c |    3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff -- a/fs/ntfs/dir.c b/fs/ntfs/dir.c
--- a/fs/ntfs/dir.c
+++ b/fs/ntfs/dir.c
@@ -1462,7 +1462,8 @@ static int ntfs_dir_open(struct inode *v
 /**
  * ntfs_dir_fsync - sync a directory to disk
  * @filp:	directory to be synced
- * @dentry:	dentry describing the directory to sync
+ * @start:	offset in bytes of the beginning of data range to sync
+ * @end:	offset in bytes of the end of data range (inclusive)
  * @datasync:	if non-zero only flush user data and not metadata
  *
  * Data integrity sync of a directory to disk.  Used for fsync, fdatasync, and