cifs: Deal with some warnings from W=1
Deal with some warnings generated from make W=1: (1) Add/remove/fix kerneldoc parameters descriptions. (2) Turn cifs' rqst_page_get_length()'s banner comment into a kerneldoc comment. It should probably be prefixed with "cifs_" though. Signed-off-by: David Howells <dhowells@redhat.com> Signed-off-by: Steve French <stfrench@microsoft.com>
This commit is contained in:
parent
e946d3c887
commit
03ab9cb982
|
@ -590,6 +590,7 @@ void cifs_put_writer(struct cifsInodeInfo *cinode)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* cifs_queue_oplock_break - queue the oplock break handler for cfile
|
* cifs_queue_oplock_break - queue the oplock break handler for cfile
|
||||||
|
* @cfile: The file to break the oplock on
|
||||||
*
|
*
|
||||||
* This function is called from the demultiplex thread when it
|
* This function is called from the demultiplex thread when it
|
||||||
* receives an oplock break for @cfile.
|
* receives an oplock break for @cfile.
|
||||||
|
@ -1065,6 +1066,9 @@ setup_aio_ctx_iter(struct cifs_aio_ctx *ctx, struct iov_iter *iter, int rw)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* cifs_alloc_hash - allocate hash and hash context together
|
* cifs_alloc_hash - allocate hash and hash context together
|
||||||
|
* @name: The name of the crypto hash algo
|
||||||
|
* @shash: Where to put the pointer to the hash algo
|
||||||
|
* @sdesc: Where to put the pointer to the hash descriptor
|
||||||
*
|
*
|
||||||
* The caller has to make sure @sdesc is initialized to either NULL or
|
* The caller has to make sure @sdesc is initialized to either NULL or
|
||||||
* a valid context. Both can be freed via cifs_free_hash().
|
* a valid context. Both can be freed via cifs_free_hash().
|
||||||
|
@ -1103,6 +1107,8 @@ cifs_alloc_hash(const char *name,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* cifs_free_hash - free hash and hash context together
|
* cifs_free_hash - free hash and hash context together
|
||||||
|
* @shash: Where to find the pointer to the hash algo
|
||||||
|
* @sdesc: Where to find the pointer to the hash descriptor
|
||||||
*
|
*
|
||||||
* Freeing a NULL hash or context is safe.
|
* Freeing a NULL hash or context is safe.
|
||||||
*/
|
*/
|
||||||
|
@ -1118,8 +1124,10 @@ cifs_free_hash(struct crypto_shash **shash, struct sdesc **sdesc)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* rqst_page_get_length - obtain the length and offset for a page in smb_rqst
|
* rqst_page_get_length - obtain the length and offset for a page in smb_rqst
|
||||||
* Input: rqst - a smb_rqst, page - a page index for rqst
|
* @rqst: The request descriptor
|
||||||
* Output: *len - the length for this page, *offset - the offset for this page
|
* @page: The index of the page to query
|
||||||
|
* @len: Where to store the length for this page:
|
||||||
|
* @offset: Where to store the offset for this page
|
||||||
*/
|
*/
|
||||||
void rqst_page_get_length(struct smb_rqst *rqst, unsigned int page,
|
void rqst_page_get_length(struct smb_rqst *rqst, unsigned int page,
|
||||||
unsigned int *len, unsigned int *offset)
|
unsigned int *len, unsigned int *offset)
|
||||||
|
@ -1152,6 +1160,8 @@ void extract_unc_hostname(const char *unc, const char **h, size_t *len)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* copy_path_name - copy src path to dst, possibly truncating
|
* copy_path_name - copy src path to dst, possibly truncating
|
||||||
|
* @dst: The destination buffer
|
||||||
|
* @src: The source name
|
||||||
*
|
*
|
||||||
* returns number of bytes written (including trailing nul)
|
* returns number of bytes written (including trailing nul)
|
||||||
*/
|
*/
|
||||||
|
|
Loading…
Reference in New Issue