linux-kernel - Re: [PATCH 1/4] scatterlist: new helper functions

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-Id: <20110111155803.5638ec4e.rdunlap@xenotime.net>
Date:	Tue, 11 Jan 2011 15:58:03 -0800
From:	Randy Dunlap <rdunlap@...otime.net>
To:	Andrew Morton <akpm@...ux-foundation.org>
Cc:	Maxim Levitsky <maximlevitsky@...il.com>,
	LKML <linux-kernel@...r.kernel.org>,
	Takashi Iwai <tiwai@...e.de>, Alex Dubov <oakad@...oo.com>
Subject: Re: [PATCH 1/4] scatterlist: new helper functions

On Tue, 11 Jan 2011 15:55:11 -0800 Andrew Morton wrote:

> On Tue, 11 Jan 2011 15:51:24 -0800
> Randy Dunlap <rdunlap@...otime.net> wrote:
> 
> > >  /**
> > > + * sg_advance - advance scatterlist by 'consumed' bytes
> > > + * @sg - the current sg entry
> > > + * @consumed - how much bytes to advance
> > 
> > kernel-doc notation for parameters is like so:
> 
> I think I fixed most of this.  Probably missed some though.
> 
> Teach checkpatch to check kerneldoc ;)
> 

ugh, no thanks.

> 
> 
> From: Andrew Morton <akpm@...ux-foundation.org>
> 
> fix general disaster in code comments
> 
> Cc: Alex Dubov <oakad@...oo.com>
> Cc: James Bottomley <James.Bottomley@...senPartnership.com>
> Cc: Jens Axboe <axboe@...nel.dk>
> Cc: Maxim Levitsky <maximlevitsky@...il.com>
> Cc: Tejun Heo <tj@...nel.org>
> Signed-off-by: Andrew Morton <akpm@...ux-foundation.org>
> ---
> 
>  lib/scatterlist.c |   31 ++++++++++++++++++-------------
>  1 file changed, 18 insertions(+), 13 deletions(-)
> 
> diff -puN lib/scatterlist.c~scatterlist-new-helper-functions-fix lib/scatterlist.c
> --- a/lib/scatterlist.c~scatterlist-new-helper-functions-fix
> +++ a/lib/scatterlist.c
> @@ -41,7 +41,7 @@ EXPORT_SYMBOL(sg_next);
>  /**
>   * sg_advance - advance scatterlist by 'consumed' bytes
>   * @sg - the current sg entry
> - * @consumed - how much bytes to advance
> + * @consumed - how many bytes to advance

 * @consumed: how many bytes to advance

>   *
>   */
>  struct scatterlist *sg_advance(struct scatterlist *sg, int consumed)
> @@ -76,8 +76,8 @@ EXPORT_SYMBOL(sg_advance);
>   * sg_nents - calculate number of sg entries in sg list
>   * @sg - the current sg entry

 * @sg:

>   *
> - * Allows to calculate dynamicly the lenght of the sg table, based on
> - * assumption that last entry is NULL
> + * Allows to calculate aldynamicly the length of the sg table, based on an
> + * assumption that the last entry is NULL
>   */
>  int sg_nents(struct scatterlist *sg)
>  {
> @@ -92,11 +92,11 @@ int sg_nents(struct scatterlist *sg)
>  EXPORT_SYMBOL(sg_nents);
>  
>  /**
> - * sg_total_len - calculate total lenght of scatterlist
> + * sg_total_len - calculate total length of scatterlist
>   * @sg - the current sg entry

 * @sg:

>   *
> - * Dynamicly calculate total number of bytes in a sg list
> - * based on assumption that list ends with a NULL entry
> + * Dynamically calculate total number of bytes in a sg list

preferably:
                                                  in an sg list

> + * based on an assumption that the list ends with a NULL entry
>   */
>  int sg_total_len(struct scatterlist *sg)
>  {
> @@ -182,8 +182,14 @@ void sg_init_one(struct scatterlist *sg,
>  EXPORT_SYMBOL(sg_init_one);
>  
>  /**
> - * sg_copy - copies sg entries from sg_from to sg_to, such
> - * as sg_to covers first 'len' bytes from sg_from.
> + * sg_copy - copy sg entries
> + * @sg_from: source
> + * @sg_to: destination
> + *
> + * Copies from @sg_from to @sg_to.  @sg_to covers first 'len' bytes from
> + * @sg_from.
> + *
> + * Returns zero on success, else a -ve errno.
>   */
>  int sg_copy(struct scatterlist *sg_from, struct scatterlist *sg_to, int len)
>  {
> @@ -616,13 +622,12 @@ size_t sg_copy_to_buffer(struct scatterl
>  }
>  EXPORT_SYMBOL(sg_copy_to_buffer);
>  
> -
>  /**
> - * sg_compare_to_buffer - compare contents of the data pointeted by sg table
> + * sg_compare_to_buffer - compare contents of the data covered by an sg table
>   * to a kernel ram buffer
> - * @sg - the current sg entry
> - * @buffer - linear buffer to compare with
> - * @len - lenght of that buffer
> + * @sg: the current sg entry
> + * @buffer: linear buffer to compare with
> + * @len: length of that buffer

Returns what??

>   */
>  bool sg_compare_to_buffer(struct scatterlist *sg, u8 *buffer, size_t len)
>  {
> _
> 


---
~Randy
*** Remember to use Documentation/SubmitChecklist when testing your code ***
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/