Commit da5c1c0b authored Oct 13, 2020 by Randy Dunlap Committed by Linus Torvalds Oct 13, 2020

fs/xattr.c: fix kernel-doc warnings for setxattr & removexattr



Fix kernel-doc warnings in fs/xattr.c:

../fs/xattr.c:251: warning: Function parameter or member 'dentry' not described in '__vfs_setxattr_locked'
../fs/xattr.c:251: warning: Function parameter or member 'name' not described in '__vfs_setxattr_locked'
../fs/xattr.c:251: warning: Function parameter or member 'value' not described in '__vfs_setxattr_locked'
../fs/xattr.c:251: warning: Function parameter or member 'size' not described in '__vfs_setxattr_locked'
../fs/xattr.c:251: warning: Function parameter or member 'flags' not described in '__vfs_setxattr_locked'
../fs/xattr.c:251: warning: Function parameter or member 'delegated_inode' not described in '__vfs_setxattr_locked'
../fs/xattr.c:458: warning: Function parameter or member 'dentry' not described in '__vfs_removexattr_locked'
../fs/xattr.c:458: warning: Function parameter or member 'name' not described in '__vfs_removexattr_locked'
../fs/xattr.c:458: warning: Function parameter or member 'delegated_inode' not described in '__vfs_removexattr_locked'

Fixes: 08b5d501 ("xattr: break delegations in {set,remove}xattr")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Cc: Al Viro <viro@zeniv.linux.org.uk>
Cc: Frank van der Linden <fllinden@amazon.com>
Cc: Chuck Lever <chuck.lever@oracle.com>
Link: http://lkml.kernel.org/r/7a3dd5a2-5787-adf3-d525-c203f9910ec4@infradead.org


Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

parent 8dd71b25

fs/xattr.c

+11 −11

Original line number	Diff line number	Diff line
		@@ -232,15 +232,15 @@ int __vfs_setxattr_noperm(struct dentry dentry, const char name,
		}

		/**
		* __vfs_setxattr_locked: set an extended attribute while holding the inode
		* __vfs_setxattr_locked - set an extended attribute while holding the inode
		* lock
		*
		* @dentry - object to perform setxattr on
		* @name - xattr name to set
		* @value - value to set @name to
		* @size - size of @value
		* @flags - flags to pass into filesystem operations
		* @delegated_inode - on return, will contain an inode pointer that
		* @dentry: object to perform setxattr on
		* @name: xattr name to set
		* @value: value to set @name to
		* @size: size of @value
		* @flags: flags to pass into filesystem operations
		* @delegated_inode: on return, will contain an inode pointer that
		* a delegation was broken on, NULL if none.
		*/
		int
		@@ -443,12 +443,12 @@ __vfs_removexattr(struct dentry dentry, const char name)
		EXPORT_SYMBOL(__vfs_removexattr);

		/**
		* __vfs_removexattr_locked: set an extended attribute while holding the inode
		* __vfs_removexattr_locked - set an extended attribute while holding the inode
		* lock
		*
		* @dentry - object to perform setxattr on
		* @name - name of xattr to remove
		* @delegated_inode - on return, will contain an inode pointer that
		* @dentry: object to perform setxattr on
		* @name: name of xattr to remove
		* @delegated_inode: on return, will contain an inode pointer that
		* a delegation was broken on, NULL if none.
		*/
		int

Admin message