Commit c60990b3 authored by Theodore Ts'o's avatar Theodore Ts'o

ext4: clean up kerneldoc warnigns when building with W=1

Signed-off-by: default avatarTheodore Ts'o <tytso@mit.edu>
parent 7ddf79a1
...@@ -603,9 +603,9 @@ int ext4_claim_free_clusters(struct ext4_sb_info *sbi, ...@@ -603,9 +603,9 @@ int ext4_claim_free_clusters(struct ext4_sb_info *sbi,
} }
/** /**
* ext4_should_retry_alloc() * ext4_should_retry_alloc() - check if a block allocation should be retried
* @sb: super block * @sb: super block
* @retries number of attemps has been made * @retries: number of attemps has been made
* *
* ext4_should_retry_alloc() is called when ENOSPC is returned, and if * ext4_should_retry_alloc() is called when ENOSPC is returned, and if
* it is profitable to retry the operation, this function will wait * it is profitable to retry the operation, this function will wait
......
...@@ -33,6 +33,9 @@ ...@@ -33,6 +33,9 @@
static int ext4_dx_readdir(struct file *, struct dir_context *); static int ext4_dx_readdir(struct file *, struct dir_context *);
/** /**
* is_dx_dir() - check if a directory is using htree indexing
* @inode: directory inode
*
* Check if the given dir-inode refers to an htree-indexed directory * Check if the given dir-inode refers to an htree-indexed directory
* (or a directory which could potentially get converted to use htree * (or a directory which could potentially get converted to use htree
* indexing). * indexing).
......
...@@ -5676,8 +5676,8 @@ int ext4_insert_range(struct inode *inode, loff_t offset, loff_t len) ...@@ -5676,8 +5676,8 @@ int ext4_insert_range(struct inode *inode, loff_t offset, loff_t len)
} }
/** /**
* ext4_swap_extents - Swap extents between two inodes * ext4_swap_extents() - Swap extents between two inodes
* * @handle: handle for this transaction
* @inode1: First inode * @inode1: First inode
* @inode2: Second inode * @inode2: Second inode
* @lblk1: Start block for first inode * @lblk1: Start block for first inode
......
...@@ -294,14 +294,12 @@ static int ext4_blks_to_allocate(Indirect *branch, int k, unsigned int blks, ...@@ -294,14 +294,12 @@ static int ext4_blks_to_allocate(Indirect *branch, int k, unsigned int blks,
} }
/** /**
* ext4_alloc_branch - allocate and set up a chain of blocks. * ext4_alloc_branch() - allocate and set up a chain of blocks
* @handle: handle for this transaction * @handle: handle for this transaction
* @inode: owner * @ar: structure describing the allocation request
* @indirect_blks: number of allocated indirect blocks * @indirect_blks: number of allocated indirect blocks
* @blks: number of allocated direct blocks * @offsets: offsets (in the blocks) to store the pointers to next.
* @goal: preferred place for allocation * @branch: place to store the chain in.
* @offsets: offsets (in the blocks) to store the pointers to next.
* @branch: place to store the chain in.
* *
* This function allocates blocks, zeroes out all but the last one, * This function allocates blocks, zeroes out all but the last one,
* links them into chain and (if we are synchronous) writes them to disk. * links them into chain and (if we are synchronous) writes them to disk.
...@@ -396,15 +394,11 @@ static int ext4_alloc_branch(handle_t *handle, ...@@ -396,15 +394,11 @@ static int ext4_alloc_branch(handle_t *handle,
} }
/** /**
* ext4_splice_branch - splice the allocated branch onto inode. * ext4_splice_branch() - splice the allocated branch onto inode.
* @handle: handle for this transaction * @handle: handle for this transaction
* @inode: owner * @ar: structure describing the allocation request
* @block: (logical) number of block we are adding
* @chain: chain of indirect blocks (with a missing link - see
* ext4_alloc_branch)
* @where: location of missing link * @where: location of missing link
* @num: number of indirect blocks we are adding * @num: number of indirect blocks we are adding
* @blks: number of direct blocks we are adding
* *
* This function fills the missing link and does all housekeeping needed in * This function fills the missing link and does all housekeeping needed in
* inode (->i_blocks, etc.). In case of success we end up with the full * inode (->i_blocks, etc.). In case of success we end up with the full
......
...@@ -4696,8 +4696,9 @@ ext4_mb_free_metadata(handle_t *handle, struct ext4_buddy *e4b, ...@@ -4696,8 +4696,9 @@ ext4_mb_free_metadata(handle_t *handle, struct ext4_buddy *e4b,
* ext4_free_blocks() -- Free given blocks and update quota * ext4_free_blocks() -- Free given blocks and update quota
* @handle: handle for this transaction * @handle: handle for this transaction
* @inode: inode * @inode: inode
* @block: start physical block to free * @bh: optional buffer of the block to be freed
* @count: number of blocks to count * @block: starting physical block to be freed
* @count: number of blocks to be freed
* @flags: flags used by ext4_free_blocks * @flags: flags used by ext4_free_blocks
*/ */
void ext4_free_blocks(handle_t *handle, struct inode *inode, void ext4_free_blocks(handle_t *handle, struct inode *inode,
......
...@@ -13,11 +13,10 @@ ...@@ -13,11 +13,10 @@
#include "ext4_extents.h" #include "ext4_extents.h"
/** /**
* get_ext_path - Find an extent path for designated logical block number. * get_ext_path() - Find an extent path for designated logical block number.
* * @inode: inode to be searched
* @inode: an inode which is searched
* @lblock: logical block number to find an extent path * @lblock: logical block number to find an extent path
* @path: pointer to an extent path pointer (for output) * @ppath: pointer to an extent path pointer (for output)
* *
* ext4_find_extent wrapper. Return 0 on success, or a negative error value * ext4_find_extent wrapper. Return 0 on success, or a negative error value
* on failure. * on failure.
...@@ -42,8 +41,9 @@ get_ext_path(struct inode *inode, ext4_lblk_t lblock, ...@@ -42,8 +41,9 @@ get_ext_path(struct inode *inode, ext4_lblk_t lblock,
} }
/** /**
* ext4_double_down_write_data_sem - Acquire two inodes' write lock * ext4_double_down_write_data_sem() - write lock two inodes's i_data_sem
* of i_data_sem * @first: inode to be locked
* @second: inode to be locked
* *
* Acquire write lock of i_data_sem of the two inodes * Acquire write lock of i_data_sem of the two inodes
*/ */
......
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