x86_64: prepare shared kernel/crash_dump.c
[linux-2.6] / mm / allocpercpu.c
1 /*
2  * linux/mm/allocpercpu.c
3  *
4  * Separated from slab.c August 11, 2006 Christoph Lameter <clameter@sgi.com>
5  */
6 #include <linux/mm.h>
7 #include <linux/module.h>
8
9 /**
10  * percpu_depopulate - depopulate per-cpu data for given cpu
11  * @__pdata: per-cpu data to depopulate
12  * @cpu: depopulate per-cpu data for this cpu
13  *
14  * Depopulating per-cpu data for a cpu going offline would be a typical
15  * use case. You need to register a cpu hotplug handler for that purpose.
16  */
17 void percpu_depopulate(void *__pdata, int cpu)
18 {
19         struct percpu_data *pdata = __percpu_disguise(__pdata);
20
21         kfree(pdata->ptrs[cpu]);
22         pdata->ptrs[cpu] = NULL;
23 }
24 EXPORT_SYMBOL_GPL(percpu_depopulate);
25
26 /**
27  * percpu_depopulate_mask - depopulate per-cpu data for some cpu's
28  * @__pdata: per-cpu data to depopulate
29  * @mask: depopulate per-cpu data for cpu's selected through mask bits
30  */
31 void __percpu_depopulate_mask(void *__pdata, cpumask_t *mask)
32 {
33         int cpu;
34         for_each_cpu_mask(cpu, *mask)
35                 percpu_depopulate(__pdata, cpu);
36 }
37 EXPORT_SYMBOL_GPL(__percpu_depopulate_mask);
38
39 /**
40  * percpu_populate - populate per-cpu data for given cpu
41  * @__pdata: per-cpu data to populate further
42  * @size: size of per-cpu object
43  * @gfp: may sleep or not etc.
44  * @cpu: populate per-data for this cpu
45  *
46  * Populating per-cpu data for a cpu coming online would be a typical
47  * use case. You need to register a cpu hotplug handler for that purpose.
48  * Per-cpu object is populated with zeroed buffer.
49  */
50 void *percpu_populate(void *__pdata, size_t size, gfp_t gfp, int cpu)
51 {
52         struct percpu_data *pdata = __percpu_disguise(__pdata);
53         int node = cpu_to_node(cpu);
54
55         BUG_ON(pdata->ptrs[cpu]);
56         if (node_online(node))
57                 pdata->ptrs[cpu] = kmalloc_node(size, gfp|__GFP_ZERO, node);
58         else
59                 pdata->ptrs[cpu] = kzalloc(size, gfp);
60         return pdata->ptrs[cpu];
61 }
62 EXPORT_SYMBOL_GPL(percpu_populate);
63
64 /**
65  * percpu_populate_mask - populate per-cpu data for more cpu's
66  * @__pdata: per-cpu data to populate further
67  * @size: size of per-cpu object
68  * @gfp: may sleep or not etc.
69  * @mask: populate per-cpu data for cpu's selected through mask bits
70  *
71  * Per-cpu objects are populated with zeroed buffers.
72  */
73 int __percpu_populate_mask(void *__pdata, size_t size, gfp_t gfp,
74                            cpumask_t *mask)
75 {
76         cpumask_t populated = CPU_MASK_NONE;
77         int cpu;
78
79         for_each_cpu_mask(cpu, *mask)
80                 if (unlikely(!percpu_populate(__pdata, size, gfp, cpu))) {
81                         __percpu_depopulate_mask(__pdata, &populated);
82                         return -ENOMEM;
83                 } else
84                         cpu_set(cpu, populated);
85         return 0;
86 }
87 EXPORT_SYMBOL_GPL(__percpu_populate_mask);
88
89 /**
90  * percpu_alloc_mask - initial setup of per-cpu data
91  * @size: size of per-cpu object
92  * @gfp: may sleep or not etc.
93  * @mask: populate per-data for cpu's selected through mask bits
94  *
95  * Populating per-cpu data for all online cpu's would be a typical use case,
96  * which is simplified by the percpu_alloc() wrapper.
97  * Per-cpu objects are populated with zeroed buffers.
98  */
99 void *__percpu_alloc_mask(size_t size, gfp_t gfp, cpumask_t *mask)
100 {
101         void *pdata = kzalloc(sizeof(struct percpu_data), gfp);
102         void *__pdata = __percpu_disguise(pdata);
103
104         if (unlikely(!pdata))
105                 return NULL;
106         if (likely(!__percpu_populate_mask(__pdata, size, gfp, mask)))
107                 return __pdata;
108         kfree(pdata);
109         return NULL;
110 }
111 EXPORT_SYMBOL_GPL(__percpu_alloc_mask);
112
113 /**
114  * percpu_free - final cleanup of per-cpu data
115  * @__pdata: object to clean up
116  *
117  * We simply clean up any per-cpu object left. No need for the client to
118  * track and specify through a bis mask which per-cpu objects are to free.
119  */
120 void percpu_free(void *__pdata)
121 {
122         if (unlikely(!__pdata))
123                 return;
124         __percpu_depopulate_mask(__pdata, &cpu_possible_map);
125         kfree(__percpu_disguise(__pdata));
126 }
127 EXPORT_SYMBOL_GPL(percpu_free);