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

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
...@@ -681,7 +681,7 @@ void nfs_expire_all_delegations(struct nfs_client *clp) ...@@ -681,7 +681,7 @@ void nfs_expire_all_delegations(struct nfs_client *clp)
/** /**
* nfs_super_return_all_delegations - return delegations for one superblock * 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) void nfs_server_return_all_delegations(struct nfs_server *server)
......
...@@ -945,7 +945,7 @@ static int nfs_fsync_dir(struct file *filp, loff_t start, loff_t end, ...@@ -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 * 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 * This forces the revalidation code in nfs_lookup_revalidate() to do a
* full lookup on all child dentries of 'dir' whenever a change occurs * full lookup on all child dentries of 'dir' whenever a change occurs
......
...@@ -89,8 +89,8 @@ EXPORT_SYMBOL_GPL(nfs_file_release); ...@@ -89,8 +89,8 @@ EXPORT_SYMBOL_GPL(nfs_file_release);
/** /**
* nfs_revalidate_size - Revalidate the file size * nfs_revalidate_size - Revalidate the file size
* @inode - pointer to inode struct * @inode: pointer to inode struct
* @file - pointer to struct file * @filp: pointer to struct file
* *
* Revalidates the file length. This is basically a wrapper around * Revalidates the file length. This is basically a wrapper around
* nfs_revalidate_inode() that takes into account the fact that we may * nfs_revalidate_inode() that takes into account the fact that we may
......
...@@ -483,9 +483,15 @@ ff_layout_get_ds_cred(struct pnfs_layout_segment *lseg, u32 ds_idx, ...@@ -483,9 +483,15 @@ ff_layout_get_ds_cred(struct pnfs_layout_segment *lseg, u32 ds_idx,
} }
/** /**
* Find or create a DS rpc client with th MDS server rpc client auth flavor * nfs4_ff_find_or_create_ds_client - Find or create a DS rpc client
* in the nfs_client cl_ds_clients list. * @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.
*/
struct rpc_clnt * struct rpc_clnt *
nfs4_ff_find_or_create_ds_client(struct pnfs_layout_segment *lseg, u32 ds_idx, nfs4_ff_find_or_create_ds_client(struct pnfs_layout_segment *lseg, u32 ds_idx,
struct nfs_client *ds_clp, struct inode *inode) struct nfs_client *ds_clp, struct inode *inode)
......
...@@ -143,6 +143,7 @@ EXPORT_SYMBOL_GPL(nfs_sync_inode); ...@@ -143,6 +143,7 @@ EXPORT_SYMBOL_GPL(nfs_sync_inode);
/** /**
* nfs_sync_mapping - helper to flush all mmapped dirty data to disk * 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) int nfs_sync_mapping(struct address_space *mapping)
{ {
...@@ -1184,8 +1185,8 @@ int nfs_attribute_cache_expired(struct inode *inode) ...@@ -1184,8 +1185,8 @@ int nfs_attribute_cache_expired(struct inode *inode)
/** /**
* nfs_revalidate_inode - Revalidate the inode attributes * nfs_revalidate_inode - Revalidate the inode attributes
* @server - pointer to nfs_server struct * @server: pointer to nfs_server struct
* @inode - pointer to inode struct * @inode: pointer to inode struct
* *
* Updates inode attribute information by retrieving the data from the server. * Updates inode attribute information by retrieving the data from the server.
*/ */
...@@ -1255,8 +1256,8 @@ int nfs_revalidate_mapping_rcu(struct inode *inode) ...@@ -1255,8 +1256,8 @@ int nfs_revalidate_mapping_rcu(struct inode *inode)
/** /**
* nfs_revalidate_mapping - Revalidate the pagecache * nfs_revalidate_mapping - Revalidate the pagecache
* @inode - pointer to host inode * @inode: pointer to host inode
* @mapping - pointer to mapping * @mapping: pointer to mapping
*/ */
int nfs_revalidate_mapping(struct inode *inode, int nfs_revalidate_mapping(struct inode *inode,
struct address_space *mapping) struct address_space *mapping)
...@@ -1371,8 +1372,8 @@ static void nfs_wcc_update_inode(struct inode *inode, struct nfs_fattr *fattr) ...@@ -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 * nfs_check_inode_attributes - verify consistency of the inode attribute cache
* @inode - pointer to inode * @inode: pointer to inode
* @fattr - updated attributes * @fattr: updated attributes
* *
* Verifies the attribute cache. If we have just changed the attributes, * Verifies the attribute cache. If we have just changed the attributes,
* so that fattr carries weak cache consistency data, then it may * so that fattr carries weak cache consistency data, then it may
...@@ -1572,8 +1573,8 @@ EXPORT_SYMBOL_GPL(_nfs_display_fhandle); ...@@ -1572,8 +1573,8 @@ EXPORT_SYMBOL_GPL(_nfs_display_fhandle);
/** /**
* nfs_inode_attrs_need_update - check if the inode attributes need updating * nfs_inode_attrs_need_update - check if the inode attributes need updating
* @inode - pointer to inode * @inode: pointer to inode
* @fattr - attributes * @fattr: attributes
* *
* Attempt to divine whether or not an RPC call reply carrying stale * Attempt to divine whether or not an RPC call reply carrying stale
* attributes got scheduled after another call carrying updated ones. * 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 ...@@ -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 * nfs_refresh_inode - try to update the inode attribute cache
* @inode - pointer to inode * @inode: pointer to inode
* @fattr - updated attributes * @fattr: updated attributes
* *
* Check that an RPC call that returned attributes has not overlapped with * Check that an RPC call that returned attributes has not overlapped with
* other recent updates of the inode metadata, then decide whether it is * 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, ...@@ -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 * nfs_post_op_update_inode - try to update the inode attribute cache
* @inode - pointer to inode * @inode: pointer to inode
* @fattr - updated attributes * @fattr: updated attributes
* *
* After an operation that has changed the inode metadata, mark the * After an operation that has changed the inode metadata, mark the
* attribute cache as being invalid, then try to update it. * attribute cache as being invalid, then try to update it.
...@@ -1679,8 +1680,8 @@ EXPORT_SYMBOL_GPL(nfs_post_op_update_inode); ...@@ -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 * nfs_post_op_update_inode_force_wcc_locked - update the inode attribute cache
* @inode - pointer to inode * @inode: pointer to inode
* @fattr - updated attributes * @fattr: updated attributes
* *
* After an operation that has changed the inode metadata, mark the * After an operation that has changed the inode metadata, mark the
* attribute cache as being invalid, then try to update it. Fake up * 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 ...@@ -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 * nfs_post_op_update_inode_force_wcc - try to update the inode attribute cache
* @inode - pointer to inode * @inode: pointer to inode
* @fattr - updated attributes * @fattr: updated attributes
* *
* After an operation that has changed the inode metadata, mark the * After an operation that has changed the inode metadata, mark the
* attribute cache as being invalid, then try to update it. Fake up * attribute cache as being invalid, then try to update it. Fake up
......
...@@ -25,7 +25,7 @@ static void nfs_block_o_direct(struct nfs_inode *nfsi, struct inode *inode) ...@@ -25,7 +25,7 @@ static void nfs_block_o_direct(struct nfs_inode *nfsi, struct inode *inode)
/** /**
* nfs_start_io_read - declare the file is being used for buffered reads * nfs_start_io_read - declare the file is being used for buffered reads
* @inode - file inode * @inode: file inode
* *
* Declare that a buffered read operation is about to start, and ensure * Declare that a buffered read operation is about to start, and ensure
* that we block all direct I/O. * that we block all direct I/O.
...@@ -56,7 +56,7 @@ nfs_start_io_read(struct inode *inode) ...@@ -56,7 +56,7 @@ nfs_start_io_read(struct inode *inode)
/** /**
* nfs_end_io_read - declare that the buffered read operation is done * nfs_end_io_read - declare that the buffered read operation is done
* @inode - file inode * @inode: file inode
* *
* Declare that a buffered read operation is done, and release the shared * Declare that a buffered read operation is done, and release the shared
* lock on inode->i_rwsem. * lock on inode->i_rwsem.
...@@ -69,7 +69,7 @@ nfs_end_io_read(struct inode *inode) ...@@ -69,7 +69,7 @@ nfs_end_io_read(struct inode *inode)
/** /**
* nfs_start_io_write - declare the file is being used for buffered writes * nfs_start_io_write - declare the file is being used for buffered writes
* @inode - file inode * @inode: file inode
* *
* Declare that a buffered read operation is about to start, and ensure * Declare that a buffered read operation is about to start, and ensure
* that we block all direct I/O. * that we block all direct I/O.
...@@ -83,7 +83,7 @@ nfs_start_io_write(struct inode *inode) ...@@ -83,7 +83,7 @@ nfs_start_io_write(struct inode *inode)
/** /**
* nfs_end_io_write - declare that the buffered write operation is done * nfs_end_io_write - declare that the buffered write operation is done
* @inode - file inode * @inode: file inode
* *
* Declare that a buffered write operation is done, and release the * Declare that a buffered write operation is done, and release the
* lock on inode->i_rwsem. * lock on inode->i_rwsem.
...@@ -105,7 +105,7 @@ static void nfs_block_buffered(struct nfs_inode *nfsi, struct inode *inode) ...@@ -105,7 +105,7 @@ static void nfs_block_buffered(struct nfs_inode *nfsi, struct inode *inode)
/** /**
* nfs_end_io_direct - declare the file is being used for direct i/o * nfs_end_io_direct - declare the file is being used for direct i/o
* @inode - file inode * @inode: file inode
* *
* Declare that a direct I/O operation is about to start, and ensure * Declare that a direct I/O operation is about to start, and ensure
* that we block all buffered I/O. * that we block all buffered I/O.
...@@ -136,7 +136,7 @@ nfs_start_io_direct(struct inode *inode) ...@@ -136,7 +136,7 @@ nfs_start_io_direct(struct inode *inode)
/** /**
* nfs_end_io_direct - declare that the direct i/o operation is done * nfs_end_io_direct - declare that the direct i/o operation is done
* @inode - file inode * @inode: file inode
* *
* Declare that a direct I/O operation is done, and release the shared * Declare that a direct I/O operation is done, and release the shared
* lock on inode->i_rwsem. * lock on inode->i_rwsem.
......
...@@ -221,10 +221,10 @@ static struct vfsmount *nfs_do_clone_mount(struct nfs_server *server, ...@@ -221,10 +221,10 @@ static struct vfsmount *nfs_do_clone_mount(struct nfs_server *server,
/** /**
* nfs_do_submount - set up mountpoint when crossing a filesystem boundary * nfs_do_submount - set up mountpoint when crossing a filesystem boundary
* @dentry - parent directory * @dentry: parent directory
* @fh - filehandle for new root dentry * @fh: filehandle for new root dentry
* @fattr - attributes for new root inode * @fattr: attributes for new root inode
* @authflavor - security flavor to use when performing the mount * @authflavor: security flavor to use when performing the mount
* *
*/ */
struct vfsmount *nfs_do_submount(struct dentry *dentry, struct nfs_fh *fh, struct vfsmount *nfs_do_submount(struct dentry *dentry, struct nfs_fh *fh,
......
...@@ -42,7 +42,7 @@ static int nfs_get_cb_ident_idr(struct nfs_client *clp, int minorversion) ...@@ -42,7 +42,7 @@ static int nfs_get_cb_ident_idr(struct nfs_client *clp, int minorversion)
} }
#ifdef CONFIG_NFS_V4_1 #ifdef CONFIG_NFS_V4_1
/** /*
* Per auth flavor data server rpc clients * Per auth flavor data server rpc clients
*/ */
struct nfs4_ds_server { struct nfs4_ds_server {
...@@ -51,7 +51,9 @@ struct nfs4_ds_server { ...@@ -51,7 +51,9 @@ struct nfs4_ds_server {
}; };
/** /**
* Common lookup case for DS I/O * nfs4_find_ds_client - Common lookup case for DS I/O
* @ds_clp: pointer to the DS's nfs_client
* @flavor: rpc auth flavour to match
*/ */
static struct nfs4_ds_server * static struct nfs4_ds_server *
nfs4_find_ds_client(struct nfs_client *ds_clp, rpc_authflavor_t flavor) nfs4_find_ds_client(struct nfs_client *ds_clp, rpc_authflavor_t flavor)
...@@ -118,9 +120,13 @@ nfs4_free_ds_server(struct nfs4_ds_server *dss) ...@@ -118,9 +120,13 @@ nfs4_free_ds_server(struct nfs4_ds_server *dss)
} }
/** /**
* Find or create a DS rpc client with th MDS server rpc client auth flavor * nfs4_find_or_create_ds_client - Find or create a DS rpc client
* in the nfs_client cl_ds_clients list. * @ds_clp: pointer to the DS's nfs_client
*/ * @inode: pointer to the inode
*
* Find or create a DS rpc client with th MDS server rpc client auth flavor
* in the nfs_client cl_ds_clients list.
*/
struct rpc_clnt * struct rpc_clnt *
nfs4_find_or_create_ds_client(struct nfs_client *ds_clp, struct inode *inode) nfs4_find_or_create_ds_client(struct nfs_client *ds_clp, struct inode *inode)
{ {
...@@ -284,7 +290,7 @@ static int nfs4_init_callback(struct nfs_client *clp) ...@@ -284,7 +290,7 @@ static int nfs4_init_callback(struct nfs_client *clp)
/** /**
* nfs40_init_client - nfs_client initialization tasks for NFSv4.0 * nfs40_init_client - nfs_client initialization tasks for NFSv4.0
* @clp - nfs_client to initialize * @clp: nfs_client to initialize
* *
* Returns zero on success, or a negative errno if some error occurred. * Returns zero on success, or a negative errno if some error occurred.
*/ */
...@@ -312,7 +318,7 @@ int nfs40_init_client(struct nfs_client *clp) ...@@ -312,7 +318,7 @@ int nfs40_init_client(struct nfs_client *clp)
/** /**
* nfs41_init_client - nfs_client initialization tasks for NFSv4.1+ * nfs41_init_client - nfs_client initialization tasks for NFSv4.1+
* @clp - nfs_client to initialize * @clp: nfs_client to initialize
* *
* Returns zero on success, or a negative errno if some error occurred. * Returns zero on success, or a negative errno if some error occurred.
*/ */
...@@ -360,9 +366,7 @@ static int nfs4_init_client_minor_version(struct nfs_client *clp) ...@@ -360,9 +366,7 @@ static int nfs4_init_client_minor_version(struct nfs_client *clp)
* nfs4_init_client - Initialise an NFS4 client record * nfs4_init_client - Initialise an NFS4 client record
* *
* @clp: nfs_client to initialise * @clp: nfs_client to initialise
* @timeparms: timeout parameters for underlying RPC transport * @cl_init: pointer to nfs_client_initdata
* @ip_addr: callback IP address in presentation format
* @authflavor: authentication flavor for underlying RPC transport
* *
* Returns pointer to an NFS client, or an ERR_PTR value. * Returns pointer to an NFS client, or an ERR_PTR value.
*/ */
...@@ -649,13 +653,13 @@ nfs4_check_server_scope(struct nfs41_server_scope *s1, ...@@ -649,13 +653,13 @@ nfs4_check_server_scope(struct nfs41_server_scope *s1,
/** /**
* nfs4_detect_session_trunking - Checks for session trunking. * nfs4_detect_session_trunking - Checks for session trunking.
*
* Called after a successful EXCHANGE_ID on a multi-addr connection.
* Upon success, add the transport.
*
* @clp: original mount nfs_client * @clp: original mount nfs_client
* @res: result structure from an exchange_id using the original mount * @res: result structure from an exchange_id using the original mount
* nfs_client with a new multi_addr transport * nfs_client with a new multi_addr transport
* @xprt: pointer to the transport to add.
*
* Called after a successful EXCHANGE_ID on a multi-addr connection.
* Upon success, add the transport.
* *
* Returns zero on success, otherwise -EINVAL * Returns zero on success, otherwise -EINVAL
* *
......
...@@ -137,6 +137,7 @@ static size_t nfs_parse_server_name(char *string, size_t len, ...@@ -137,6 +137,7 @@ static size_t nfs_parse_server_name(char *string, size_t len,
/** /**
* nfs_find_best_sec - Find a security mechanism supported locally * nfs_find_best_sec - Find a security mechanism supported locally
* @clnt: pointer to rpc_clnt
* @server: NFS server struct * @server: NFS server struct
* @flavors: List of security tuples returned by SECINFO procedure * @flavors: List of security tuples returned by SECINFO procedure
* *
...@@ -288,8 +289,8 @@ static struct vfsmount *try_location(struct nfs_clone_mount *mountdata, ...@@ -288,8 +289,8 @@ static struct vfsmount *try_location(struct nfs_clone_mount *mountdata,
/** /**
* nfs_follow_referral - set up mountpoint when hitting a referral on moved error * nfs_follow_referral - set up mountpoint when hitting a referral on moved error
* @dentry - parent directory * @dentry: parent directory
* @locations - array of NFSv4 server location information * @locations: array of NFSv4 server location information
* *
*/ */
static struct vfsmount *nfs_follow_referral(struct dentry *dentry, static struct vfsmount *nfs_follow_referral(struct dentry *dentry,
......
...@@ -5963,7 +5963,7 @@ int nfs4_proc_setclientid(struct nfs_client *clp, u32 program, ...@@ -5963,7 +5963,7 @@ int nfs4_proc_setclientid(struct nfs_client *clp, u32 program,
/** /**
* nfs4_proc_setclientid_confirm - Confirm client ID * nfs4_proc_setclientid_confirm - Confirm client ID
* @clp: state data structure * @clp: state data structure
* @res: result of a previous SETCLIENTID * @arg: result of a previous SETCLIENTID
* @cred: credential to use for this call * @cred: credential to use for this call
* *
* Returns zero, a negative errno, or a negative NFS4ERR status code. * Returns zero, a negative errno, or a negative NFS4ERR status code.
...@@ -7527,7 +7527,7 @@ int nfs4_proc_fsid_present(struct inode *inode, const struct cred *cred) ...@@ -7527,7 +7527,7 @@ int nfs4_proc_fsid_present(struct inode *inode, const struct cred *cred)
return status; return status;
} }
/** /*
* If 'use_integrity' is true and the state managment nfs_client * If 'use_integrity' is true and the state managment nfs_client
* cl_rpcclient is using krb5i/p, use the integrity protected cl_rpcclient * cl_rpcclient is using krb5i/p, use the integrity protected cl_rpcclient
* and the machine credential as per RFC3530bis and RFC5661 Security * and the machine credential as per RFC3530bis and RFC5661 Security
...@@ -9219,7 +9219,7 @@ nfs4_proc_layoutcommit(struct nfs4_layoutcommit_data *data, bool sync) ...@@ -9219,7 +9219,7 @@ nfs4_proc_layoutcommit(struct nfs4_layoutcommit_data *data, bool sync)
return status; return status;
} }
/** /*
* Use the state managment nfs_client cl_rpcclient, which uses krb5i (if * Use the state managment nfs_client cl_rpcclient, which uses krb5i (if
* possible) as per RFC3530bis and RFC5661 Security Considerations sections * possible) as per RFC3530bis and RFC5661 Security Considerations sections
*/ */
...@@ -9484,7 +9484,7 @@ static const struct rpc_call_ops nfs41_free_stateid_ops = { ...@@ -9484,7 +9484,7 @@ static const struct rpc_call_ops nfs41_free_stateid_ops = {
* @server: server / transport on which to perform the operation * @server: server / transport on which to perform the operation
* @stateid: state ID to release * @stateid: state ID to release
* @cred: credential * @cred: credential
* @is_recovery: set to true if this call needs to be privileged * @privileged: set to true if this call needs to be privileged
* *
* Note: this function is always asynchronous. * Note: this function is always asynchronous.
*/ */
......
...@@ -55,7 +55,7 @@ static void nfs4_shrink_slot_table(struct nfs4_slot_table *tbl, u32 newsize) ...@@ -55,7 +55,7 @@ static void nfs4_shrink_slot_table(struct nfs4_slot_table *tbl, u32 newsize)
/** /**
* nfs4_slot_tbl_drain_complete - wake waiters when drain is complete * nfs4_slot_tbl_drain_complete - wake waiters when drain is complete
* @tbl - controlling slot table * @tbl: controlling slot table
* *
*/ */
void nfs4_slot_tbl_drain_complete(struct nfs4_slot_table *tbl) void nfs4_slot_tbl_drain_complete(struct nfs4_slot_table *tbl)
......
...@@ -563,6 +563,7 @@ static void nfs4_gc_state_owners(struct nfs_server *server) ...@@ -563,6 +563,7 @@ static void nfs4_gc_state_owners(struct nfs_server *server)
* nfs4_get_state_owner - Look up a state owner given a credential * nfs4_get_state_owner - Look up a state owner given a credential
* @server: nfs_server to search * @server: nfs_server to search
* @cred: RPC credential to match * @cred: RPC credential to match
* @gfp_flags: allocation mode
* *
* Returns a pointer to an instantiated nfs4_state_owner struct, or NULL. * Returns a pointer to an instantiated nfs4_state_owner struct, or NULL.
*/ */
......
...@@ -350,7 +350,7 @@ nfs_create_request(struct nfs_open_context *ctx, struct page *page, ...@@ -350,7 +350,7 @@ nfs_create_request(struct nfs_open_context *ctx, struct page *page,
/** /**
* nfs_unlock_request - Unlock request and wake up sleepers. * nfs_unlock_request - Unlock request and wake up sleepers.
* @req: * @req: pointer to request
*/ */
void nfs_unlock_request(struct nfs_page *req) void nfs_unlock_request(struct nfs_page *req)
{ {
...@@ -368,7 +368,7 @@ void nfs_unlock_request(struct nfs_page *req) ...@@ -368,7 +368,7 @@ void nfs_unlock_request(struct nfs_page *req)
/** /**
* nfs_unlock_and_release_request - Unlock request and release the nfs_page * nfs_unlock_and_release_request - Unlock request and release the nfs_page
* @req: * @req: pointer to request
*/ */
void nfs_unlock_and_release_request(struct nfs_page *req) void nfs_unlock_and_release_request(struct nfs_page *req)
{ {
...@@ -531,7 +531,6 @@ EXPORT_SYMBOL_GPL(nfs_pgio_header_free); ...@@ -531,7 +531,6 @@ EXPORT_SYMBOL_GPL(nfs_pgio_header_free);
* nfs_pgio_rpcsetup - Set up arguments for a pageio call * nfs_pgio_rpcsetup - Set up arguments for a pageio call
* @hdr: The pageio hdr * @hdr: The pageio hdr
* @count: Number of bytes to read * @count: Number of bytes to read
* @offset: Initial offset
* @how: How to commit data (writes only) * @how: How to commit data (writes only)
* @cinfo: Commit information for the call (writes only) * @cinfo: Commit information for the call (writes only)
*/ */
...@@ -634,7 +633,6 @@ EXPORT_SYMBOL_GPL(nfs_initiate_pgio); ...@@ -634,7 +633,6 @@ EXPORT_SYMBOL_GPL(nfs_initiate_pgio);
/** /**
* nfs_pgio_error - Clean up from a pageio error * nfs_pgio_error - Clean up from a pageio error
* @desc: IO descriptor
* @hdr: pageio header * @hdr: pageio header
*/ */
static void nfs_pgio_error(struct nfs_pgio_header *hdr) static void nfs_pgio_error(struct nfs_pgio_header *hdr)
...@@ -892,6 +890,7 @@ static bool nfs_match_lock_context(const struct nfs_lock_context *l1, ...@@ -892,6 +890,7 @@ static bool nfs_match_lock_context(const struct nfs_lock_context *l1,
* nfs_can_coalesce_requests - test two requests for compatibility * nfs_can_coalesce_requests - test two requests for compatibility
* @prev: pointer to nfs_page * @prev: pointer to nfs_page
* @req: pointer to nfs_page * @req: pointer to nfs_page
* @pgio: pointer to nfs_pagio_descriptor
* *
* The nfs_page structures 'prev' and 'req' are compared to ensure that the * The nfs_page structures 'prev' and 'req' are compared to ensure that the
* page data area they describe is contiguous, and that their RPC * page data area they describe is contiguous, and that their RPC
......
...@@ -39,6 +39,7 @@ nfs_free_unlinkdata(struct nfs_unlinkdata *data) ...@@ -39,6 +39,7 @@ nfs_free_unlinkdata(struct nfs_unlinkdata *data)
/** /**
* nfs_async_unlink_done - Sillydelete post-processing * nfs_async_unlink_done - Sillydelete post-processing
* @task: rpc_task of the sillydelete * @task: rpc_task of the sillydelete
* @calldata: pointer to nfs_unlinkdata
* *
* Do the directory attribute update. * Do the directory attribute update.
*/ */
...@@ -54,7 +55,7 @@ static void nfs_async_unlink_done(struct rpc_task *task, void *calldata) ...@@ -54,7 +55,7 @@ static void nfs_async_unlink_done(struct rpc_task *task, void *calldata)
/** /**
* nfs_async_unlink_release - Release the sillydelete data. * nfs_async_unlink_release - Release the sillydelete data.
* @task: rpc_task of the sillydelete * @calldata: struct nfs_unlinkdata to release
* *
* We need to call nfs_put_unlinkdata as a 'tk_release' task since the * We need to call nfs_put_unlinkdata as a 'tk_release' task since the
* rpc_task would be freed too. * rpc_task would be freed too.
...@@ -159,8 +160,8 @@ static int nfs_call_unlink(struct dentry *dentry, struct inode *inode, struct nf ...@@ -159,8 +160,8 @@ static int nfs_call_unlink(struct dentry *dentry, struct inode *inode, struct nf
/** /**
* nfs_async_unlink - asynchronous unlinking of a file * nfs_async_unlink - asynchronous unlinking of a file
* @dir: parent directory of dentry * @dentry: parent directory of dentry
* @dentry: dentry to unlink * @name: name of dentry to unlink
*/ */
static int static int
nfs_async_unlink(struct dentry *dentry, const struct qstr *name) nfs_async_unlink(struct dentry *dentry, const struct qstr *name)
...@@ -324,6 +325,7 @@ static const struct rpc_call_ops nfs_rename_ops = { ...@@ -324,6 +325,7 @@ static const struct rpc_call_ops nfs_rename_ops = {
* @new_dir: target directory for the rename * @new_dir: target directory for the rename
* @old_dentry: original dentry to be renamed * @old_dentry: original dentry to be renamed
* @new_dentry: dentry to which the old_dentry should be renamed * @new_dentry: dentry to which the old_dentry should be renamed
* @complete: Function to run on successful completion
* *
* It's expected that valid references to the dentries and inodes are held * It's expected that valid references to the dentries and inodes are held
*/ */
......
...@@ -870,7 +870,6 @@ EXPORT_SYMBOL_GPL(nfs_request_add_commit_list_locked); ...@@ -870,7 +870,6 @@ EXPORT_SYMBOL_GPL(nfs_request_add_commit_list_locked);
/** /**
* nfs_request_add_commit_list - add request to a commit list * nfs_request_add_commit_list - add request to a commit list
* @req: pointer to a struct nfs_page * @req: pointer to a struct nfs_page
* @dst: commit list head
* @cinfo: holds list lock and accounting info * @cinfo: holds list lock and accounting info
* *
* This sets the PG_CLEAN bit, updates the cinfo count of * This sets the PG_CLEAN bit, updates the cinfo count of
......
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