Commit 302fad7b authored by Trond Myklebust's avatar Trond Myklebust
Browse files

NFS: Fix up documentation warnings 



Fix up some compiler warnings about function parameters, etc not being
correctly described or formatted.

Signed-off-by: default avatarTrond Myklebust <trond.myklebust@hammerspace.com>
parent 2dc23aff

fs/nfs/delegation.c

+1 −1
Original line number Diff line number Diff line
@@ -681,7 +681,7 @@ void nfs_expire_all_delegations(struct nfs_client *clp) 


/**

 * nfs_super_return_all_delegations - return delegations for one superblock

 * @sb: sb to process

 * @server: pointer to nfs_server to process

 *

 */

void nfs_server_return_all_delegations(struct nfs_server *server)

fs/nfs/dir.c

+1 −1
Original line number Diff line number Diff line
@@ -945,7 +945,7 @@ static int nfs_fsync_dir(struct file *filp, loff_t start, loff_t end, 


/**

 * nfs_force_lookup_revalidate - Mark the directory as having changed

 * @dir - pointer to directory inode

 * @dir: pointer to directory inode

 *

 * This forces the revalidation code in nfs_lookup_revalidate() to do a

 * full lookup on all child dentries of 'dir' whenever a change occurs

fs/nfs/file.c

+2 −2
Original line number Diff line number Diff line
@@ -89,8 +89,8 @@ EXPORT_SYMBOL_GPL(nfs_file_release); 


/**

 * nfs_revalidate_size - Revalidate the file size

 * @inode - pointer to inode struct

 * @file - pointer to struct file

 * @inode: pointer to inode struct

 * @filp: pointer to struct file

 *

 * Revalidates the file length. This is basically a wrapper around

 * nfs_revalidate_inode() that takes into account the fact that we may

fs/nfs/flexfilelayout/flexfilelayoutdev.c

+9 −3
Original line number Diff line number Diff line
@@ -483,6 +483,12 @@ ff_layout_get_ds_cred(struct pnfs_layout_segment *lseg, u32 ds_idx, 
}



/**

 * nfs4_ff_find_or_create_ds_client - Find or create a DS rpc client

 * @lseg: pointer to layout segment

 * @ds_idx: mirror index

 * @ds_clp: nfs_client for the DS

 * @inode: pointer to inode

 *

 * Find or create a DS rpc client with th MDS server rpc client auth flavor

 * in the nfs_client cl_ds_clients list.

 */

fs/nfs/inode.c

+17 −16
Original line number Diff line number Diff line
@@ -143,6 +143,7 @@ EXPORT_SYMBOL_GPL(nfs_sync_inode); 


/**

 * nfs_sync_mapping - helper to flush all mmapped dirty data to disk

 * @mapping: pointer to struct address_space

 */

int nfs_sync_mapping(struct address_space *mapping)

{
@@ -1184,8 +1185,8 @@ int nfs_attribute_cache_expired(struct inode *inode) 


/**

 * nfs_revalidate_inode - Revalidate the inode attributes

 * @server - pointer to nfs_server struct

 * @inode - pointer to inode struct

 * @server: pointer to nfs_server struct

 * @inode: pointer to inode struct

 *

 * Updates inode attribute information by retrieving the data from the server.

 */
@@ -1255,8 +1256,8 @@ int nfs_revalidate_mapping_rcu(struct inode *inode) 


/**

 * nfs_revalidate_mapping - Revalidate the pagecache

 * @inode - pointer to host inode

 * @mapping - pointer to mapping

 * @inode: pointer to host inode

 * @mapping: pointer to mapping

 */

int nfs_revalidate_mapping(struct inode *inode,

		struct address_space *mapping)
@@ -1371,8 +1372,8 @@ static void nfs_wcc_update_inode(struct inode *inode, struct nfs_fattr *fattr) 


/**

 * nfs_check_inode_attributes - verify consistency of the inode attribute cache

 * @inode - pointer to inode

 * @fattr - updated attributes

 * @inode: pointer to inode

 * @fattr: updated attributes

 *

 * Verifies the attribute cache. If we have just changed the attributes,

 * so that fattr carries weak cache consistency data, then it may
@@ -1572,8 +1573,8 @@ EXPORT_SYMBOL_GPL(_nfs_display_fhandle); 


/**

 * nfs_inode_attrs_need_update - check if the inode attributes need updating

 * @inode - pointer to inode

 * @fattr - attributes

 * @inode: pointer to inode

 * @fattr: attributes

 *

 * Attempt to divine whether or not an RPC call reply carrying stale

 * attributes got scheduled after another call carrying updated ones.
@@ -1614,8 +1615,8 @@ static int nfs_refresh_inode_locked(struct inode *inode, struct nfs_fattr *fattr 


/**

 * nfs_refresh_inode - try to update the inode attribute cache

 * @inode - pointer to inode

 * @fattr - updated attributes

 * @inode: pointer to inode

 * @fattr: updated attributes

 *

 * Check that an RPC call that returned attributes has not overlapped with

 * other recent updates of the inode metadata, then decide whether it is
@@ -1649,8 +1650,8 @@ static int nfs_post_op_update_inode_locked(struct inode *inode, 


/**

 * nfs_post_op_update_inode - try to update the inode attribute cache

 * @inode - pointer to inode

 * @fattr - updated attributes

 * @inode: pointer to inode

 * @fattr: updated attributes

 *

 * After an operation that has changed the inode metadata, mark the

 * attribute cache as being invalid, then try to update it.
@@ -1679,8 +1680,8 @@ EXPORT_SYMBOL_GPL(nfs_post_op_update_inode); 


/**

 * nfs_post_op_update_inode_force_wcc_locked - update the inode attribute cache

 * @inode - pointer to inode

 * @fattr - updated attributes

 * @inode: pointer to inode

 * @fattr: updated attributes

 *

 * After an operation that has changed the inode metadata, mark the

 * attribute cache as being invalid, then try to update it. Fake up
@@ -1731,8 +1732,8 @@ int nfs_post_op_update_inode_force_wcc_locked(struct inode *inode, struct nfs_fa 


/**

 * nfs_post_op_update_inode_force_wcc - try to update the inode attribute cache

 * @inode - pointer to inode

 * @fattr - updated attributes

 * @inode: pointer to inode

 * @fattr: updated attributes

 *

 * After an operation that has changed the inode metadata, mark the

 * attribute cache as being invalid, then try to update it. Fake up