]> Git Repo - linux.git/blame - mm/slab_common.c
mm/slab_common: cleanup kmalloc_large()
[linux.git] / mm / slab_common.c
CommitLineData
b2441318 1// SPDX-License-Identifier: GPL-2.0
039363f3
CL
2/*
3 * Slab allocator functions that are independent of the allocator strategy
4 *
5 * (C) 2012 Christoph Lameter <[email protected]>
6 */
7#include <linux/slab.h>
8
9#include <linux/mm.h>
10#include <linux/poison.h>
11#include <linux/interrupt.h>
12#include <linux/memory.h>
1c99ba29 13#include <linux/cache.h>
039363f3 14#include <linux/compiler.h>
d3fb45f3 15#include <linux/kfence.h>
039363f3 16#include <linux/module.h>
20cea968
CL
17#include <linux/cpu.h>
18#include <linux/uaccess.h>
b7454ad3
GC
19#include <linux/seq_file.h>
20#include <linux/proc_fs.h>
fcf8a1e4 21#include <linux/debugfs.h>
e86f8b09 22#include <linux/kasan.h>
039363f3
CL
23#include <asm/cacheflush.h>
24#include <asm/tlbflush.h>
25#include <asm/page.h>
2633d7a0 26#include <linux/memcontrol.h>
5cf909c5 27#include <linux/stackdepot.h>
928cec9c 28
44405099 29#include "internal.h"
97d06609
CL
30#include "slab.h"
31
b347aa7b
VA
32#define CREATE_TRACE_POINTS
33#include <trace/events/kmem.h>
34
97d06609 35enum slab_state slab_state;
18004c5d
CL
36LIST_HEAD(slab_caches);
37DEFINE_MUTEX(slab_mutex);
9b030cb8 38struct kmem_cache *kmem_cache;
97d06609 39
657dc2f9
TH
40static LIST_HEAD(slab_caches_to_rcu_destroy);
41static void slab_caches_to_rcu_destroy_workfn(struct work_struct *work);
42static DECLARE_WORK(slab_caches_to_rcu_destroy_work,
43 slab_caches_to_rcu_destroy_workfn);
44
423c929c
JK
45/*
46 * Set of flags that will prevent slab merging
47 */
48#define SLAB_NEVER_MERGE (SLAB_RED_ZONE | SLAB_POISON | SLAB_STORE_USER | \
5f0d5a3a 49 SLAB_TRACE | SLAB_TYPESAFE_BY_RCU | SLAB_NOLEAKTRACE | \
e86f8b09 50 SLAB_FAILSLAB | kasan_never_merge())
423c929c 51
230e9fc2 52#define SLAB_MERGE_SAME (SLAB_RECLAIM_ACCOUNT | SLAB_CACHE_DMA | \
6d6ea1e9 53 SLAB_CACHE_DMA32 | SLAB_ACCOUNT)
423c929c
JK
54
55/*
56 * Merge control. If this is set then no merging of slab caches will occur.
423c929c 57 */
7660a6fd 58static bool slab_nomerge = !IS_ENABLED(CONFIG_SLAB_MERGE_DEFAULT);
423c929c
JK
59
60static int __init setup_slab_nomerge(char *str)
61{
7660a6fd 62 slab_nomerge = true;
423c929c
JK
63 return 1;
64}
65
82edd9d5
RA
66static int __init setup_slab_merge(char *str)
67{
68 slab_nomerge = false;
69 return 1;
70}
71
423c929c
JK
72#ifdef CONFIG_SLUB
73__setup_param("slub_nomerge", slub_nomerge, setup_slab_nomerge, 0);
82edd9d5 74__setup_param("slub_merge", slub_merge, setup_slab_merge, 0);
423c929c
JK
75#endif
76
77__setup("slab_nomerge", setup_slab_nomerge);
82edd9d5 78__setup("slab_merge", setup_slab_merge);
423c929c 79
07f361b2
JK
80/*
81 * Determine the size of a slab object
82 */
83unsigned int kmem_cache_size(struct kmem_cache *s)
84{
85 return s->object_size;
86}
87EXPORT_SYMBOL(kmem_cache_size);
88
77be4b13 89#ifdef CONFIG_DEBUG_VM
f4957d5b 90static int kmem_cache_sanity_check(const char *name, unsigned int size)
039363f3 91{
74c1d3e0 92 if (!name || in_interrupt() || size > KMALLOC_MAX_SIZE) {
77be4b13
SK
93 pr_err("kmem_cache_create(%s) integrity check failed\n", name);
94 return -EINVAL;
039363f3 95 }
b920536a 96
20cea968 97 WARN_ON(strchr(name, ' ')); /* It confuses parsers */
77be4b13
SK
98 return 0;
99}
100#else
f4957d5b 101static inline int kmem_cache_sanity_check(const char *name, unsigned int size)
77be4b13
SK
102{
103 return 0;
104}
20cea968
CL
105#endif
106
692ae74a
BL
107/*
108 * Figure out what the alignment of the objects will be given a set of
109 * flags, a user specified alignment and the size of the objects.
110 */
f4957d5b
AD
111static unsigned int calculate_alignment(slab_flags_t flags,
112 unsigned int align, unsigned int size)
692ae74a
BL
113{
114 /*
115 * If the user wants hardware cache aligned objects then follow that
116 * suggestion if the object is sufficiently large.
117 *
118 * The hardware cache alignment cannot override the specified
119 * alignment though. If that is greater then use it.
120 */
121 if (flags & SLAB_HWCACHE_ALIGN) {
f4957d5b 122 unsigned int ralign;
692ae74a
BL
123
124 ralign = cache_line_size();
125 while (size <= ralign / 2)
126 ralign /= 2;
127 align = max(align, ralign);
128 }
129
d949a815 130 align = max(align, arch_slab_minalign());
692ae74a
BL
131
132 return ALIGN(align, sizeof(void *));
133}
134
423c929c
JK
135/*
136 * Find a mergeable slab cache
137 */
138int slab_unmergeable(struct kmem_cache *s)
139{
140 if (slab_nomerge || (s->flags & SLAB_NEVER_MERGE))
141 return 1;
142
423c929c
JK
143 if (s->ctor)
144 return 1;
145
8eb8284b
DW
146 if (s->usersize)
147 return 1;
148
423c929c
JK
149 /*
150 * We may have set a slab to be unmergeable during bootstrap.
151 */
152 if (s->refcount < 0)
153 return 1;
154
155 return 0;
156}
157
f4957d5b 158struct kmem_cache *find_mergeable(unsigned int size, unsigned int align,
d50112ed 159 slab_flags_t flags, const char *name, void (*ctor)(void *))
423c929c
JK
160{
161 struct kmem_cache *s;
162
c6e28895 163 if (slab_nomerge)
423c929c
JK
164 return NULL;
165
166 if (ctor)
167 return NULL;
168
169 size = ALIGN(size, sizeof(void *));
170 align = calculate_alignment(flags, align, size);
171 size = ALIGN(size, align);
37540008 172 flags = kmem_cache_flags(size, flags, name);
423c929c 173
c6e28895
GM
174 if (flags & SLAB_NEVER_MERGE)
175 return NULL;
176
c7094406 177 list_for_each_entry_reverse(s, &slab_caches, list) {
423c929c
JK
178 if (slab_unmergeable(s))
179 continue;
180
181 if (size > s->size)
182 continue;
183
184 if ((flags & SLAB_MERGE_SAME) != (s->flags & SLAB_MERGE_SAME))
185 continue;
186 /*
187 * Check if alignment is compatible.
188 * Courtesy of Adrian Drzewiecki
189 */
190 if ((s->size & ~(align - 1)) != s->size)
191 continue;
192
193 if (s->size - size >= sizeof(void *))
194 continue;
195
95069ac8
JK
196 if (IS_ENABLED(CONFIG_SLAB) && align &&
197 (align > s->align || s->align % align))
198 continue;
199
423c929c
JK
200 return s;
201 }
202 return NULL;
203}
204
c9a77a79 205static struct kmem_cache *create_cache(const char *name,
613a5eb5 206 unsigned int object_size, unsigned int align,
7bbdb81e
AD
207 slab_flags_t flags, unsigned int useroffset,
208 unsigned int usersize, void (*ctor)(void *),
9855609b 209 struct kmem_cache *root_cache)
794b1248
VD
210{
211 struct kmem_cache *s;
212 int err;
213
8eb8284b
DW
214 if (WARN_ON(useroffset + usersize > object_size))
215 useroffset = usersize = 0;
216
794b1248
VD
217 err = -ENOMEM;
218 s = kmem_cache_zalloc(kmem_cache, GFP_KERNEL);
219 if (!s)
220 goto out;
221
222 s->name = name;
613a5eb5 223 s->size = s->object_size = object_size;
794b1248
VD
224 s->align = align;
225 s->ctor = ctor;
8eb8284b
DW
226 s->useroffset = useroffset;
227 s->usersize = usersize;
794b1248 228
794b1248
VD
229 err = __kmem_cache_create(s, flags);
230 if (err)
231 goto out_free_cache;
232
233 s->refcount = 1;
234 list_add(&s->list, &slab_caches);
794b1248
VD
235out:
236 if (err)
237 return ERR_PTR(err);
238 return s;
239
240out_free_cache:
7c4da061 241 kmem_cache_free(kmem_cache, s);
794b1248
VD
242 goto out;
243}
45906855 244
f496990f
MR
245/**
246 * kmem_cache_create_usercopy - Create a cache with a region suitable
247 * for copying to userspace
77be4b13
SK
248 * @name: A string which is used in /proc/slabinfo to identify this cache.
249 * @size: The size of objects to be created in this cache.
250 * @align: The required alignment for the objects.
251 * @flags: SLAB flags
8eb8284b
DW
252 * @useroffset: Usercopy region offset
253 * @usersize: Usercopy region size
77be4b13
SK
254 * @ctor: A constructor for the objects.
255 *
77be4b13
SK
256 * Cannot be called within a interrupt, but can be interrupted.
257 * The @ctor is run when new pages are allocated by the cache.
258 *
259 * The flags are
260 *
261 * %SLAB_POISON - Poison the slab with a known test pattern (a5a5a5a5)
262 * to catch references to uninitialised memory.
263 *
f496990f 264 * %SLAB_RED_ZONE - Insert `Red` zones around the allocated memory to check
77be4b13
SK
265 * for buffer overruns.
266 *
267 * %SLAB_HWCACHE_ALIGN - Align the objects in this cache to a hardware
268 * cacheline. This can be beneficial if you're counting cycles as closely
269 * as davem.
f496990f
MR
270 *
271 * Return: a pointer to the cache on success, NULL on failure.
77be4b13 272 */
2633d7a0 273struct kmem_cache *
f4957d5b
AD
274kmem_cache_create_usercopy(const char *name,
275 unsigned int size, unsigned int align,
7bbdb81e
AD
276 slab_flags_t flags,
277 unsigned int useroffset, unsigned int usersize,
8eb8284b 278 void (*ctor)(void *))
77be4b13 279{
40911a79 280 struct kmem_cache *s = NULL;
3dec16ea 281 const char *cache_name;
3965fc36 282 int err;
039363f3 283
afe0c26d
VB
284#ifdef CONFIG_SLUB_DEBUG
285 /*
286 * If no slub_debug was enabled globally, the static key is not yet
287 * enabled by setup_slub_debug(). Enable it if the cache is being
288 * created with any of the debugging flags passed explicitly.
5cf909c5
OG
289 * It's also possible that this is the first cache created with
290 * SLAB_STORE_USER and we should init stack_depot for it.
afe0c26d
VB
291 */
292 if (flags & SLAB_DEBUG_FLAGS)
293 static_branch_enable(&slub_debug_enabled);
5cf909c5
OG
294 if (flags & SLAB_STORE_USER)
295 stack_depot_init();
afe0c26d
VB
296#endif
297
77be4b13 298 mutex_lock(&slab_mutex);
686d550d 299
794b1248 300 err = kmem_cache_sanity_check(name, size);
3aa24f51 301 if (err) {
3965fc36 302 goto out_unlock;
3aa24f51 303 }
686d550d 304
e70954fd
TG
305 /* Refuse requests with allocator specific flags */
306 if (flags & ~SLAB_FLAGS_PERMITTED) {
307 err = -EINVAL;
308 goto out_unlock;
309 }
310
d8843922
GC
311 /*
312 * Some allocators will constraint the set of valid flags to a subset
313 * of all flags. We expect them to define CACHE_CREATE_MASK in this
314 * case, and we'll just provide them with a sanitized version of the
315 * passed flags.
316 */
317 flags &= CACHE_CREATE_MASK;
686d550d 318
8eb8284b
DW
319 /* Fail closed on bad usersize of useroffset values. */
320 if (WARN_ON(!usersize && useroffset) ||
321 WARN_ON(size < usersize || size - usersize < useroffset))
322 usersize = useroffset = 0;
323
324 if (!usersize)
325 s = __kmem_cache_alias(name, size, align, flags, ctor);
794b1248 326 if (s)
3965fc36 327 goto out_unlock;
2633d7a0 328
3dec16ea 329 cache_name = kstrdup_const(name, GFP_KERNEL);
794b1248
VD
330 if (!cache_name) {
331 err = -ENOMEM;
332 goto out_unlock;
333 }
7c9adf5a 334
613a5eb5 335 s = create_cache(cache_name, size,
c9a77a79 336 calculate_alignment(flags, align, size),
9855609b 337 flags, useroffset, usersize, ctor, NULL);
794b1248
VD
338 if (IS_ERR(s)) {
339 err = PTR_ERR(s);
3dec16ea 340 kfree_const(cache_name);
794b1248 341 }
3965fc36
VD
342
343out_unlock:
20cea968 344 mutex_unlock(&slab_mutex);
03afc0e2 345
ba3253c7 346 if (err) {
686d550d 347 if (flags & SLAB_PANIC)
4acaa7d5 348 panic("%s: Failed to create slab '%s'. Error %d\n",
349 __func__, name, err);
686d550d 350 else {
4acaa7d5 351 pr_warn("%s(%s) failed with error %d\n",
352 __func__, name, err);
686d550d
CL
353 dump_stack();
354 }
686d550d
CL
355 return NULL;
356 }
039363f3
CL
357 return s;
358}
8eb8284b
DW
359EXPORT_SYMBOL(kmem_cache_create_usercopy);
360
f496990f
MR
361/**
362 * kmem_cache_create - Create a cache.
363 * @name: A string which is used in /proc/slabinfo to identify this cache.
364 * @size: The size of objects to be created in this cache.
365 * @align: The required alignment for the objects.
366 * @flags: SLAB flags
367 * @ctor: A constructor for the objects.
368 *
369 * Cannot be called within a interrupt, but can be interrupted.
370 * The @ctor is run when new pages are allocated by the cache.
371 *
372 * The flags are
373 *
374 * %SLAB_POISON - Poison the slab with a known test pattern (a5a5a5a5)
375 * to catch references to uninitialised memory.
376 *
377 * %SLAB_RED_ZONE - Insert `Red` zones around the allocated memory to check
378 * for buffer overruns.
379 *
380 * %SLAB_HWCACHE_ALIGN - Align the objects in this cache to a hardware
381 * cacheline. This can be beneficial if you're counting cycles as closely
382 * as davem.
383 *
384 * Return: a pointer to the cache on success, NULL on failure.
385 */
8eb8284b 386struct kmem_cache *
f4957d5b 387kmem_cache_create(const char *name, unsigned int size, unsigned int align,
8eb8284b
DW
388 slab_flags_t flags, void (*ctor)(void *))
389{
6d07d1cd 390 return kmem_cache_create_usercopy(name, size, align, flags, 0, 0,
8eb8284b
DW
391 ctor);
392}
794b1248 393EXPORT_SYMBOL(kmem_cache_create);
2633d7a0 394
657dc2f9 395static void slab_caches_to_rcu_destroy_workfn(struct work_struct *work)
d5b3cf71 396{
657dc2f9
TH
397 LIST_HEAD(to_destroy);
398 struct kmem_cache *s, *s2;
d5b3cf71 399
657dc2f9 400 /*
5f0d5a3a 401 * On destruction, SLAB_TYPESAFE_BY_RCU kmem_caches are put on the
657dc2f9 402 * @slab_caches_to_rcu_destroy list. The slab pages are freed
081a06fa 403 * through RCU and the associated kmem_cache are dereferenced
657dc2f9
TH
404 * while freeing the pages, so the kmem_caches should be freed only
405 * after the pending RCU operations are finished. As rcu_barrier()
406 * is a pretty slow operation, we batch all pending destructions
407 * asynchronously.
408 */
409 mutex_lock(&slab_mutex);
410 list_splice_init(&slab_caches_to_rcu_destroy, &to_destroy);
411 mutex_unlock(&slab_mutex);
d5b3cf71 412
657dc2f9
TH
413 if (list_empty(&to_destroy))
414 return;
415
416 rcu_barrier();
417
418 list_for_each_entry_safe(s, s2, &to_destroy, list) {
64dd6849 419 debugfs_slab_release(s);
d3fb45f3 420 kfence_shutdown_cache(s);
657dc2f9
TH
421#ifdef SLAB_SUPPORTS_SYSFS
422 sysfs_slab_release(s);
423#else
424 slab_kmem_cache_release(s);
425#endif
426 }
d5b3cf71
VD
427}
428
657dc2f9 429static int shutdown_cache(struct kmem_cache *s)
d5b3cf71 430{
f9fa1d91
GT
431 /* free asan quarantined objects */
432 kasan_cache_shutdown(s);
433
657dc2f9
TH
434 if (__kmem_cache_shutdown(s) != 0)
435 return -EBUSY;
d5b3cf71 436
657dc2f9 437 list_del(&s->list);
d5b3cf71 438
5f0d5a3a 439 if (s->flags & SLAB_TYPESAFE_BY_RCU) {
d50d82fa
MP
440#ifdef SLAB_SUPPORTS_SYSFS
441 sysfs_slab_unlink(s);
442#endif
657dc2f9
TH
443 list_add_tail(&s->list, &slab_caches_to_rcu_destroy);
444 schedule_work(&slab_caches_to_rcu_destroy_work);
445 } else {
d3fb45f3 446 kfence_shutdown_cache(s);
64dd6849 447 debugfs_slab_release(s);
d5b3cf71 448#ifdef SLAB_SUPPORTS_SYSFS
d50d82fa 449 sysfs_slab_unlink(s);
bf5eb3de 450 sysfs_slab_release(s);
d5b3cf71
VD
451#else
452 slab_kmem_cache_release(s);
453#endif
454 }
657dc2f9
TH
455
456 return 0;
d5b3cf71
VD
457}
458
41a21285
CL
459void slab_kmem_cache_release(struct kmem_cache *s)
460{
52b4b950 461 __kmem_cache_release(s);
3dec16ea 462 kfree_const(s->name);
41a21285
CL
463 kmem_cache_free(kmem_cache, s);
464}
465
945cf2b6
CL
466void kmem_cache_destroy(struct kmem_cache *s)
467{
bed0a9b5 468 if (unlikely(!s) || !kasan_check_byte(s))
3942d299
SS
469 return;
470
5a836bf6 471 cpus_read_lock();
945cf2b6 472 mutex_lock(&slab_mutex);
b8529907 473
945cf2b6 474 s->refcount--;
b8529907
VD
475 if (s->refcount)
476 goto out_unlock;
477
7302e91f
ME
478 WARN(shutdown_cache(s),
479 "%s %s: Slab cache still has objects when called from %pS",
480 __func__, s->name, (void *)_RET_IP_);
b8529907
VD
481out_unlock:
482 mutex_unlock(&slab_mutex);
5a836bf6 483 cpus_read_unlock();
945cf2b6
CL
484}
485EXPORT_SYMBOL(kmem_cache_destroy);
486
03afc0e2
VD
487/**
488 * kmem_cache_shrink - Shrink a cache.
489 * @cachep: The cache to shrink.
490 *
491 * Releases as many slabs as possible for a cache.
492 * To help debugging, a zero exit status indicates all slabs were released.
a862f68a
MR
493 *
494 * Return: %0 if all slabs were released, non-zero otherwise
03afc0e2
VD
495 */
496int kmem_cache_shrink(struct kmem_cache *cachep)
497{
498 int ret;
499
7e1fa93d 500
55834c59 501 kasan_cache_shrink(cachep);
c9fc5864 502 ret = __kmem_cache_shrink(cachep);
7e1fa93d 503
03afc0e2
VD
504 return ret;
505}
506EXPORT_SYMBOL(kmem_cache_shrink);
507
fda90124 508bool slab_is_available(void)
97d06609
CL
509{
510 return slab_state >= UP;
511}
b7454ad3 512
5bb1bb35 513#ifdef CONFIG_PRINTK
8e7f37f2
PM
514/**
515 * kmem_valid_obj - does the pointer reference a valid slab object?
516 * @object: pointer to query.
517 *
518 * Return: %true if the pointer is to a not-yet-freed object from
519 * kmalloc() or kmem_cache_alloc(), either %true or %false if the pointer
520 * is to an already-freed object, and %false otherwise.
521 */
522bool kmem_valid_obj(void *object)
523{
7213230a 524 struct folio *folio;
8e7f37f2
PM
525
526 /* Some arches consider ZERO_SIZE_PTR to be a valid address. */
527 if (object < (void *)PAGE_SIZE || !virt_addr_valid(object))
528 return false;
7213230a
MWO
529 folio = virt_to_folio(object);
530 return folio_test_slab(folio);
8e7f37f2 531}
0d3dd2c8 532EXPORT_SYMBOL_GPL(kmem_valid_obj);
8e7f37f2 533
2dfe63e6
ME
534static void kmem_obj_info(struct kmem_obj_info *kpp, void *object, struct slab *slab)
535{
536 if (__kfence_obj_info(kpp, object, slab))
537 return;
538 __kmem_obj_info(kpp, object, slab);
539}
540
8e7f37f2
PM
541/**
542 * kmem_dump_obj - Print available slab provenance information
543 * @object: slab object for which to find provenance information.
544 *
545 * This function uses pr_cont(), so that the caller is expected to have
546 * printed out whatever preamble is appropriate. The provenance information
547 * depends on the type of object and on how much debugging is enabled.
548 * For a slab-cache object, the fact that it is a slab object is printed,
549 * and, if available, the slab name, return address, and stack trace from
e548eaa1 550 * the allocation and last free path of that object.
8e7f37f2
PM
551 *
552 * This function will splat if passed a pointer to a non-slab object.
553 * If you are not sure what type of object you have, you should instead
554 * use mem_dump_obj().
555 */
556void kmem_dump_obj(void *object)
557{
558 char *cp = IS_ENABLED(CONFIG_MMU) ? "" : "/vmalloc";
559 int i;
7213230a 560 struct slab *slab;
8e7f37f2
PM
561 unsigned long ptroffset;
562 struct kmem_obj_info kp = { };
563
564 if (WARN_ON_ONCE(!virt_addr_valid(object)))
565 return;
7213230a
MWO
566 slab = virt_to_slab(object);
567 if (WARN_ON_ONCE(!slab)) {
8e7f37f2
PM
568 pr_cont(" non-slab memory.\n");
569 return;
570 }
7213230a 571 kmem_obj_info(&kp, object, slab);
8e7f37f2
PM
572 if (kp.kp_slab_cache)
573 pr_cont(" slab%s %s", cp, kp.kp_slab_cache->name);
574 else
575 pr_cont(" slab%s", cp);
2dfe63e6
ME
576 if (is_kfence_address(object))
577 pr_cont(" (kfence)");
8e7f37f2
PM
578 if (kp.kp_objp)
579 pr_cont(" start %px", kp.kp_objp);
580 if (kp.kp_data_offset)
581 pr_cont(" data offset %lu", kp.kp_data_offset);
582 if (kp.kp_objp) {
583 ptroffset = ((char *)object - (char *)kp.kp_objp) - kp.kp_data_offset;
584 pr_cont(" pointer offset %lu", ptroffset);
585 }
586 if (kp.kp_slab_cache && kp.kp_slab_cache->usersize)
587 pr_cont(" size %u", kp.kp_slab_cache->usersize);
588 if (kp.kp_ret)
589 pr_cont(" allocated at %pS\n", kp.kp_ret);
590 else
591 pr_cont("\n");
592 for (i = 0; i < ARRAY_SIZE(kp.kp_stack); i++) {
593 if (!kp.kp_stack[i])
594 break;
595 pr_info(" %pS\n", kp.kp_stack[i]);
596 }
e548eaa1
MS
597
598 if (kp.kp_free_stack[0])
599 pr_cont(" Free path:\n");
600
601 for (i = 0; i < ARRAY_SIZE(kp.kp_free_stack); i++) {
602 if (!kp.kp_free_stack[i])
603 break;
604 pr_info(" %pS\n", kp.kp_free_stack[i]);
605 }
606
8e7f37f2 607}
0d3dd2c8 608EXPORT_SYMBOL_GPL(kmem_dump_obj);
5bb1bb35 609#endif
8e7f37f2 610
45530c44
CL
611#ifndef CONFIG_SLOB
612/* Create a cache during boot when no slab services are available yet */
361d575e
AD
613void __init create_boot_cache(struct kmem_cache *s, const char *name,
614 unsigned int size, slab_flags_t flags,
615 unsigned int useroffset, unsigned int usersize)
45530c44
CL
616{
617 int err;
59bb4798 618 unsigned int align = ARCH_KMALLOC_MINALIGN;
45530c44
CL
619
620 s->name = name;
621 s->size = s->object_size = size;
59bb4798
VB
622
623 /*
624 * For power of two sizes, guarantee natural alignment for kmalloc
625 * caches, regardless of SL*B debugging options.
626 */
627 if (is_power_of_2(size))
628 align = max(align, size);
629 s->align = calculate_alignment(flags, align, size);
630
8eb8284b
DW
631 s->useroffset = useroffset;
632 s->usersize = usersize;
f7ce3190 633
45530c44
CL
634 err = __kmem_cache_create(s, flags);
635
636 if (err)
361d575e 637 panic("Creation of kmalloc slab %s size=%u failed. Reason %d\n",
45530c44
CL
638 name, size, err);
639
640 s->refcount = -1; /* Exempt from merging for now */
641}
642
55de8b9c
AD
643struct kmem_cache *__init create_kmalloc_cache(const char *name,
644 unsigned int size, slab_flags_t flags,
645 unsigned int useroffset, unsigned int usersize)
45530c44
CL
646{
647 struct kmem_cache *s = kmem_cache_zalloc(kmem_cache, GFP_NOWAIT);
648
649 if (!s)
650 panic("Out of memory when creating slab %s\n", name);
651
6c0c21ad 652 create_boot_cache(s, name, size, flags, useroffset, usersize);
92850134 653 kasan_cache_create_kmalloc(s);
45530c44
CL
654 list_add(&s->list, &slab_caches);
655 s->refcount = 1;
656 return s;
657}
658
cc252eae 659struct kmem_cache *
a07057dc
AB
660kmalloc_caches[NR_KMALLOC_TYPES][KMALLOC_SHIFT_HIGH + 1] __ro_after_init =
661{ /* initialization for https://bugs.llvm.org/show_bug.cgi?id=42570 */ };
9425c58e
CL
662EXPORT_SYMBOL(kmalloc_caches);
663
2c59dd65
CL
664/*
665 * Conversion table for small slabs sizes / 8 to the index in the
666 * kmalloc array. This is necessary for slabs < 192 since we have non power
667 * of two cache sizes there. The size of larger slabs can be determined using
668 * fls.
669 */
d5f86655 670static u8 size_index[24] __ro_after_init = {
2c59dd65
CL
671 3, /* 8 */
672 4, /* 16 */
673 5, /* 24 */
674 5, /* 32 */
675 6, /* 40 */
676 6, /* 48 */
677 6, /* 56 */
678 6, /* 64 */
679 1, /* 72 */
680 1, /* 80 */
681 1, /* 88 */
682 1, /* 96 */
683 7, /* 104 */
684 7, /* 112 */
685 7, /* 120 */
686 7, /* 128 */
687 2, /* 136 */
688 2, /* 144 */
689 2, /* 152 */
690 2, /* 160 */
691 2, /* 168 */
692 2, /* 176 */
693 2, /* 184 */
694 2 /* 192 */
695};
696
ac914d08 697static inline unsigned int size_index_elem(unsigned int bytes)
2c59dd65
CL
698{
699 return (bytes - 1) / 8;
700}
701
702/*
703 * Find the kmem_cache structure that serves a given size of
704 * allocation
705 */
706struct kmem_cache *kmalloc_slab(size_t size, gfp_t flags)
707{
d5f86655 708 unsigned int index;
2c59dd65
CL
709
710 if (size <= 192) {
711 if (!size)
712 return ZERO_SIZE_PTR;
713
714 index = size_index[size_index_elem(size)];
61448479 715 } else {
221d7da6 716 if (WARN_ON_ONCE(size > KMALLOC_MAX_CACHE_SIZE))
61448479 717 return NULL;
2c59dd65 718 index = fls(size - 1);
61448479 719 }
2c59dd65 720
cc252eae 721 return kmalloc_caches[kmalloc_type(flags)][index];
2c59dd65
CL
722}
723
cb5d9fb3 724#ifdef CONFIG_ZONE_DMA
494c1dfe
WL
725#define KMALLOC_DMA_NAME(sz) .name[KMALLOC_DMA] = "dma-kmalloc-" #sz,
726#else
727#define KMALLOC_DMA_NAME(sz)
728#endif
729
730#ifdef CONFIG_MEMCG_KMEM
731#define KMALLOC_CGROUP_NAME(sz) .name[KMALLOC_CGROUP] = "kmalloc-cg-" #sz,
cb5d9fb3 732#else
494c1dfe
WL
733#define KMALLOC_CGROUP_NAME(sz)
734#endif
735
cb5d9fb3
PL
736#define INIT_KMALLOC_INFO(__size, __short_size) \
737{ \
738 .name[KMALLOC_NORMAL] = "kmalloc-" #__short_size, \
739 .name[KMALLOC_RECLAIM] = "kmalloc-rcl-" #__short_size, \
494c1dfe
WL
740 KMALLOC_CGROUP_NAME(__short_size) \
741 KMALLOC_DMA_NAME(__short_size) \
cb5d9fb3
PL
742 .size = __size, \
743}
cb5d9fb3 744
4066c33d
GG
745/*
746 * kmalloc_info[] is to make slub_debug=,kmalloc-xx option work at boot time.
588c7fa0
HY
747 * kmalloc_index() supports up to 2^25=32MB, so the final entry of the table is
748 * kmalloc-32M.
4066c33d 749 */
af3b5f87 750const struct kmalloc_info_struct kmalloc_info[] __initconst = {
cb5d9fb3
PL
751 INIT_KMALLOC_INFO(0, 0),
752 INIT_KMALLOC_INFO(96, 96),
753 INIT_KMALLOC_INFO(192, 192),
754 INIT_KMALLOC_INFO(8, 8),
755 INIT_KMALLOC_INFO(16, 16),
756 INIT_KMALLOC_INFO(32, 32),
757 INIT_KMALLOC_INFO(64, 64),
758 INIT_KMALLOC_INFO(128, 128),
759 INIT_KMALLOC_INFO(256, 256),
760 INIT_KMALLOC_INFO(512, 512),
761 INIT_KMALLOC_INFO(1024, 1k),
762 INIT_KMALLOC_INFO(2048, 2k),
763 INIT_KMALLOC_INFO(4096, 4k),
764 INIT_KMALLOC_INFO(8192, 8k),
765 INIT_KMALLOC_INFO(16384, 16k),
766 INIT_KMALLOC_INFO(32768, 32k),
767 INIT_KMALLOC_INFO(65536, 64k),
768 INIT_KMALLOC_INFO(131072, 128k),
769 INIT_KMALLOC_INFO(262144, 256k),
770 INIT_KMALLOC_INFO(524288, 512k),
771 INIT_KMALLOC_INFO(1048576, 1M),
772 INIT_KMALLOC_INFO(2097152, 2M),
773 INIT_KMALLOC_INFO(4194304, 4M),
774 INIT_KMALLOC_INFO(8388608, 8M),
775 INIT_KMALLOC_INFO(16777216, 16M),
588c7fa0 776 INIT_KMALLOC_INFO(33554432, 32M)
4066c33d
GG
777};
778
f97d5f63 779/*
34cc6990
DS
780 * Patch up the size_index table if we have strange large alignment
781 * requirements for the kmalloc array. This is only the case for
782 * MIPS it seems. The standard arches will not generate any code here.
783 *
784 * Largest permitted alignment is 256 bytes due to the way we
785 * handle the index determination for the smaller caches.
786 *
787 * Make sure that nothing crazy happens if someone starts tinkering
788 * around with ARCH_KMALLOC_MINALIGN
f97d5f63 789 */
34cc6990 790void __init setup_kmalloc_cache_index_table(void)
f97d5f63 791{
ac914d08 792 unsigned int i;
f97d5f63 793
2c59dd65 794 BUILD_BUG_ON(KMALLOC_MIN_SIZE > 256 ||
7d6b6cc3 795 !is_power_of_2(KMALLOC_MIN_SIZE));
2c59dd65
CL
796
797 for (i = 8; i < KMALLOC_MIN_SIZE; i += 8) {
ac914d08 798 unsigned int elem = size_index_elem(i);
2c59dd65
CL
799
800 if (elem >= ARRAY_SIZE(size_index))
801 break;
802 size_index[elem] = KMALLOC_SHIFT_LOW;
803 }
804
805 if (KMALLOC_MIN_SIZE >= 64) {
806 /*
0b8f0d87 807 * The 96 byte sized cache is not used if the alignment
2c59dd65
CL
808 * is 64 byte.
809 */
810 for (i = 64 + 8; i <= 96; i += 8)
811 size_index[size_index_elem(i)] = 7;
812
813 }
814
815 if (KMALLOC_MIN_SIZE >= 128) {
816 /*
817 * The 192 byte sized cache is not used if the alignment
818 * is 128 byte. Redirect kmalloc to use the 256 byte cache
819 * instead.
820 */
821 for (i = 128 + 8; i <= 192; i += 8)
822 size_index[size_index_elem(i)] = 8;
823 }
34cc6990
DS
824}
825
1291523f 826static void __init
13657d0a 827new_kmalloc_cache(int idx, enum kmalloc_cache_type type, slab_flags_t flags)
a9730fca 828{
494c1dfe 829 if (type == KMALLOC_RECLAIM) {
1291523f 830 flags |= SLAB_RECLAIM_ACCOUNT;
494c1dfe 831 } else if (IS_ENABLED(CONFIG_MEMCG_KMEM) && (type == KMALLOC_CGROUP)) {
17c17367 832 if (mem_cgroup_kmem_disabled()) {
494c1dfe
WL
833 kmalloc_caches[type][idx] = kmalloc_caches[KMALLOC_NORMAL][idx];
834 return;
835 }
836 flags |= SLAB_ACCOUNT;
33647783
OK
837 } else if (IS_ENABLED(CONFIG_ZONE_DMA) && (type == KMALLOC_DMA)) {
838 flags |= SLAB_CACHE_DMA;
494c1dfe 839 }
1291523f 840
cb5d9fb3
PL
841 kmalloc_caches[type][idx] = create_kmalloc_cache(
842 kmalloc_info[idx].name[type],
6c0c21ad
DW
843 kmalloc_info[idx].size, flags, 0,
844 kmalloc_info[idx].size);
13e680fb
WL
845
846 /*
847 * If CONFIG_MEMCG_KMEM is enabled, disable cache merging for
848 * KMALLOC_NORMAL caches.
849 */
850 if (IS_ENABLED(CONFIG_MEMCG_KMEM) && (type == KMALLOC_NORMAL))
851 kmalloc_caches[type][idx]->refcount = -1;
a9730fca
CL
852}
853
34cc6990
DS
854/*
855 * Create the kmalloc array. Some of the regular kmalloc arrays
856 * may already have been created because they were needed to
857 * enable allocations for slab creation.
858 */
d50112ed 859void __init create_kmalloc_caches(slab_flags_t flags)
34cc6990 860{
13657d0a
PL
861 int i;
862 enum kmalloc_cache_type type;
34cc6990 863
494c1dfe
WL
864 /*
865 * Including KMALLOC_CGROUP if CONFIG_MEMCG_KMEM defined
866 */
33647783 867 for (type = KMALLOC_NORMAL; type < NR_KMALLOC_TYPES; type++) {
1291523f
VB
868 for (i = KMALLOC_SHIFT_LOW; i <= KMALLOC_SHIFT_HIGH; i++) {
869 if (!kmalloc_caches[type][i])
870 new_kmalloc_cache(i, type, flags);
f97d5f63 871
1291523f
VB
872 /*
873 * Caches that are not of the two-to-the-power-of size.
874 * These have to be created immediately after the
875 * earlier power of two caches
876 */
877 if (KMALLOC_MIN_SIZE <= 32 && i == 6 &&
878 !kmalloc_caches[type][1])
879 new_kmalloc_cache(1, type, flags);
880 if (KMALLOC_MIN_SIZE <= 64 && i == 7 &&
881 !kmalloc_caches[type][2])
882 new_kmalloc_cache(2, type, flags);
883 }
8a965b3b
CL
884 }
885
f97d5f63
CL
886 /* Kmalloc array is now usable */
887 slab_state = UP;
f97d5f63 888}
45530c44
CL
889#endif /* !CONFIG_SLOB */
890
44405099
LL
891gfp_t kmalloc_fix_flags(gfp_t flags)
892{
893 gfp_t invalid_mask = flags & GFP_SLAB_BUG_MASK;
894
895 flags &= ~GFP_SLAB_BUG_MASK;
896 pr_warn("Unexpected gfp: %#x (%pGg). Fixing up to gfp: %#x (%pGg). Fix your code!\n",
897 invalid_mask, &invalid_mask, flags, &flags);
898 dump_stack();
899
900 return flags;
901}
902
cea371f4
VD
903/*
904 * To avoid unnecessary overhead, we pass through large allocation requests
905 * directly to the page allocator. We use __GFP_COMP, because we will need to
906 * know the allocation order to free the pages properly in kfree.
907 */
45530c44 908
bf37d791 909void *kmalloc_large_node_notrace(size_t size, gfp_t flags, int node)
a0c3b940
HY
910{
911 struct page *page;
912 void *ptr = NULL;
913 unsigned int order = get_order(size);
914
c4cab557
HY
915 if (unlikely(flags & GFP_SLAB_BUG_MASK))
916 flags = kmalloc_fix_flags(flags);
917
a0c3b940
HY
918 flags |= __GFP_COMP;
919 page = alloc_pages_node(node, flags, order);
920 if (page) {
921 ptr = page_address(page);
922 mod_lruvec_page_state(page, NR_SLAB_UNRECLAIMABLE_B,
923 PAGE_SIZE << order);
924 }
925
926 ptr = kasan_kmalloc_large(ptr, size, flags);
927 /* As ptr might get tagged, call kmemleak hook after KASAN. */
928 kmemleak_alloc(ptr, size, 1, flags);
929
930 return ptr;
931}
bf37d791 932
c4cab557
HY
933void *kmalloc_large(size_t size, gfp_t flags)
934{
935 void *ret = kmalloc_large_node_notrace(size, flags, NUMA_NO_NODE);
936
937 trace_kmalloc(_RET_IP_, ret, NULL, size,
938 PAGE_SIZE << get_order(size), flags);
939 return ret;
940}
941EXPORT_SYMBOL(kmalloc_large);
942
bf37d791
HY
943void *kmalloc_large_node(size_t size, gfp_t flags, int node)
944{
945 void *ret = kmalloc_large_node_notrace(size, flags, node);
946
947 trace_kmalloc_node(_RET_IP_, ret, NULL, size,
948 PAGE_SIZE << get_order(size), flags, node);
949 return ret;
950}
a0c3b940
HY
951EXPORT_SYMBOL(kmalloc_large_node);
952
7c00fce9
TG
953#ifdef CONFIG_SLAB_FREELIST_RANDOM
954/* Randomize a generic freelist */
955static void freelist_randomize(struct rnd_state *state, unsigned int *list,
302d55d5 956 unsigned int count)
7c00fce9 957{
7c00fce9 958 unsigned int rand;
302d55d5 959 unsigned int i;
7c00fce9
TG
960
961 for (i = 0; i < count; i++)
962 list[i] = i;
963
964 /* Fisher-Yates shuffle */
965 for (i = count - 1; i > 0; i--) {
966 rand = prandom_u32_state(state);
967 rand %= (i + 1);
968 swap(list[i], list[rand]);
969 }
970}
971
972/* Create a random sequence per cache */
973int cache_random_seq_create(struct kmem_cache *cachep, unsigned int count,
974 gfp_t gfp)
975{
976 struct rnd_state state;
977
978 if (count < 2 || cachep->random_seq)
979 return 0;
980
981 cachep->random_seq = kcalloc(count, sizeof(unsigned int), gfp);
982 if (!cachep->random_seq)
983 return -ENOMEM;
984
985 /* Get best entropy at this stage of boot */
986 prandom_seed_state(&state, get_random_long());
987
988 freelist_randomize(&state, cachep->random_seq, count);
989 return 0;
990}
991
992/* Destroy the per-cache random freelist sequence */
993void cache_random_seq_destroy(struct kmem_cache *cachep)
994{
995 kfree(cachep->random_seq);
996 cachep->random_seq = NULL;
997}
998#endif /* CONFIG_SLAB_FREELIST_RANDOM */
999
5b365771 1000#if defined(CONFIG_SLAB) || defined(CONFIG_SLUB_DEBUG)
e9b4db2b 1001#ifdef CONFIG_SLAB
0825a6f9 1002#define SLABINFO_RIGHTS (0600)
e9b4db2b 1003#else
0825a6f9 1004#define SLABINFO_RIGHTS (0400)
e9b4db2b
WL
1005#endif
1006
b047501c 1007static void print_slabinfo_header(struct seq_file *m)
bcee6e2a
GC
1008{
1009 /*
1010 * Output format version, so at least we can change it
1011 * without _too_ many complaints.
1012 */
1013#ifdef CONFIG_DEBUG_SLAB
1014 seq_puts(m, "slabinfo - version: 2.1 (statistics)\n");
1015#else
1016 seq_puts(m, "slabinfo - version: 2.1\n");
1017#endif
756a025f 1018 seq_puts(m, "# name <active_objs> <num_objs> <objsize> <objperslab> <pagesperslab>");
bcee6e2a
GC
1019 seq_puts(m, " : tunables <limit> <batchcount> <sharedfactor>");
1020 seq_puts(m, " : slabdata <active_slabs> <num_slabs> <sharedavail>");
1021#ifdef CONFIG_DEBUG_SLAB
756a025f 1022 seq_puts(m, " : globalstat <listallocs> <maxobjs> <grown> <reaped> <error> <maxfreeable> <nodeallocs> <remotefrees> <alienoverflow>");
bcee6e2a
GC
1023 seq_puts(m, " : cpustat <allochit> <allocmiss> <freehit> <freemiss>");
1024#endif
1025 seq_putc(m, '\n');
1026}
1027
c29b5b3d 1028static void *slab_start(struct seq_file *m, loff_t *pos)
b7454ad3 1029{
b7454ad3 1030 mutex_lock(&slab_mutex);
c7094406 1031 return seq_list_start(&slab_caches, *pos);
b7454ad3
GC
1032}
1033
c29b5b3d 1034static void *slab_next(struct seq_file *m, void *p, loff_t *pos)
b7454ad3 1035{
c7094406 1036 return seq_list_next(p, &slab_caches, pos);
b7454ad3
GC
1037}
1038
c29b5b3d 1039static void slab_stop(struct seq_file *m, void *p)
b7454ad3
GC
1040{
1041 mutex_unlock(&slab_mutex);
1042}
1043
b047501c 1044static void cache_show(struct kmem_cache *s, struct seq_file *m)
b7454ad3 1045{
0d7561c6
GC
1046 struct slabinfo sinfo;
1047
1048 memset(&sinfo, 0, sizeof(sinfo));
1049 get_slabinfo(s, &sinfo);
1050
1051 seq_printf(m, "%-17s %6lu %6lu %6u %4u %4d",
10befea9 1052 s->name, sinfo.active_objs, sinfo.num_objs, s->size,
0d7561c6
GC
1053 sinfo.objects_per_slab, (1 << sinfo.cache_order));
1054
1055 seq_printf(m, " : tunables %4u %4u %4u",
1056 sinfo.limit, sinfo.batchcount, sinfo.shared);
1057 seq_printf(m, " : slabdata %6lu %6lu %6lu",
1058 sinfo.active_slabs, sinfo.num_slabs, sinfo.shared_avail);
1059 slabinfo_show_stats(m, s);
1060 seq_putc(m, '\n');
b7454ad3
GC
1061}
1062
1df3b26f 1063static int slab_show(struct seq_file *m, void *p)
749c5415 1064{
c7094406 1065 struct kmem_cache *s = list_entry(p, struct kmem_cache, list);
749c5415 1066
c7094406 1067 if (p == slab_caches.next)
1df3b26f 1068 print_slabinfo_header(m);
10befea9 1069 cache_show(s, m);
b047501c
VD
1070 return 0;
1071}
1072
852d8be0
YS
1073void dump_unreclaimable_slab(void)
1074{
7714304f 1075 struct kmem_cache *s;
852d8be0
YS
1076 struct slabinfo sinfo;
1077
1078 /*
1079 * Here acquiring slab_mutex is risky since we don't prefer to get
1080 * sleep in oom path. But, without mutex hold, it may introduce a
1081 * risk of crash.
1082 * Use mutex_trylock to protect the list traverse, dump nothing
1083 * without acquiring the mutex.
1084 */
1085 if (!mutex_trylock(&slab_mutex)) {
1086 pr_warn("excessive unreclaimable slab but cannot dump stats\n");
1087 return;
1088 }
1089
1090 pr_info("Unreclaimable slab info:\n");
1091 pr_info("Name Used Total\n");
1092
7714304f 1093 list_for_each_entry(s, &slab_caches, list) {
10befea9 1094 if (s->flags & SLAB_RECLAIM_ACCOUNT)
852d8be0
YS
1095 continue;
1096
1097 get_slabinfo(s, &sinfo);
1098
1099 if (sinfo.num_objs > 0)
10befea9 1100 pr_info("%-17s %10luKB %10luKB\n", s->name,
852d8be0
YS
1101 (sinfo.active_objs * s->size) / 1024,
1102 (sinfo.num_objs * s->size) / 1024);
1103 }
1104 mutex_unlock(&slab_mutex);
1105}
1106
b7454ad3
GC
1107/*
1108 * slabinfo_op - iterator that generates /proc/slabinfo
1109 *
1110 * Output layout:
1111 * cache-name
1112 * num-active-objs
1113 * total-objs
1114 * object size
1115 * num-active-slabs
1116 * total-slabs
1117 * num-pages-per-slab
1118 * + further values on SMP and with statistics enabled
1119 */
1120static const struct seq_operations slabinfo_op = {
1df3b26f 1121 .start = slab_start,
276a2439
WL
1122 .next = slab_next,
1123 .stop = slab_stop,
1df3b26f 1124 .show = slab_show,
b7454ad3
GC
1125};
1126
1127static int slabinfo_open(struct inode *inode, struct file *file)
1128{
1129 return seq_open(file, &slabinfo_op);
1130}
1131
97a32539 1132static const struct proc_ops slabinfo_proc_ops = {
d919b33d 1133 .proc_flags = PROC_ENTRY_PERMANENT,
97a32539
AD
1134 .proc_open = slabinfo_open,
1135 .proc_read = seq_read,
1136 .proc_write = slabinfo_write,
1137 .proc_lseek = seq_lseek,
1138 .proc_release = seq_release,
b7454ad3
GC
1139};
1140
1141static int __init slab_proc_init(void)
1142{
97a32539 1143 proc_create("slabinfo", SLABINFO_RIGHTS, NULL, &slabinfo_proc_ops);
b7454ad3
GC
1144 return 0;
1145}
1146module_init(slab_proc_init);
fcf8a1e4 1147
5b365771 1148#endif /* CONFIG_SLAB || CONFIG_SLUB_DEBUG */
928cec9c
AR
1149
1150static __always_inline void *__do_krealloc(const void *p, size_t new_size,
1151 gfp_t flags)
1152{
1153 void *ret;
fa9ba3aa 1154 size_t ks;
928cec9c 1155
d12d9ad8
AK
1156 /* Don't use instrumented ksize to allow precise KASAN poisoning. */
1157 if (likely(!ZERO_OR_NULL_PTR(p))) {
1158 if (!kasan_check_byte(p))
1159 return NULL;
1160 ks = kfence_ksize(p) ?: __ksize(p);
1161 } else
1162 ks = 0;
928cec9c 1163
d12d9ad8 1164 /* If the object still fits, repoison it precisely. */
0316bec2 1165 if (ks >= new_size) {
0116523c 1166 p = kasan_krealloc((void *)p, new_size, flags);
928cec9c 1167 return (void *)p;
0316bec2 1168 }
928cec9c
AR
1169
1170 ret = kmalloc_track_caller(new_size, flags);
d12d9ad8
AK
1171 if (ret && p) {
1172 /* Disable KASAN checks as the object's redzone is accessed. */
1173 kasan_disable_current();
1174 memcpy(ret, kasan_reset_tag(p), ks);
1175 kasan_enable_current();
1176 }
928cec9c
AR
1177
1178 return ret;
1179}
1180
928cec9c
AR
1181/**
1182 * krealloc - reallocate memory. The contents will remain unchanged.
1183 * @p: object to reallocate memory for.
1184 * @new_size: how many bytes of memory are required.
1185 * @flags: the type of memory to allocate.
1186 *
1187 * The contents of the object pointed to are preserved up to the
15d5de49
BG
1188 * lesser of the new and old sizes (__GFP_ZERO flag is effectively ignored).
1189 * If @p is %NULL, krealloc() behaves exactly like kmalloc(). If @new_size
1190 * is 0 and @p is not a %NULL pointer, the object pointed to is freed.
a862f68a
MR
1191 *
1192 * Return: pointer to the allocated memory or %NULL in case of error
928cec9c
AR
1193 */
1194void *krealloc(const void *p, size_t new_size, gfp_t flags)
1195{
1196 void *ret;
1197
1198 if (unlikely(!new_size)) {
1199 kfree(p);
1200 return ZERO_SIZE_PTR;
1201 }
1202
1203 ret = __do_krealloc(p, new_size, flags);
772a2fa5 1204 if (ret && kasan_reset_tag(p) != kasan_reset_tag(ret))
928cec9c
AR
1205 kfree(p);
1206
1207 return ret;
1208}
1209EXPORT_SYMBOL(krealloc);
1210
1211/**
453431a5 1212 * kfree_sensitive - Clear sensitive information in memory before freeing
928cec9c
AR
1213 * @p: object to free memory of
1214 *
1215 * The memory of the object @p points to is zeroed before freed.
453431a5 1216 * If @p is %NULL, kfree_sensitive() does nothing.
928cec9c
AR
1217 *
1218 * Note: this function zeroes the whole allocated buffer which can be a good
1219 * deal bigger than the requested buffer size passed to kmalloc(). So be
1220 * careful when using this function in performance sensitive code.
1221 */
453431a5 1222void kfree_sensitive(const void *p)
928cec9c
AR
1223{
1224 size_t ks;
1225 void *mem = (void *)p;
1226
928cec9c 1227 ks = ksize(mem);
fa9ba3aa
WK
1228 if (ks)
1229 memzero_explicit(mem, ks);
928cec9c
AR
1230 kfree(mem);
1231}
453431a5 1232EXPORT_SYMBOL(kfree_sensitive);
928cec9c 1233
10d1f8cb
ME
1234/**
1235 * ksize - get the actual amount of memory allocated for a given object
1236 * @objp: Pointer to the object
1237 *
1238 * kmalloc may internally round up allocations and return more memory
1239 * than requested. ksize() can be used to determine the actual amount of
1240 * memory allocated. The caller may use this additional memory, even though
1241 * a smaller amount of memory was initially specified with the kmalloc call.
1242 * The caller must guarantee that objp points to a valid object previously
1243 * allocated with either kmalloc() or kmem_cache_alloc(). The object
1244 * must not be freed during the duration of the call.
1245 *
1246 * Return: size of the actual memory used by @objp in bytes
1247 */
1248size_t ksize(const void *objp)
1249{
0d4ca4c9
ME
1250 size_t size;
1251
0d4ca4c9 1252 /*
611806b4
AK
1253 * We need to first check that the pointer to the object is valid, and
1254 * only then unpoison the memory. The report printed from ksize() is
1255 * more useful, then when it's printed later when the behaviour could
1256 * be undefined due to a potential use-after-free or double-free.
0d4ca4c9 1257 *
611806b4
AK
1258 * We use kasan_check_byte(), which is supported for the hardware
1259 * tag-based KASAN mode, unlike kasan_check_read/write().
1260 *
1261 * If the pointed to memory is invalid, we return 0 to avoid users of
0d4ca4c9
ME
1262 * ksize() writing to and potentially corrupting the memory region.
1263 *
1264 * We want to perform the check before __ksize(), to avoid potentially
1265 * crashing in __ksize() due to accessing invalid metadata.
1266 */
611806b4 1267 if (unlikely(ZERO_OR_NULL_PTR(objp)) || !kasan_check_byte(objp))
0d4ca4c9
ME
1268 return 0;
1269
d3fb45f3 1270 size = kfence_ksize(objp) ?: __ksize(objp);
10d1f8cb
ME
1271 /*
1272 * We assume that ksize callers could use whole allocated area,
1273 * so we need to unpoison this area.
1274 */
cebd0eb2 1275 kasan_unpoison_range(objp, size);
10d1f8cb
ME
1276 return size;
1277}
1278EXPORT_SYMBOL(ksize);
1279
928cec9c
AR
1280/* Tracepoints definitions. */
1281EXPORT_TRACEPOINT_SYMBOL(kmalloc);
1282EXPORT_TRACEPOINT_SYMBOL(kmem_cache_alloc);
1283EXPORT_TRACEPOINT_SYMBOL(kmalloc_node);
1284EXPORT_TRACEPOINT_SYMBOL(kmem_cache_alloc_node);
1285EXPORT_TRACEPOINT_SYMBOL(kfree);
1286EXPORT_TRACEPOINT_SYMBOL(kmem_cache_free);
4f6923fb
HM
1287
1288int should_failslab(struct kmem_cache *s, gfp_t gfpflags)
1289{
1290 if (__should_failslab(s, gfpflags))
1291 return -ENOMEM;
1292 return 0;
1293}
1294ALLOW_ERROR_INJECTION(should_failslab, ERRNO);
This page took 0.89737 seconds and 4 git commands to generate.