Merge branch 'release' of git://git.kernel.org/pub/scm/linux/kernel/git/aegl/linux-2.6
[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                 /* FIXME: kzalloc_node(size, gfp, node) */
58                 pdata->ptrs[cpu] = kmalloc_node(size, gfp, node);
59                 if (pdata->ptrs[cpu])
60                         memset(pdata->ptrs[cpu], 0, size);
61         } else
62                 pdata->ptrs[cpu] = kzalloc(size, gfp);
63         return pdata->ptrs[cpu];
64 }
65 EXPORT_SYMBOL_GPL(percpu_populate);
66
67 /**
68  * percpu_populate_mask - populate per-cpu data for more cpu's
69  * @__pdata: per-cpu data to populate further
70  * @size: size of per-cpu object
71  * @gfp: may sleep or not etc.
72  * @mask: populate per-cpu data for cpu's selected through mask bits
73  *
74  * Per-cpu objects are populated with zeroed buffers.
75  */
76 int __percpu_populate_mask(void *__pdata, size_t size, gfp_t gfp,
77                            cpumask_t *mask)
78 {
79         cpumask_t populated = CPU_MASK_NONE;
80         int cpu;
81
82         for_each_cpu_mask(cpu, *mask)
83                 if (unlikely(!percpu_populate(__pdata, size, gfp, cpu))) {
84                         __percpu_depopulate_mask(__pdata, &populated);
85                         return -ENOMEM;
86                 } else
87                         cpu_set(cpu, populated);
88         return 0;
89 }
90 EXPORT_SYMBOL_GPL(__percpu_populate_mask);
91
92 /**
93  * percpu_alloc_mask - initial setup of per-cpu data
94  * @size: size of per-cpu object
95  * @gfp: may sleep or not etc.
96  * @mask: populate per-data for cpu's selected through mask bits
97  *
98  * Populating per-cpu data for all online cpu's would be a typical use case,
99  * which is simplified by the percpu_alloc() wrapper.
100  * Per-cpu objects are populated with zeroed buffers.
101  */
102 void *__percpu_alloc_mask(size_t size, gfp_t gfp, cpumask_t *mask)
103 {
104         void *pdata = kzalloc(sizeof(struct percpu_data), gfp);
105         void *__pdata = __percpu_disguise(pdata);
106
107         if (unlikely(!pdata))
108                 return NULL;
109         if (likely(!__percpu_populate_mask(__pdata, size, gfp, mask)))
110                 return __pdata;
111         kfree(pdata);
112         return NULL;
113 }
114 EXPORT_SYMBOL_GPL(__percpu_alloc_mask);
115
116 /**
117  * percpu_free - final cleanup of per-cpu data
118  * @__pdata: object to clean up
119  *
120  * We simply clean up any per-cpu object left. No need for the client to
121  * track and specify through a bis mask which per-cpu objects are to free.
122  */
123 void percpu_free(void *__pdata)
124 {
125         if (unlikely(!__pdata))
126                 return;
127         __percpu_depopulate_mask(__pdata, &cpu_possible_map);
128         kfree(__percpu_disguise(__pdata));
129 }
130 EXPORT_SYMBOL_GPL(percpu_free);