Commit 64ead520 authored by Wang Hai's avatar Wang Hai Committed by Linus Torvalds

nilfs2: fix some kernel-doc warnings for nilfs2

Fixes the following W=1 kernel build warning(s):

fs/nilfs2/bmap.c:378: warning: Excess function parameter 'bhp' description in 'nilfs_bmap_assign'
fs/nilfs2/cpfile.c:907: warning: Excess function parameter 'status' description in 'nilfs_cpfile_change_cpmode'
fs/nilfs2/cpfile.c:946: warning: Excess function parameter 'stat' description in 'nilfs_cpfile_get_stat'
fs/nilfs2/page.c:76: warning: Excess function parameter 'inode' description in 'nilfs_forget_buffer'
fs/nilfs2/sufile.c:563: warning: Excess function parameter 'stat' description in 'nilfs_sufile_get_stat'
Signed-off-by: default avatarWang Hai <wanghai38@huawei.com>
Signed-off-by: default avatarRyusuke Konishi <konishi.ryusuke@gmail.com>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
Link: https://lkml.kernel.org/r/1601386269-2423-1-git-send-email-konishi.ryusuke@gmail.comSigned-off-by: default avatarLinus Torvalds <torvalds@linux-foundation.org>
parent 589f6b52
...@@ -355,7 +355,7 @@ void nilfs_bmap_lookup_dirty_buffers(struct nilfs_bmap *bmap, ...@@ -355,7 +355,7 @@ void nilfs_bmap_lookup_dirty_buffers(struct nilfs_bmap *bmap,
/** /**
* nilfs_bmap_assign - assign a new block number to a block * nilfs_bmap_assign - assign a new block number to a block
* @bmap: bmap * @bmap: bmap
* @bhp: pointer to buffer head * @bh: pointer to buffer head
* @blocknr: block number * @blocknr: block number
* @binfo: block information * @binfo: block information
* *
......
...@@ -889,7 +889,7 @@ int nilfs_cpfile_is_snapshot(struct inode *cpfile, __u64 cno) ...@@ -889,7 +889,7 @@ int nilfs_cpfile_is_snapshot(struct inode *cpfile, __u64 cno)
* nilfs_cpfile_change_cpmode - change checkpoint mode * nilfs_cpfile_change_cpmode - change checkpoint mode
* @cpfile: inode of checkpoint file * @cpfile: inode of checkpoint file
* @cno: checkpoint number * @cno: checkpoint number
* @status: mode of checkpoint * @mode: mode of checkpoint
* *
* Description: nilfs_change_cpmode() changes the mode of the checkpoint * Description: nilfs_change_cpmode() changes the mode of the checkpoint
* specified by @cno. The mode @mode is NILFS_CHECKPOINT or NILFS_SNAPSHOT. * specified by @cno. The mode @mode is NILFS_CHECKPOINT or NILFS_SNAPSHOT.
...@@ -930,12 +930,12 @@ int nilfs_cpfile_change_cpmode(struct inode *cpfile, __u64 cno, int mode) ...@@ -930,12 +930,12 @@ int nilfs_cpfile_change_cpmode(struct inode *cpfile, __u64 cno, int mode)
/** /**
* nilfs_cpfile_get_stat - get checkpoint statistics * nilfs_cpfile_get_stat - get checkpoint statistics
* @cpfile: inode of checkpoint file * @cpfile: inode of checkpoint file
* @stat: pointer to a structure of checkpoint statistics * @cpstat: pointer to a structure of checkpoint statistics
* *
* Description: nilfs_cpfile_get_stat() returns information about checkpoints. * Description: nilfs_cpfile_get_stat() returns information about checkpoints.
* *
* Return Value: On success, 0 is returned, and checkpoints information is * Return Value: On success, 0 is returned, and checkpoints information is
* stored in the place pointed by @stat. On error, one of the following * stored in the place pointed by @cpstat. On error, one of the following
* negative error codes is returned. * negative error codes is returned.
* *
* %-EIO - I/O error. * %-EIO - I/O error.
......
...@@ -69,7 +69,6 @@ struct buffer_head *nilfs_grab_buffer(struct inode *inode, ...@@ -69,7 +69,6 @@ struct buffer_head *nilfs_grab_buffer(struct inode *inode,
/** /**
* nilfs_forget_buffer - discard dirty state * nilfs_forget_buffer - discard dirty state
* @inode: owner inode of the buffer
* @bh: buffer head of the buffer to be discarded * @bh: buffer head of the buffer to be discarded
*/ */
void nilfs_forget_buffer(struct buffer_head *bh) void nilfs_forget_buffer(struct buffer_head *bh)
......
...@@ -546,13 +546,13 @@ int nilfs_sufile_set_segment_usage(struct inode *sufile, __u64 segnum, ...@@ -546,13 +546,13 @@ int nilfs_sufile_set_segment_usage(struct inode *sufile, __u64 segnum,
/** /**
* nilfs_sufile_get_stat - get segment usage statistics * nilfs_sufile_get_stat - get segment usage statistics
* @sufile: inode of segment usage file * @sufile: inode of segment usage file
* @stat: pointer to a structure of segment usage statistics * @sustat: pointer to a structure of segment usage statistics
* *
* Description: nilfs_sufile_get_stat() returns information about segment * Description: nilfs_sufile_get_stat() returns information about segment
* usage. * usage.
* *
* Return Value: On success, 0 is returned, and segment usage information is * Return Value: On success, 0 is returned, and segment usage information is
* stored in the place pointed by @stat. On error, one of the following * stored in the place pointed by @sustat. On error, one of the following
* negative error codes is returned. * negative error codes is returned.
* *
* %-EIO - I/O error. * %-EIO - I/O error.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment