Commit 3ae3a7d6 authored by Bob Peterson's avatar Bob Peterson Committed by Andreas Gruenbacher
Browse files

gfs2: Fix dir.c function parameter descriptions 



This patch simply fixes a bunch of function parameter comments
in dir.c that were reported by the kernel test robot.

Reported-by: default avatarkernel test robot <lkp@intel.com>
Signed-off-by: default avatarBob Peterson <rpeterso@redhat.com>
Signed-off-by: default avatarAndreas Gruenbacher <agruenba@redhat.com>
parent f68effb3

fs/gfs2/dir.c

+22 −17
Original line number Diff line number Diff line
@@ -770,14 +770,13 @@ static int get_leaf(struct gfs2_inode *dip, u64 leaf_no, 
/**

 * get_leaf_nr - Get a leaf number associated with the index

 * @dip: The GFS2 inode

 * @index:

 * @leaf_out:

 * @index: hash table index of the targeted leaf

 * @leaf_out: Resulting leaf block number

 *

 * Returns: 0 on success, error code otherwise

 */



static int get_leaf_nr(struct gfs2_inode *dip, u32 index,

		       u64 *leaf_out)

static int get_leaf_nr(struct gfs2_inode *dip, u32 index, u64 *leaf_out)

{

	__be64 *hash;

	int error;
@@ -898,7 +897,7 @@ static struct gfs2_leaf *new_leaf(struct inode *inode, struct buffer_head **pbh, 


/**

 * dir_make_exhash - Convert a stuffed directory into an ExHash directory

 * @dip: The GFS2 inode

 * @inode: The directory inode to be converted to exhash

 *

 * Returns: 0 on success, error code otherwise

 */
@@ -991,9 +990,8 @@ static int dir_make_exhash(struct inode *inode) 


/**

 * dir_split_leaf - Split a leaf block into two

 * @dip: The GFS2 inode

 * @index:

 * @leaf_no:

 * @inode: The directory inode to be split

 * @name: name of the dirent we're trying to insert

 *

 * Returns: 0 on success, error code on failure

 */
@@ -1252,6 +1250,7 @@ static int compare_dents(const void *a, const void *b) 
 * @ctx: what to feed the entries to

 * @darr: an array of struct gfs2_dirent pointers to read

 * @entries: the number of entries in darr

 * @sort_start: index of the directory array to start our sort

 * @copied: pointer to int that's non-zero if a entry has been copied out

 *

 * Jump through some hoops to make sure that if there are hash collsions,
@@ -1468,6 +1467,10 @@ static int gfs2_dir_read_leaf(struct inode *inode, struct dir_context *ctx, 


/**

 * gfs2_dir_readahead - Issue read-ahead requests for leaf blocks.

 * @inode: the directory inode

 * @hsize: hash table size

 * @index: index into the hash table

 * @f_ra: read-ahead parameters

 *

 * Note: we can't calculate each index like dir_e_read can because we don't

 * have the leaf, and therefore we don't have the depth, and therefore we
@@ -1517,8 +1520,9 @@ static void gfs2_dir_readahead(struct inode *inode, unsigned hsize, u32 index, 


/**

 * dir_e_read - Reads the entries from a directory into a filldir buffer

 * @dip: dinode pointer

 * @inode: the directory inode

 * @ctx: actor to feed the entries to

 * @f_ra: read-ahead parameters

 *

 * Returns: errno

 */
@@ -1627,7 +1631,7 @@ int gfs2_dir_read(struct inode *inode, struct dir_context *ctx, 


/**

 * gfs2_dir_search - Search a directory

 * @dip: The GFS2 dir inode

 * @dir: The GFS2 directory inode

 * @name: The name we are looking up

 * @fail_on_exist: Fail if the name exists rather than looking it up

 *
@@ -1864,7 +1868,7 @@ int gfs2_dir_add(struct inode *inode, const struct qstr *name, 
/**

 * gfs2_dir_del - Delete a directory entry

 * @dip: The GFS2 inode

 * @filename: The filename

 * @dentry: The directory entry we want to delete

 *

 * Returns: 0 on success, error code on failure

 */
@@ -1918,9 +1922,10 @@ int gfs2_dir_del(struct gfs2_inode *dip, const struct dentry *dentry) 


/**

 * gfs2_dir_mvino - Change inode number of directory entry

 * @dip: The GFS2 inode

 * @filename:

 * @new_inode:

 * @dip: The GFS2 directory inode

 * @filename: the filename to be moved

 * @nip: the new GFS2 inode

 * @new_type: the de_type of the new dirent

 *

 * This routine changes the inode number of a directory entry.  It's used

 * by rename to change ".." when a directory is moved.
@@ -1960,7 +1965,7 @@ int gfs2_dir_mvino(struct gfs2_inode *dip, const struct qstr *filename, 
 * @len: the number of pointers to this leaf

 * @leaf_no: the leaf number

 * @leaf_bh: buffer_head for the starting leaf

 * last_dealloc: 1 if this is the final dealloc for the leaf, else 0

 * @last_dealloc: 1 if this is the final dealloc for the leaf, else 0

 *

 * Returns: errno

 */
@@ -2142,8 +2147,8 @@ int gfs2_dir_exhash_dealloc(struct gfs2_inode *dip) 


/**

 * gfs2_diradd_alloc_required - find if adding entry will require an allocation

 * @ip: the file being written to

 * @filname: the filename that's going to be added

 * @inode: the directory inode being written to

 * @name: the filename that's going to be added

 * @da: The structure to return dir alloc info

 *

 * Returns: 0 if ok, -ve on error