2 * linux/mm/allocpercpu.c
4 * Separated from slab.c August 11, 2006 Christoph Lameter <clameter@sgi.com>
7 #include <linux/module.h>
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
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.
17 void percpu_depopulate(void *__pdata, int cpu)
19 struct percpu_data *pdata = __percpu_disguise(__pdata);
21 kfree(pdata->ptrs[cpu]);
22 pdata->ptrs[cpu] = NULL;
24 EXPORT_SYMBOL_GPL(percpu_depopulate);
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
31 void __percpu_depopulate_mask(void *__pdata, cpumask_t *mask)
34 for_each_cpu_mask(cpu, *mask)
35 percpu_depopulate(__pdata, cpu);
37 EXPORT_SYMBOL_GPL(__percpu_depopulate_mask);
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
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.
50 void *percpu_populate(void *__pdata, size_t size, gfp_t gfp, int cpu)
52 struct percpu_data *pdata = __percpu_disguise(__pdata);
53 int node = cpu_to_node(cpu);
55 BUG_ON(pdata->ptrs[cpu]);
56 if (node_online(node))
57 pdata->ptrs[cpu] = kmalloc_node(size, gfp|__GFP_ZERO, node);
59 pdata->ptrs[cpu] = kzalloc(size, gfp);
60 return pdata->ptrs[cpu];
62 EXPORT_SYMBOL_GPL(percpu_populate);
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
71 * Per-cpu objects are populated with zeroed buffers.
73 int __percpu_populate_mask(void *__pdata, size_t size, gfp_t gfp,
76 cpumask_t populated = CPU_MASK_NONE;
79 for_each_cpu_mask(cpu, *mask)
80 if (unlikely(!percpu_populate(__pdata, size, gfp, cpu))) {
81 __percpu_depopulate_mask(__pdata, &populated);
84 cpu_set(cpu, populated);
87 EXPORT_SYMBOL_GPL(__percpu_populate_mask);
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
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.
99 void *__percpu_alloc_mask(size_t size, gfp_t gfp, cpumask_t *mask)
101 void *pdata = kzalloc(nr_cpu_ids * sizeof(void *), gfp);
102 void *__pdata = __percpu_disguise(pdata);
104 if (unlikely(!pdata))
106 if (likely(!__percpu_populate_mask(__pdata, size, gfp, mask)))
111 EXPORT_SYMBOL_GPL(__percpu_alloc_mask);
114 * percpu_free - final cleanup of per-cpu data
115 * @__pdata: object to clean up
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.
120 void percpu_free(void *__pdata)
122 if (unlikely(!__pdata))
124 __percpu_depopulate_mask(__pdata, &cpu_possible_map);
125 kfree(__percpu_disguise(__pdata));
127 EXPORT_SYMBOL_GPL(percpu_free);