| 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
| ||
|
Message-Id: <20060926082830.2fc081f1.rdunlap@xenotime.net>
Date: Tue, 26 Sep 2006 08:28:30 -0700
From: Randy Dunlap <rdunlap@...otime.net>
To: Rolf Eike Beer <eike-kernel@...tec.de>
Cc: Andrew Morton <akpm@...l.org>, linux-kernel@...r.kernel.org
Subject: Re: [PATCH][DOC] Fix kerneldoc comments in mm/vmalloc.c
On Tue, 26 Sep 2006 11:37:55 +0200 Rolf Eike Beer wrote:
> The empty line between the short description and the first argument
> description causes a section to appear twice in the generated manpage.
> Also the short description should really be short: the script can't handle
> multiple lines.
>
> Signed-off-by: Rolf Eike Beer <eike-kernel@...tec.de>
Acked-by: Randy Dunlap <rdunlap@...otime.net>
> ---
> commit 8322f0cb8a117fe42e993d48f5ae0fbc006f8ef0
> tree 22ddb2aa90e3a1392abcdc99fa675995a347c068
> parent da27ef8999723a92f4ac778d4196acc9383197eb
> author Rolf Eike Beer <eike-kernel@...tec.de> Tue, 26 Sep 2006 11:35:42 +0200
> committer Rolf Eike Beer <eike-kernel@...tec.de> Tue, 26 Sep 2006 11:35:42 +0200
>
> mm/vmalloc.c | 28 ++++++++--------------------
> 1 files changed, 8 insertions(+), 20 deletions(-)
>
> diff --git a/mm/vmalloc.c b/mm/vmalloc.c
> index 266162d..3ac7c03 100644
> --- a/mm/vmalloc.c
> +++ b/mm/vmalloc.c
> @@ -238,7 +238,6 @@ struct vm_struct *__get_vm_area(unsigned
>
> /**
> * get_vm_area - reserve a contingous kernel virtual area
> - *
> * @size: size of the area
> * @flags: %VM_IOREMAP for I/O mappings or VM_ALLOC
> *
> @@ -293,7 +292,6 @@ found:
>
> /**
> * remove_vm_area - find and remove a contingous kernel virtual area
> - *
> * @addr: base address
> *
> * Search for the kernel VM area starting at @addr, and remove it.
> @@ -352,7 +350,6 @@ void __vunmap(void *addr, int deallocate
>
> /**
> * vfree - release memory allocated by vmalloc()
> - *
> * @addr: memory base address
> *
> * Free the virtually contiguous memory area starting at @addr, as
> @@ -370,7 +367,6 @@ EXPORT_SYMBOL(vfree);
>
> /**
> * vunmap - release virtual mapping obtained by vmap()
> - *
> * @addr: memory base address
> *
> * Free the virtually contiguous memory area starting at @addr,
> @@ -387,7 +383,6 @@ EXPORT_SYMBOL(vunmap);
>
> /**
> * vmap - map an array of pages into virtually contiguous space
> - *
> * @pages: array of page pointers
> * @count: number of pages to map
> * @flags: vm_area->flags
> @@ -468,7 +463,6 @@ void *__vmalloc_area(struct vm_struct *a
>
> /**
> * __vmalloc_node - allocate virtually contiguous memory
> - *
> * @size: allocation size
> * @gfp_mask: flags for the page level allocator
> * @prot: protection mask for the allocated pages
> @@ -503,9 +497,7 @@ EXPORT_SYMBOL(__vmalloc);
>
> /**
> * vmalloc - allocate virtually contiguous memory
> - *
> * @size: allocation size
> - *
> * Allocate enough pages to cover @size from the page level
> * allocator and map them into contiguous kernel virtual space.
> *
> @@ -519,11 +511,11 @@ void *vmalloc(unsigned long size)
> EXPORT_SYMBOL(vmalloc);
>
> /**
> - * vmalloc_user - allocate virtually contiguous memory which has
> - * been zeroed so it can be mapped to userspace without
> - * leaking data.
> + * vmalloc_user - allocate zeroed virtually contiguous memory for userspace
> + * @size: allocation size
> *
> - * @size: allocation size
> + * The resulting memory area is zeroed so it can be mapped to userspace
> + * without leaking data.
> */
> void *vmalloc_user(unsigned long size)
> {
> @@ -542,7 +534,6 @@ EXPORT_SYMBOL(vmalloc_user);
>
> /**
> * vmalloc_node - allocate memory on a specific node
> - *
> * @size: allocation size
> * @node: numa node
> *
> @@ -564,7 +555,6 @@ #endif
>
> /**
> * vmalloc_exec - allocate virtually contiguous, executable memory
> - *
> * @size: allocation size
> *
> * Kernel-internal function to allocate enough pages to cover @size
> @@ -582,7 +572,6 @@ void *vmalloc_exec(unsigned long size)
>
> /**
> * vmalloc_32 - allocate virtually contiguous memory (32bit addressable)
> - *
> * @size: allocation size
> *
> * Allocate enough 32bit PA addressable pages to cover @size from the
> @@ -595,11 +584,11 @@ void *vmalloc_32(unsigned long size)
> EXPORT_SYMBOL(vmalloc_32);
>
> /**
> - * vmalloc_32_user - allocate virtually contiguous memory (32bit
> - * addressable) which is zeroed so it can be
> - * mapped to userspace without leaking data.
> - *
> + * vmalloc_32_user - allocate zeroed virtually contiguous 32bit memory
> * @size: allocation size
> + *
> + * The resulting memory area is 32bit addressable and zeroed so it can be
> + * mapped to userspace without leaking data.
> */
> void *vmalloc_32_user(unsigned long size)
> {
> @@ -693,7 +682,6 @@ finished:
>
> /**
> * remap_vmalloc_range - map vmalloc pages to userspace
> - *
> * @vma: vma to cover (map full range of vma)
> * @addr: vmalloc memory
> * @pgoff: number of pages into addr before first page to map
>
---
~Randy
-
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/
Powered by blists - more mailing lists