| 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
| ||
|
Date: Mon Nov 17 23:48:27 CST 2008
From: Rusty Russell <rusty@...tcorp.com.au>
To: linux-kernel@...r.kernel.org
Cc: Christoph Lameter <cl@...ux-foundation.org>
Subject: [PATCH 5/7] Improve alloc_percpu: documentation
Since we can now endorse this interface without wincing, we should
document it. Nothing has changed API-wise, but it's a nice cleanup.
Signed-off-by: Rusty Russell <rusty@...tcorp.com.au>
Cc: Christoph Lameter <cl@...ux-foundation.org>
---
include/asm-generic/percpu.h | 8 ++++++++
include/linux/percpu.h | 10 ++++++++++
mm/allocpercpu.c | 13 +++++++++++++
3 files changed, 31 insertions(+)
diff -r cf4fb53a413e include/asm-generic/percpu.h
--- a/include/asm-generic/percpu.h Mon Nov 17 22:19:33 2008 +1030
+++ b/include/asm-generic/percpu.h Mon Nov 17 22:19:40 2008 +1030
@@ -61,6 +61,14 @@
(*SHIFT_PERCPU_PTR(&per_cpu_var(var), __my_cpu_offset))
/* Use RELOC_HIDE: some arch's SHIFT_PERCPU_PTR really want an identifier. */
+/**
+ * per_cpu_ptr - get a pointer to a particular cpu's allocated memory
+ * @ptr: the pointer returned from alloc_percpu
+ * @cpu: the cpu whose memory you want to access
+ *
+ * Similar to per_cpu(), except for dynamic memory.
+ * cpu_possible(@cpu) must be true.
+ */
#define per_cpu_ptr(ptr, cpu) \
RELOC_HIDE((ptr), (per_cpu_offset(cpu)))
diff -r cf4fb53a413e include/linux/percpu.h
--- a/include/linux/percpu.h Mon Nov 17 22:19:33 2008 +1030
+++ b/include/linux/percpu.h Mon Nov 17 22:19:40 2008 +1030
@@ -72,6 +72,16 @@
}
#endif /* CONFIG_SMP */
+/**
+ * alloc_percpu - allocate memory on every possible cpu.
+ * @type: the type to allocate
+ *
+ * Allocates memory for use with per_cpu_ptr/get_cpu_ptr/__get_cpu_ptr.
+ * The memory is always zeroed. Returns NULL on failure.
+ *
+ * Note that percpu memory is a limited resource; it's usually used for small
+ * allocations.
+ */
#define alloc_percpu(type) \
(type *)__alloc_percpu(sizeof(type), __alignof__(type))
diff -r cf4fb53a413e mm/allocpercpu.c
--- a/mm/allocpercpu.c Mon Nov 17 22:19:33 2008 +1030
+++ b/mm/allocpercpu.c Mon Nov 17 22:19:40 2008 +1030
@@ -45,6 +45,13 @@
return val;
}
+/**
+ * __alloc_percpu - allocate dynamic percpu memory
+ * @size: bytes to allocate
+ * @align: bytes to align (< PAGE_SIZE)
+ *
+ * See alloc_percpu().
+ */
void *__alloc_percpu(unsigned long size, unsigned long align)
{
unsigned long extra;
@@ -91,6 +98,12 @@
}
EXPORT_SYMBOL_GPL(__alloc_percpu);
+/**
+ * free_percpu - free memory allocated with alloc_percpu.
+ * @pcpuptr: the pointer returned from alloc_percpu.
+ *
+ * Like kfree(), the argument can be NULL.
+ */
void free_percpu(void *freeme)
{
unsigned int i;
--
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