2 * SLUB: A slab allocator that limits cache line use instead of queuing
3 * objects in per cpu and per node lists.
5 * The allocator synchronizes using per slab locks or atomic operatios
6 * and only uses a centralized lock to manage a pool of partial slabs.
8 * (C) 2007 SGI, Christoph Lameter
9 * (C) 2011 Linux Foundation, Christoph Lameter
13 #include <linux/swap.h> /* struct reclaim_state */
14 #include <linux/module.h>
15 #include <linux/bit_spinlock.h>
16 #include <linux/interrupt.h>
17 #include <linux/bitops.h>
18 #include <linux/slab.h>
19 #include <linux/proc_fs.h>
20 #include <linux/seq_file.h>
21 #include <linux/kmemcheck.h>
22 #include <linux/cpu.h>
23 #include <linux/cpuset.h>
24 #include <linux/mempolicy.h>
25 #include <linux/ctype.h>
26 #include <linux/debugobjects.h>
27 #include <linux/kallsyms.h>
28 #include <linux/memory.h>
29 #include <linux/math64.h>
30 #include <linux/fault-inject.h>
31 #include <linux/stacktrace.h>
33 #include <trace/events/kmem.h>
37 * 1. slub_lock (Global Semaphore)
39 * 3. slab_lock(page) (Only on some arches and for debugging)
43 * The role of the slub_lock is to protect the list of all the slabs
44 * and to synchronize major metadata changes to slab cache structures.
46 * The slab_lock is only used for debugging and on arches that do not
47 * have the ability to do a cmpxchg_double. It only protects the second
48 * double word in the page struct. Meaning
49 * A. page->freelist -> List of object free in a page
50 * B. page->counters -> Counters of objects
51 * C. page->frozen -> frozen state
53 * If a slab is frozen then it is exempt from list management. It is not
54 * on any list. The processor that froze the slab is the one who can
55 * perform list operations on the page. Other processors may put objects
56 * onto the freelist but the processor that froze the slab is the only
57 * one that can retrieve the objects from the page's freelist.
59 * The list_lock protects the partial and full list on each node and
60 * the partial slab counter. If taken then no new slabs may be added or
61 * removed from the lists nor make the number of partial slabs be modified.
62 * (Note that the total number of slabs is an atomic value that may be
63 * modified without taking the list lock).
65 * The list_lock is a centralized lock and thus we avoid taking it as
66 * much as possible. As long as SLUB does not have to handle partial
67 * slabs, operations can continue without any centralized lock. F.e.
68 * allocating a long series of objects that fill up slabs does not require
70 * Interrupts are disabled during allocation and deallocation in order to
71 * make the slab allocator safe to use in the context of an irq. In addition
72 * interrupts are disabled to ensure that the processor does not change
73 * while handling per_cpu slabs, due to kernel preemption.
75 * SLUB assigns one slab for allocation to each processor.
76 * Allocations only occur from these slabs called cpu slabs.
78 * Slabs with free elements are kept on a partial list and during regular
79 * operations no list for full slabs is used. If an object in a full slab is
80 * freed then the slab will show up again on the partial lists.
81 * We track full slabs for debugging purposes though because otherwise we
82 * cannot scan all objects.
84 * Slabs are freed when they become empty. Teardown and setup is
85 * minimal so we rely on the page allocators per cpu caches for
86 * fast frees and allocs.
88 * Overloading of page flags that are otherwise used for LRU management.
90 * PageActive The slab is frozen and exempt from list processing.
91 * This means that the slab is dedicated to a purpose
92 * such as satisfying allocations for a specific
93 * processor. Objects may be freed in the slab while
94 * it is frozen but slab_free will then skip the usual
95 * list operations. It is up to the processor holding
96 * the slab to integrate the slab into the slab lists
97 * when the slab is no longer needed.
99 * One use of this flag is to mark slabs that are
100 * used for allocations. Then such a slab becomes a cpu
101 * slab. The cpu slab may be equipped with an additional
102 * freelist that allows lockless access to
103 * free objects in addition to the regular freelist
104 * that requires the slab lock.
106 * PageError Slab requires special handling due to debug
107 * options set. This moves slab handling out of
108 * the fast path and disables lockless freelists.
111 #define SLAB_DEBUG_FLAGS (SLAB_RED_ZONE | SLAB_POISON | SLAB_STORE_USER | \
112 SLAB_TRACE | SLAB_DEBUG_FREE)
114 static inline int kmem_cache_debug(struct kmem_cache
*s
)
116 #ifdef CONFIG_SLUB_DEBUG
117 return unlikely(s
->flags
& SLAB_DEBUG_FLAGS
);
124 * Issues still to be resolved:
126 * - Support PAGE_ALLOC_DEBUG. Should be easy to do.
128 * - Variable sizing of the per node arrays
131 /* Enable to test recovery from slab corruption on boot */
132 #undef SLUB_RESILIENCY_TEST
134 /* Enable to log cmpxchg failures */
135 #undef SLUB_DEBUG_CMPXCHG
138 * Mininum number of partial slabs. These will be left on the partial
139 * lists even if they are empty. kmem_cache_shrink may reclaim them.
141 #define MIN_PARTIAL 5
144 * Maximum number of desirable partial slabs.
145 * The existence of more partial slabs makes kmem_cache_shrink
146 * sort the partial list by the number of objects in the.
148 #define MAX_PARTIAL 10
150 #define DEBUG_DEFAULT_FLAGS (SLAB_DEBUG_FREE | SLAB_RED_ZONE | \
151 SLAB_POISON | SLAB_STORE_USER)
154 * Debugging flags that require metadata to be stored in the slab. These get
155 * disabled when slub_debug=O is used and a cache's min order increases with
158 #define DEBUG_METADATA_FLAGS (SLAB_RED_ZONE | SLAB_POISON | SLAB_STORE_USER)
161 * Set of flags that will prevent slab merging
163 #define SLUB_NEVER_MERGE (SLAB_RED_ZONE | SLAB_POISON | SLAB_STORE_USER | \
164 SLAB_TRACE | SLAB_DESTROY_BY_RCU | SLAB_NOLEAKTRACE | \
167 #define SLUB_MERGE_SAME (SLAB_DEBUG_FREE | SLAB_RECLAIM_ACCOUNT | \
168 SLAB_CACHE_DMA | SLAB_NOTRACK)
171 #define OO_MASK ((1 << OO_SHIFT) - 1)
172 #define MAX_OBJS_PER_PAGE 32767 /* since page.objects is u15 */
174 /* Internal SLUB flags */
175 #define __OBJECT_POISON 0x80000000UL /* Poison object */
176 #define __CMPXCHG_DOUBLE 0x40000000UL /* Use cmpxchg_double */
178 static int kmem_size
= sizeof(struct kmem_cache
);
181 static struct notifier_block slab_notifier
;
185 DOWN
, /* No slab functionality available */
186 PARTIAL
, /* Kmem_cache_node works */
187 UP
, /* Everything works but does not show up in sysfs */
191 /* A list of all slab caches on the system */
192 static DECLARE_RWSEM(slub_lock
);
193 static LIST_HEAD(slab_caches
);
196 * Tracking user of a slab.
198 #define TRACK_ADDRS_COUNT 16
200 unsigned long addr
; /* Called from address */
201 #ifdef CONFIG_STACKTRACE
202 unsigned long addrs
[TRACK_ADDRS_COUNT
]; /* Called from address */
204 int cpu
; /* Was running on cpu */
205 int pid
; /* Pid context */
206 unsigned long when
; /* When did the operation occur */
209 enum track_item
{ TRACK_ALLOC
, TRACK_FREE
};
212 static int sysfs_slab_add(struct kmem_cache
*);
213 static int sysfs_slab_alias(struct kmem_cache
*, const char *);
214 static void sysfs_slab_remove(struct kmem_cache
*);
217 static inline int sysfs_slab_add(struct kmem_cache
*s
) { return 0; }
218 static inline int sysfs_slab_alias(struct kmem_cache
*s
, const char *p
)
220 static inline void sysfs_slab_remove(struct kmem_cache
*s
)
228 static inline void stat(const struct kmem_cache
*s
, enum stat_item si
)
230 #ifdef CONFIG_SLUB_STATS
231 __this_cpu_inc(s
->cpu_slab
->stat
[si
]);
235 /********************************************************************
236 * Core slab cache functions
237 *******************************************************************/
239 int slab_is_available(void)
241 return slab_state
>= UP
;
244 static inline struct kmem_cache_node
*get_node(struct kmem_cache
*s
, int node
)
246 return s
->node
[node
];
249 /* Verify that a pointer has an address that is valid within a slab page */
250 static inline int check_valid_pointer(struct kmem_cache
*s
,
251 struct page
*page
, const void *object
)
258 base
= page_address(page
);
259 if (object
< base
|| object
>= base
+ page
->objects
* s
->size
||
260 (object
- base
) % s
->size
) {
267 static inline void *get_freepointer(struct kmem_cache
*s
, void *object
)
269 return *(void **)(object
+ s
->offset
);
272 static inline void *get_freepointer_safe(struct kmem_cache
*s
, void *object
)
276 #ifdef CONFIG_DEBUG_PAGEALLOC
277 probe_kernel_read(&p
, (void **)(object
+ s
->offset
), sizeof(p
));
279 p
= get_freepointer(s
, object
);
284 static inline void set_freepointer(struct kmem_cache
*s
, void *object
, void *fp
)
286 *(void **)(object
+ s
->offset
) = fp
;
289 /* Loop over all objects in a slab */
290 #define for_each_object(__p, __s, __addr, __objects) \
291 for (__p = (__addr); __p < (__addr) + (__objects) * (__s)->size;\
294 /* Determine object index from a given position */
295 static inline int slab_index(void *p
, struct kmem_cache
*s
, void *addr
)
297 return (p
- addr
) / s
->size
;
300 static inline size_t slab_ksize(const struct kmem_cache
*s
)
302 #ifdef CONFIG_SLUB_DEBUG
304 * Debugging requires use of the padding between object
305 * and whatever may come after it.
307 if (s
->flags
& (SLAB_RED_ZONE
| SLAB_POISON
))
312 * If we have the need to store the freelist pointer
313 * back there or track user information then we can
314 * only use the space before that information.
316 if (s
->flags
& (SLAB_DESTROY_BY_RCU
| SLAB_STORE_USER
))
319 * Else we can use all the padding etc for the allocation
324 static inline int order_objects(int order
, unsigned long size
, int reserved
)
326 return ((PAGE_SIZE
<< order
) - reserved
) / size
;
329 static inline struct kmem_cache_order_objects
oo_make(int order
,
330 unsigned long size
, int reserved
)
332 struct kmem_cache_order_objects x
= {
333 (order
<< OO_SHIFT
) + order_objects(order
, size
, reserved
)
339 static inline int oo_order(struct kmem_cache_order_objects x
)
341 return x
.x
>> OO_SHIFT
;
344 static inline int oo_objects(struct kmem_cache_order_objects x
)
346 return x
.x
& OO_MASK
;
350 * Per slab locking using the pagelock
352 static __always_inline
void slab_lock(struct page
*page
)
354 bit_spin_lock(PG_locked
, &page
->flags
);
357 static __always_inline
void slab_unlock(struct page
*page
)
359 __bit_spin_unlock(PG_locked
, &page
->flags
);
362 /* Interrupts must be disabled (for the fallback code to work right) */
363 static inline bool __cmpxchg_double_slab(struct kmem_cache
*s
, struct page
*page
,
364 void *freelist_old
, unsigned long counters_old
,
365 void *freelist_new
, unsigned long counters_new
,
368 VM_BUG_ON(!irqs_disabled());
369 #ifdef CONFIG_CMPXCHG_DOUBLE
370 if (s
->flags
& __CMPXCHG_DOUBLE
) {
371 if (cmpxchg_double(&page
->freelist
,
372 freelist_old
, counters_old
,
373 freelist_new
, counters_new
))
379 if (page
->freelist
== freelist_old
&& page
->counters
== counters_old
) {
380 page
->freelist
= freelist_new
;
381 page
->counters
= counters_new
;
389 stat(s
, CMPXCHG_DOUBLE_FAIL
);
391 #ifdef SLUB_DEBUG_CMPXCHG
392 printk(KERN_INFO
"%s %s: cmpxchg double redo ", n
, s
->name
);
398 static inline bool cmpxchg_double_slab(struct kmem_cache
*s
, struct page
*page
,
399 void *freelist_old
, unsigned long counters_old
,
400 void *freelist_new
, unsigned long counters_new
,
403 #ifdef CONFIG_CMPXCHG_DOUBLE
404 if (s
->flags
& __CMPXCHG_DOUBLE
) {
405 if (cmpxchg_double(&page
->freelist
,
406 freelist_old
, counters_old
,
407 freelist_new
, counters_new
))
414 local_irq_save(flags
);
416 if (page
->freelist
== freelist_old
&& page
->counters
== counters_old
) {
417 page
->freelist
= freelist_new
;
418 page
->counters
= counters_new
;
420 local_irq_restore(flags
);
424 local_irq_restore(flags
);
428 stat(s
, CMPXCHG_DOUBLE_FAIL
);
430 #ifdef SLUB_DEBUG_CMPXCHG
431 printk(KERN_INFO
"%s %s: cmpxchg double redo ", n
, s
->name
);
437 #ifdef CONFIG_SLUB_DEBUG
439 * Determine a map of object in use on a page.
441 * Node listlock must be held to guarantee that the page does
442 * not vanish from under us.
444 static void get_map(struct kmem_cache
*s
, struct page
*page
, unsigned long *map
)
447 void *addr
= page_address(page
);
449 for (p
= page
->freelist
; p
; p
= get_freepointer(s
, p
))
450 set_bit(slab_index(p
, s
, addr
), map
);
456 #ifdef CONFIG_SLUB_DEBUG_ON
457 static int slub_debug
= DEBUG_DEFAULT_FLAGS
;
459 static int slub_debug
;
462 static char *slub_debug_slabs
;
463 static int disable_higher_order_debug
;
468 static void print_section(char *text
, u8
*addr
, unsigned int length
)
476 for (i
= 0; i
< length
; i
++) {
478 printk(KERN_ERR
"%8s 0x%p: ", text
, addr
+ i
);
481 printk(KERN_CONT
" %02x", addr
[i
]);
483 ascii
[offset
] = isgraph(addr
[i
]) ? addr
[i
] : '.';
485 printk(KERN_CONT
" %s\n", ascii
);
492 printk(KERN_CONT
" ");
496 printk(KERN_CONT
" %s\n", ascii
);
500 static struct track
*get_track(struct kmem_cache
*s
, void *object
,
501 enum track_item alloc
)
506 p
= object
+ s
->offset
+ sizeof(void *);
508 p
= object
+ s
->inuse
;
513 static void set_track(struct kmem_cache
*s
, void *object
,
514 enum track_item alloc
, unsigned long addr
)
516 struct track
*p
= get_track(s
, object
, alloc
);
519 #ifdef CONFIG_STACKTRACE
520 struct stack_trace trace
;
523 trace
.nr_entries
= 0;
524 trace
.max_entries
= TRACK_ADDRS_COUNT
;
525 trace
.entries
= p
->addrs
;
527 save_stack_trace(&trace
);
529 /* See rant in lockdep.c */
530 if (trace
.nr_entries
!= 0 &&
531 trace
.entries
[trace
.nr_entries
- 1] == ULONG_MAX
)
534 for (i
= trace
.nr_entries
; i
< TRACK_ADDRS_COUNT
; i
++)
538 p
->cpu
= smp_processor_id();
539 p
->pid
= current
->pid
;
542 memset(p
, 0, sizeof(struct track
));
545 static void init_tracking(struct kmem_cache
*s
, void *object
)
547 if (!(s
->flags
& SLAB_STORE_USER
))
550 set_track(s
, object
, TRACK_FREE
, 0UL);
551 set_track(s
, object
, TRACK_ALLOC
, 0UL);
554 static void print_track(const char *s
, struct track
*t
)
559 printk(KERN_ERR
"INFO: %s in %pS age=%lu cpu=%u pid=%d\n",
560 s
, (void *)t
->addr
, jiffies
- t
->when
, t
->cpu
, t
->pid
);
561 #ifdef CONFIG_STACKTRACE
564 for (i
= 0; i
< TRACK_ADDRS_COUNT
; i
++)
566 printk(KERN_ERR
"\t%pS\n", (void *)t
->addrs
[i
]);
573 static void print_tracking(struct kmem_cache
*s
, void *object
)
575 if (!(s
->flags
& SLAB_STORE_USER
))
578 print_track("Allocated", get_track(s
, object
, TRACK_ALLOC
));
579 print_track("Freed", get_track(s
, object
, TRACK_FREE
));
582 static void print_page_info(struct page
*page
)
584 printk(KERN_ERR
"INFO: Slab 0x%p objects=%u used=%u fp=0x%p flags=0x%04lx\n",
585 page
, page
->objects
, page
->inuse
, page
->freelist
, page
->flags
);
589 static void slab_bug(struct kmem_cache
*s
, char *fmt
, ...)
595 vsnprintf(buf
, sizeof(buf
), fmt
, args
);
597 printk(KERN_ERR
"========================================"
598 "=====================================\n");
599 printk(KERN_ERR
"BUG %s: %s\n", s
->name
, buf
);
600 printk(KERN_ERR
"----------------------------------------"
601 "-------------------------------------\n\n");
604 static void slab_fix(struct kmem_cache
*s
, char *fmt
, ...)
610 vsnprintf(buf
, sizeof(buf
), fmt
, args
);
612 printk(KERN_ERR
"FIX %s: %s\n", s
->name
, buf
);
615 static void print_trailer(struct kmem_cache
*s
, struct page
*page
, u8
*p
)
617 unsigned int off
; /* Offset of last byte */
618 u8
*addr
= page_address(page
);
620 print_tracking(s
, p
);
622 print_page_info(page
);
624 printk(KERN_ERR
"INFO: Object 0x%p @offset=%tu fp=0x%p\n\n",
625 p
, p
- addr
, get_freepointer(s
, p
));
628 print_section("Bytes b4", p
- 16, 16);
630 print_section("Object", p
, min_t(unsigned long, s
->objsize
, PAGE_SIZE
));
632 if (s
->flags
& SLAB_RED_ZONE
)
633 print_section("Redzone", p
+ s
->objsize
,
634 s
->inuse
- s
->objsize
);
637 off
= s
->offset
+ sizeof(void *);
641 if (s
->flags
& SLAB_STORE_USER
)
642 off
+= 2 * sizeof(struct track
);
645 /* Beginning of the filler is the free pointer */
646 print_section("Padding", p
+ off
, s
->size
- off
);
651 static void object_err(struct kmem_cache
*s
, struct page
*page
,
652 u8
*object
, char *reason
)
654 slab_bug(s
, "%s", reason
);
655 print_trailer(s
, page
, object
);
658 static void slab_err(struct kmem_cache
*s
, struct page
*page
, char *fmt
, ...)
664 vsnprintf(buf
, sizeof(buf
), fmt
, args
);
666 slab_bug(s
, "%s", buf
);
667 print_page_info(page
);
671 static void init_object(struct kmem_cache
*s
, void *object
, u8 val
)
675 if (s
->flags
& __OBJECT_POISON
) {
676 memset(p
, POISON_FREE
, s
->objsize
- 1);
677 p
[s
->objsize
- 1] = POISON_END
;
680 if (s
->flags
& SLAB_RED_ZONE
)
681 memset(p
+ s
->objsize
, val
, s
->inuse
- s
->objsize
);
684 static u8
*check_bytes8(u8
*start
, u8 value
, unsigned int bytes
)
695 static u8
*check_bytes(u8
*start
, u8 value
, unsigned int bytes
)
698 unsigned int words
, prefix
;
701 return check_bytes8(start
, value
, bytes
);
703 value64
= value
| value
<< 8 | value
<< 16 | value
<< 24;
704 value64
= value64
| value64
<< 32;
705 prefix
= 8 - ((unsigned long)start
) % 8;
708 u8
*r
= check_bytes8(start
, value
, prefix
);
718 if (*(u64
*)start
!= value64
)
719 return check_bytes8(start
, value
, 8);
724 return check_bytes8(start
, value
, bytes
% 8);
727 static void restore_bytes(struct kmem_cache
*s
, char *message
, u8 data
,
728 void *from
, void *to
)
730 slab_fix(s
, "Restoring 0x%p-0x%p=0x%x\n", from
, to
- 1, data
);
731 memset(from
, data
, to
- from
);
734 static int check_bytes_and_report(struct kmem_cache
*s
, struct page
*page
,
735 u8
*object
, char *what
,
736 u8
*start
, unsigned int value
, unsigned int bytes
)
741 fault
= check_bytes(start
, value
, bytes
);
746 while (end
> fault
&& end
[-1] == value
)
749 slab_bug(s
, "%s overwritten", what
);
750 printk(KERN_ERR
"INFO: 0x%p-0x%p. First byte 0x%x instead of 0x%x\n",
751 fault
, end
- 1, fault
[0], value
);
752 print_trailer(s
, page
, object
);
754 restore_bytes(s
, what
, value
, fault
, end
);
762 * Bytes of the object to be managed.
763 * If the freepointer may overlay the object then the free
764 * pointer is the first word of the object.
766 * Poisoning uses 0x6b (POISON_FREE) and the last byte is
769 * object + s->objsize
770 * Padding to reach word boundary. This is also used for Redzoning.
771 * Padding is extended by another word if Redzoning is enabled and
774 * We fill with 0xbb (RED_INACTIVE) for inactive objects and with
775 * 0xcc (RED_ACTIVE) for objects in use.
778 * Meta data starts here.
780 * A. Free pointer (if we cannot overwrite object on free)
781 * B. Tracking data for SLAB_STORE_USER
782 * C. Padding to reach required alignment boundary or at mininum
783 * one word if debugging is on to be able to detect writes
784 * before the word boundary.
786 * Padding is done using 0x5a (POISON_INUSE)
789 * Nothing is used beyond s->size.
791 * If slabcaches are merged then the objsize and inuse boundaries are mostly
792 * ignored. And therefore no slab options that rely on these boundaries
793 * may be used with merged slabcaches.
796 static int check_pad_bytes(struct kmem_cache
*s
, struct page
*page
, u8
*p
)
798 unsigned long off
= s
->inuse
; /* The end of info */
801 /* Freepointer is placed after the object. */
802 off
+= sizeof(void *);
804 if (s
->flags
& SLAB_STORE_USER
)
805 /* We also have user information there */
806 off
+= 2 * sizeof(struct track
);
811 return check_bytes_and_report(s
, page
, p
, "Object padding",
812 p
+ off
, POISON_INUSE
, s
->size
- off
);
815 /* Check the pad bytes at the end of a slab page */
816 static int slab_pad_check(struct kmem_cache
*s
, struct page
*page
)
824 if (!(s
->flags
& SLAB_POISON
))
827 start
= page_address(page
);
828 length
= (PAGE_SIZE
<< compound_order(page
)) - s
->reserved
;
829 end
= start
+ length
;
830 remainder
= length
% s
->size
;
834 fault
= check_bytes(end
- remainder
, POISON_INUSE
, remainder
);
837 while (end
> fault
&& end
[-1] == POISON_INUSE
)
840 slab_err(s
, page
, "Padding overwritten. 0x%p-0x%p", fault
, end
- 1);
841 print_section("Padding", end
- remainder
, remainder
);
843 restore_bytes(s
, "slab padding", POISON_INUSE
, end
- remainder
, end
);
847 static int check_object(struct kmem_cache
*s
, struct page
*page
,
848 void *object
, u8 val
)
851 u8
*endobject
= object
+ s
->objsize
;
853 if (s
->flags
& SLAB_RED_ZONE
) {
854 if (!check_bytes_and_report(s
, page
, object
, "Redzone",
855 endobject
, val
, s
->inuse
- s
->objsize
))
858 if ((s
->flags
& SLAB_POISON
) && s
->objsize
< s
->inuse
) {
859 check_bytes_and_report(s
, page
, p
, "Alignment padding",
860 endobject
, POISON_INUSE
, s
->inuse
- s
->objsize
);
864 if (s
->flags
& SLAB_POISON
) {
865 if (val
!= SLUB_RED_ACTIVE
&& (s
->flags
& __OBJECT_POISON
) &&
866 (!check_bytes_and_report(s
, page
, p
, "Poison", p
,
867 POISON_FREE
, s
->objsize
- 1) ||
868 !check_bytes_and_report(s
, page
, p
, "Poison",
869 p
+ s
->objsize
- 1, POISON_END
, 1)))
872 * check_pad_bytes cleans up on its own.
874 check_pad_bytes(s
, page
, p
);
877 if (!s
->offset
&& val
== SLUB_RED_ACTIVE
)
879 * Object and freepointer overlap. Cannot check
880 * freepointer while object is allocated.
884 /* Check free pointer validity */
885 if (!check_valid_pointer(s
, page
, get_freepointer(s
, p
))) {
886 object_err(s
, page
, p
, "Freepointer corrupt");
888 * No choice but to zap it and thus lose the remainder
889 * of the free objects in this slab. May cause
890 * another error because the object count is now wrong.
892 set_freepointer(s
, p
, NULL
);
898 static int check_slab(struct kmem_cache
*s
, struct page
*page
)
902 VM_BUG_ON(!irqs_disabled());
904 if (!PageSlab(page
)) {
905 slab_err(s
, page
, "Not a valid slab page");
909 maxobj
= order_objects(compound_order(page
), s
->size
, s
->reserved
);
910 if (page
->objects
> maxobj
) {
911 slab_err(s
, page
, "objects %u > max %u",
912 s
->name
, page
->objects
, maxobj
);
915 if (page
->inuse
> page
->objects
) {
916 slab_err(s
, page
, "inuse %u > max %u",
917 s
->name
, page
->inuse
, page
->objects
);
920 /* Slab_pad_check fixes things up after itself */
921 slab_pad_check(s
, page
);
926 * Determine if a certain object on a page is on the freelist. Must hold the
927 * slab lock to guarantee that the chains are in a consistent state.
929 static int on_freelist(struct kmem_cache
*s
, struct page
*page
, void *search
)
934 unsigned long max_objects
;
937 while (fp
&& nr
<= page
->objects
) {
940 if (!check_valid_pointer(s
, page
, fp
)) {
942 object_err(s
, page
, object
,
943 "Freechain corrupt");
944 set_freepointer(s
, object
, NULL
);
947 slab_err(s
, page
, "Freepointer corrupt");
948 page
->freelist
= NULL
;
949 page
->inuse
= page
->objects
;
950 slab_fix(s
, "Freelist cleared");
956 fp
= get_freepointer(s
, object
);
960 max_objects
= order_objects(compound_order(page
), s
->size
, s
->reserved
);
961 if (max_objects
> MAX_OBJS_PER_PAGE
)
962 max_objects
= MAX_OBJS_PER_PAGE
;
964 if (page
->objects
!= max_objects
) {
965 slab_err(s
, page
, "Wrong number of objects. Found %d but "
966 "should be %d", page
->objects
, max_objects
);
967 page
->objects
= max_objects
;
968 slab_fix(s
, "Number of objects adjusted.");
970 if (page
->inuse
!= page
->objects
- nr
) {
971 slab_err(s
, page
, "Wrong object count. Counter is %d but "
972 "counted were %d", page
->inuse
, page
->objects
- nr
);
973 page
->inuse
= page
->objects
- nr
;
974 slab_fix(s
, "Object count adjusted.");
976 return search
== NULL
;
979 static void trace(struct kmem_cache
*s
, struct page
*page
, void *object
,
982 if (s
->flags
& SLAB_TRACE
) {
983 printk(KERN_INFO
"TRACE %s %s 0x%p inuse=%d fp=0x%p\n",
985 alloc
? "alloc" : "free",
990 print_section("Object", (void *)object
, s
->objsize
);
997 * Hooks for other subsystems that check memory allocations. In a typical
998 * production configuration these hooks all should produce no code at all.
1000 static inline int slab_pre_alloc_hook(struct kmem_cache
*s
, gfp_t flags
)
1002 flags
&= gfp_allowed_mask
;
1003 lockdep_trace_alloc(flags
);
1004 might_sleep_if(flags
& __GFP_WAIT
);
1006 return should_failslab(s
->objsize
, flags
, s
->flags
);
1009 static inline void slab_post_alloc_hook(struct kmem_cache
*s
, gfp_t flags
, void *object
)
1011 flags
&= gfp_allowed_mask
;
1012 kmemcheck_slab_alloc(s
, flags
, object
, slab_ksize(s
));
1013 kmemleak_alloc_recursive(object
, s
->objsize
, 1, s
->flags
, flags
);
1016 static inline void slab_free_hook(struct kmem_cache
*s
, void *x
)
1018 kmemleak_free_recursive(x
, s
->flags
);
1021 * Trouble is that we may no longer disable interupts in the fast path
1022 * So in order to make the debug calls that expect irqs to be
1023 * disabled we need to disable interrupts temporarily.
1025 #if defined(CONFIG_KMEMCHECK) || defined(CONFIG_LOCKDEP)
1027 unsigned long flags
;
1029 local_irq_save(flags
);
1030 kmemcheck_slab_free(s
, x
, s
->objsize
);
1031 debug_check_no_locks_freed(x
, s
->objsize
);
1032 local_irq_restore(flags
);
1035 if (!(s
->flags
& SLAB_DEBUG_OBJECTS
))
1036 debug_check_no_obj_freed(x
, s
->objsize
);
1040 * Tracking of fully allocated slabs for debugging purposes.
1042 * list_lock must be held.
1044 static void add_full(struct kmem_cache
*s
,
1045 struct kmem_cache_node
*n
, struct page
*page
)
1047 if (!(s
->flags
& SLAB_STORE_USER
))
1050 list_add(&page
->lru
, &n
->full
);
1054 * list_lock must be held.
1056 static void remove_full(struct kmem_cache
*s
, struct page
*page
)
1058 if (!(s
->flags
& SLAB_STORE_USER
))
1061 list_del(&page
->lru
);
1064 /* Tracking of the number of slabs for debugging purposes */
1065 static inline unsigned long slabs_node(struct kmem_cache
*s
, int node
)
1067 struct kmem_cache_node
*n
= get_node(s
, node
);
1069 return atomic_long_read(&n
->nr_slabs
);
1072 static inline unsigned long node_nr_slabs(struct kmem_cache_node
*n
)
1074 return atomic_long_read(&n
->nr_slabs
);
1077 static inline void inc_slabs_node(struct kmem_cache
*s
, int node
, int objects
)
1079 struct kmem_cache_node
*n
= get_node(s
, node
);
1082 * May be called early in order to allocate a slab for the
1083 * kmem_cache_node structure. Solve the chicken-egg
1084 * dilemma by deferring the increment of the count during
1085 * bootstrap (see early_kmem_cache_node_alloc).
1088 atomic_long_inc(&n
->nr_slabs
);
1089 atomic_long_add(objects
, &n
->total_objects
);
1092 static inline void dec_slabs_node(struct kmem_cache
*s
, int node
, int objects
)
1094 struct kmem_cache_node
*n
= get_node(s
, node
);
1096 atomic_long_dec(&n
->nr_slabs
);
1097 atomic_long_sub(objects
, &n
->total_objects
);
1100 /* Object debug checks for alloc/free paths */
1101 static void setup_object_debug(struct kmem_cache
*s
, struct page
*page
,
1104 if (!(s
->flags
& (SLAB_STORE_USER
|SLAB_RED_ZONE
|__OBJECT_POISON
)))
1107 init_object(s
, object
, SLUB_RED_INACTIVE
);
1108 init_tracking(s
, object
);
1111 static noinline
int alloc_debug_processing(struct kmem_cache
*s
, struct page
*page
,
1112 void *object
, unsigned long addr
)
1114 if (!check_slab(s
, page
))
1117 if (!check_valid_pointer(s
, page
, object
)) {
1118 object_err(s
, page
, object
, "Freelist Pointer check fails");
1122 if (!check_object(s
, page
, object
, SLUB_RED_INACTIVE
))
1125 /* Success perform special debug activities for allocs */
1126 if (s
->flags
& SLAB_STORE_USER
)
1127 set_track(s
, object
, TRACK_ALLOC
, addr
);
1128 trace(s
, page
, object
, 1);
1129 init_object(s
, object
, SLUB_RED_ACTIVE
);
1133 if (PageSlab(page
)) {
1135 * If this is a slab page then lets do the best we can
1136 * to avoid issues in the future. Marking all objects
1137 * as used avoids touching the remaining objects.
1139 slab_fix(s
, "Marking all objects used");
1140 page
->inuse
= page
->objects
;
1141 page
->freelist
= NULL
;
1146 static noinline
int free_debug_processing(struct kmem_cache
*s
,
1147 struct page
*page
, void *object
, unsigned long addr
)
1149 unsigned long flags
;
1152 local_irq_save(flags
);
1155 if (!check_slab(s
, page
))
1158 if (!check_valid_pointer(s
, page
, object
)) {
1159 slab_err(s
, page
, "Invalid object pointer 0x%p", object
);
1163 if (on_freelist(s
, page
, object
)) {
1164 object_err(s
, page
, object
, "Object already free");
1168 if (!check_object(s
, page
, object
, SLUB_RED_ACTIVE
))
1171 if (unlikely(s
!= page
->slab
)) {
1172 if (!PageSlab(page
)) {
1173 slab_err(s
, page
, "Attempt to free object(0x%p) "
1174 "outside of slab", object
);
1175 } else if (!page
->slab
) {
1177 "SLUB <none>: no slab for object 0x%p.\n",
1181 object_err(s
, page
, object
,
1182 "page slab pointer corrupt.");
1186 if (s
->flags
& SLAB_STORE_USER
)
1187 set_track(s
, object
, TRACK_FREE
, addr
);
1188 trace(s
, page
, object
, 0);
1189 init_object(s
, object
, SLUB_RED_INACTIVE
);
1193 local_irq_restore(flags
);
1197 slab_fix(s
, "Object at 0x%p not freed", object
);
1201 static int __init
setup_slub_debug(char *str
)
1203 slub_debug
= DEBUG_DEFAULT_FLAGS
;
1204 if (*str
++ != '=' || !*str
)
1206 * No options specified. Switch on full debugging.
1212 * No options but restriction on slabs. This means full
1213 * debugging for slabs matching a pattern.
1217 if (tolower(*str
) == 'o') {
1219 * Avoid enabling debugging on caches if its minimum order
1220 * would increase as a result.
1222 disable_higher_order_debug
= 1;
1229 * Switch off all debugging measures.
1234 * Determine which debug features should be switched on
1236 for (; *str
&& *str
!= ','; str
++) {
1237 switch (tolower(*str
)) {
1239 slub_debug
|= SLAB_DEBUG_FREE
;
1242 slub_debug
|= SLAB_RED_ZONE
;
1245 slub_debug
|= SLAB_POISON
;
1248 slub_debug
|= SLAB_STORE_USER
;
1251 slub_debug
|= SLAB_TRACE
;
1254 slub_debug
|= SLAB_FAILSLAB
;
1257 printk(KERN_ERR
"slub_debug option '%c' "
1258 "unknown. skipped\n", *str
);
1264 slub_debug_slabs
= str
+ 1;
1269 __setup("slub_debug", setup_slub_debug
);
1271 static unsigned long kmem_cache_flags(unsigned long objsize
,
1272 unsigned long flags
, const char *name
,
1273 void (*ctor
)(void *))
1276 * Enable debugging if selected on the kernel commandline.
1278 if (slub_debug
&& (!slub_debug_slabs
||
1279 !strncmp(slub_debug_slabs
, name
, strlen(slub_debug_slabs
))))
1280 flags
|= slub_debug
;
1285 static inline void setup_object_debug(struct kmem_cache
*s
,
1286 struct page
*page
, void *object
) {}
1288 static inline int alloc_debug_processing(struct kmem_cache
*s
,
1289 struct page
*page
, void *object
, unsigned long addr
) { return 0; }
1291 static inline int free_debug_processing(struct kmem_cache
*s
,
1292 struct page
*page
, void *object
, unsigned long addr
) { return 0; }
1294 static inline int slab_pad_check(struct kmem_cache
*s
, struct page
*page
)
1296 static inline int check_object(struct kmem_cache
*s
, struct page
*page
,
1297 void *object
, u8 val
) { return 1; }
1298 static inline void add_full(struct kmem_cache
*s
, struct kmem_cache_node
*n
,
1299 struct page
*page
) {}
1300 static inline void remove_full(struct kmem_cache
*s
, struct page
*page
) {}
1301 static inline unsigned long kmem_cache_flags(unsigned long objsize
,
1302 unsigned long flags
, const char *name
,
1303 void (*ctor
)(void *))
1307 #define slub_debug 0
1309 #define disable_higher_order_debug 0
1311 static inline unsigned long slabs_node(struct kmem_cache
*s
, int node
)
1313 static inline unsigned long node_nr_slabs(struct kmem_cache_node
*n
)
1315 static inline void inc_slabs_node(struct kmem_cache
*s
, int node
,
1317 static inline void dec_slabs_node(struct kmem_cache
*s
, int node
,
1320 static inline int slab_pre_alloc_hook(struct kmem_cache
*s
, gfp_t flags
)
1323 static inline void slab_post_alloc_hook(struct kmem_cache
*s
, gfp_t flags
,
1326 static inline void slab_free_hook(struct kmem_cache
*s
, void *x
) {}
1328 #endif /* CONFIG_SLUB_DEBUG */
1331 * Slab allocation and freeing
1333 static inline struct page
*alloc_slab_page(gfp_t flags
, int node
,
1334 struct kmem_cache_order_objects oo
)
1336 int order
= oo_order(oo
);
1338 flags
|= __GFP_NOTRACK
;
1340 if (node
== NUMA_NO_NODE
)
1341 return alloc_pages(flags
, order
);
1343 return alloc_pages_exact_node(node
, flags
, order
);
1346 static struct page
*allocate_slab(struct kmem_cache
*s
, gfp_t flags
, int node
)
1349 struct kmem_cache_order_objects oo
= s
->oo
;
1352 flags
&= gfp_allowed_mask
;
1354 if (flags
& __GFP_WAIT
)
1357 flags
|= s
->allocflags
;
1360 * Let the initial higher-order allocation fail under memory pressure
1361 * so we fall-back to the minimum order allocation.
1363 alloc_gfp
= (flags
| __GFP_NOWARN
| __GFP_NORETRY
) & ~__GFP_NOFAIL
;
1365 page
= alloc_slab_page(alloc_gfp
, node
, oo
);
1366 if (unlikely(!page
)) {
1369 * Allocation may have failed due to fragmentation.
1370 * Try a lower order alloc if possible
1372 page
= alloc_slab_page(flags
, node
, oo
);
1375 stat(s
, ORDER_FALLBACK
);
1378 if (flags
& __GFP_WAIT
)
1379 local_irq_disable();
1384 if (kmemcheck_enabled
1385 && !(s
->flags
& (SLAB_NOTRACK
| DEBUG_DEFAULT_FLAGS
))) {
1386 int pages
= 1 << oo_order(oo
);
1388 kmemcheck_alloc_shadow(page
, oo_order(oo
), flags
, node
);
1391 * Objects from caches that have a constructor don't get
1392 * cleared when they're allocated, so we need to do it here.
1395 kmemcheck_mark_uninitialized_pages(page
, pages
);
1397 kmemcheck_mark_unallocated_pages(page
, pages
);
1400 page
->objects
= oo_objects(oo
);
1401 mod_zone_page_state(page_zone(page
),
1402 (s
->flags
& SLAB_RECLAIM_ACCOUNT
) ?
1403 NR_SLAB_RECLAIMABLE
: NR_SLAB_UNRECLAIMABLE
,
1409 static void setup_object(struct kmem_cache
*s
, struct page
*page
,
1412 setup_object_debug(s
, page
, object
);
1413 if (unlikely(s
->ctor
))
1417 static struct page
*new_slab(struct kmem_cache
*s
, gfp_t flags
, int node
)
1424 BUG_ON(flags
& GFP_SLAB_BUG_MASK
);
1426 page
= allocate_slab(s
,
1427 flags
& (GFP_RECLAIM_MASK
| GFP_CONSTRAINT_MASK
), node
);
1431 inc_slabs_node(s
, page_to_nid(page
), page
->objects
);
1433 page
->flags
|= 1 << PG_slab
;
1435 start
= page_address(page
);
1437 if (unlikely(s
->flags
& SLAB_POISON
))
1438 memset(start
, POISON_INUSE
, PAGE_SIZE
<< compound_order(page
));
1441 for_each_object(p
, s
, start
, page
->objects
) {
1442 setup_object(s
, page
, last
);
1443 set_freepointer(s
, last
, p
);
1446 setup_object(s
, page
, last
);
1447 set_freepointer(s
, last
, NULL
);
1449 page
->freelist
= start
;
1456 static void __free_slab(struct kmem_cache
*s
, struct page
*page
)
1458 int order
= compound_order(page
);
1459 int pages
= 1 << order
;
1461 if (kmem_cache_debug(s
)) {
1464 slab_pad_check(s
, page
);
1465 for_each_object(p
, s
, page_address(page
),
1467 check_object(s
, page
, p
, SLUB_RED_INACTIVE
);
1470 kmemcheck_free_shadow(page
, compound_order(page
));
1472 mod_zone_page_state(page_zone(page
),
1473 (s
->flags
& SLAB_RECLAIM_ACCOUNT
) ?
1474 NR_SLAB_RECLAIMABLE
: NR_SLAB_UNRECLAIMABLE
,
1477 __ClearPageSlab(page
);
1478 reset_page_mapcount(page
);
1479 if (current
->reclaim_state
)
1480 current
->reclaim_state
->reclaimed_slab
+= pages
;
1481 __free_pages(page
, order
);
1484 #define need_reserve_slab_rcu \
1485 (sizeof(((struct page *)NULL)->lru) < sizeof(struct rcu_head))
1487 static void rcu_free_slab(struct rcu_head
*h
)
1491 if (need_reserve_slab_rcu
)
1492 page
= virt_to_head_page(h
);
1494 page
= container_of((struct list_head
*)h
, struct page
, lru
);
1496 __free_slab(page
->slab
, page
);
1499 static void free_slab(struct kmem_cache
*s
, struct page
*page
)
1501 if (unlikely(s
->flags
& SLAB_DESTROY_BY_RCU
)) {
1502 struct rcu_head
*head
;
1504 if (need_reserve_slab_rcu
) {
1505 int order
= compound_order(page
);
1506 int offset
= (PAGE_SIZE
<< order
) - s
->reserved
;
1508 VM_BUG_ON(s
->reserved
!= sizeof(*head
));
1509 head
= page_address(page
) + offset
;
1512 * RCU free overloads the RCU head over the LRU
1514 head
= (void *)&page
->lru
;
1517 call_rcu(head
, rcu_free_slab
);
1519 __free_slab(s
, page
);
1522 static void discard_slab(struct kmem_cache
*s
, struct page
*page
)
1524 dec_slabs_node(s
, page_to_nid(page
), page
->objects
);
1529 * Management of partially allocated slabs.
1531 * list_lock must be held.
1533 static inline void add_partial(struct kmem_cache_node
*n
,
1534 struct page
*page
, int tail
)
1538 list_add_tail(&page
->lru
, &n
->partial
);
1540 list_add(&page
->lru
, &n
->partial
);
1544 * list_lock must be held.
1546 static inline void remove_partial(struct kmem_cache_node
*n
,
1549 list_del(&page
->lru
);
1554 * Lock slab, remove from the partial list and put the object into the
1557 * Must hold list_lock.
1559 static inline int acquire_slab(struct kmem_cache
*s
,
1560 struct kmem_cache_node
*n
, struct page
*page
)
1563 unsigned long counters
;
1567 * Zap the freelist and set the frozen bit.
1568 * The old freelist is the list of objects for the
1569 * per cpu allocation list.
1572 freelist
= page
->freelist
;
1573 counters
= page
->counters
;
1574 new.counters
= counters
;
1575 new.inuse
= page
->objects
;
1577 VM_BUG_ON(new.frozen
);
1580 } while (!__cmpxchg_double_slab(s
, page
,
1583 "lock and freeze"));
1585 remove_partial(n
, page
);
1588 /* Populate the per cpu freelist */
1589 this_cpu_write(s
->cpu_slab
->freelist
, freelist
);
1590 this_cpu_write(s
->cpu_slab
->page
, page
);
1591 this_cpu_write(s
->cpu_slab
->node
, page_to_nid(page
));
1595 * Slab page came from the wrong list. No object to allocate
1596 * from. Put it onto the correct list and continue partial
1599 printk(KERN_ERR
"SLUB: %s : Page without available objects on"
1600 " partial list\n", s
->name
);
1606 * Try to allocate a partial slab from a specific node.
1608 static struct page
*get_partial_node(struct kmem_cache
*s
,
1609 struct kmem_cache_node
*n
)
1614 * Racy check. If we mistakenly see no partial slabs then we
1615 * just allocate an empty slab. If we mistakenly try to get a
1616 * partial slab and there is none available then get_partials()
1619 if (!n
|| !n
->nr_partial
)
1622 spin_lock(&n
->list_lock
);
1623 list_for_each_entry(page
, &n
->partial
, lru
)
1624 if (acquire_slab(s
, n
, page
))
1628 spin_unlock(&n
->list_lock
);
1633 * Get a page from somewhere. Search in increasing NUMA distances.
1635 static struct page
*get_any_partial(struct kmem_cache
*s
, gfp_t flags
)
1638 struct zonelist
*zonelist
;
1641 enum zone_type high_zoneidx
= gfp_zone(flags
);
1645 * The defrag ratio allows a configuration of the tradeoffs between
1646 * inter node defragmentation and node local allocations. A lower
1647 * defrag_ratio increases the tendency to do local allocations
1648 * instead of attempting to obtain partial slabs from other nodes.
1650 * If the defrag_ratio is set to 0 then kmalloc() always
1651 * returns node local objects. If the ratio is higher then kmalloc()
1652 * may return off node objects because partial slabs are obtained
1653 * from other nodes and filled up.
1655 * If /sys/kernel/slab/xx/defrag_ratio is set to 100 (which makes
1656 * defrag_ratio = 1000) then every (well almost) allocation will
1657 * first attempt to defrag slab caches on other nodes. This means
1658 * scanning over all nodes to look for partial slabs which may be
1659 * expensive if we do it every time we are trying to find a slab
1660 * with available objects.
1662 if (!s
->remote_node_defrag_ratio
||
1663 get_cycles() % 1024 > s
->remote_node_defrag_ratio
)
1667 zonelist
= node_zonelist(slab_node(current
->mempolicy
), flags
);
1668 for_each_zone_zonelist(zone
, z
, zonelist
, high_zoneidx
) {
1669 struct kmem_cache_node
*n
;
1671 n
= get_node(s
, zone_to_nid(zone
));
1673 if (n
&& cpuset_zone_allowed_hardwall(zone
, flags
) &&
1674 n
->nr_partial
> s
->min_partial
) {
1675 page
= get_partial_node(s
, n
);
1688 * Get a partial page, lock it and return it.
1690 static struct page
*get_partial(struct kmem_cache
*s
, gfp_t flags
, int node
)
1693 int searchnode
= (node
== NUMA_NO_NODE
) ? numa_node_id() : node
;
1695 page
= get_partial_node(s
, get_node(s
, searchnode
));
1696 if (page
|| node
!= NUMA_NO_NODE
)
1699 return get_any_partial(s
, flags
);
1702 #ifdef CONFIG_PREEMPT
1704 * Calculate the next globally unique transaction for disambiguiation
1705 * during cmpxchg. The transactions start with the cpu number and are then
1706 * incremented by CONFIG_NR_CPUS.
1708 #define TID_STEP roundup_pow_of_two(CONFIG_NR_CPUS)
1711 * No preemption supported therefore also no need to check for
1717 static inline unsigned long next_tid(unsigned long tid
)
1719 return tid
+ TID_STEP
;
1722 static inline unsigned int tid_to_cpu(unsigned long tid
)
1724 return tid
% TID_STEP
;
1727 static inline unsigned long tid_to_event(unsigned long tid
)
1729 return tid
/ TID_STEP
;
1732 static inline unsigned int init_tid(int cpu
)
1737 static inline void note_cmpxchg_failure(const char *n
,
1738 const struct kmem_cache
*s
, unsigned long tid
)
1740 #ifdef SLUB_DEBUG_CMPXCHG
1741 unsigned long actual_tid
= __this_cpu_read(s
->cpu_slab
->tid
);
1743 printk(KERN_INFO
"%s %s: cmpxchg redo ", n
, s
->name
);
1745 #ifdef CONFIG_PREEMPT
1746 if (tid_to_cpu(tid
) != tid_to_cpu(actual_tid
))
1747 printk("due to cpu change %d -> %d\n",
1748 tid_to_cpu(tid
), tid_to_cpu(actual_tid
));
1751 if (tid_to_event(tid
) != tid_to_event(actual_tid
))
1752 printk("due to cpu running other code. Event %ld->%ld\n",
1753 tid_to_event(tid
), tid_to_event(actual_tid
));
1755 printk("for unknown reason: actual=%lx was=%lx target=%lx\n",
1756 actual_tid
, tid
, next_tid(tid
));
1758 stat(s
, CMPXCHG_DOUBLE_CPU_FAIL
);
1761 void init_kmem_cache_cpus(struct kmem_cache
*s
)
1765 for_each_possible_cpu(cpu
)
1766 per_cpu_ptr(s
->cpu_slab
, cpu
)->tid
= init_tid(cpu
);
1769 * Remove the cpu slab
1773 * Remove the cpu slab
1775 static void deactivate_slab(struct kmem_cache
*s
, struct kmem_cache_cpu
*c
)
1777 enum slab_modes
{ M_NONE
, M_PARTIAL
, M_FULL
, M_FREE
};
1778 struct page
*page
= c
->page
;
1779 struct kmem_cache_node
*n
= get_node(s
, page_to_nid(page
));
1781 enum slab_modes l
= M_NONE
, m
= M_NONE
;
1788 if (page
->freelist
) {
1789 stat(s
, DEACTIVATE_REMOTE_FREES
);
1793 c
->tid
= next_tid(c
->tid
);
1795 freelist
= c
->freelist
;
1799 * Stage one: Free all available per cpu objects back
1800 * to the page freelist while it is still frozen. Leave the
1803 * There is no need to take the list->lock because the page
1806 while (freelist
&& (nextfree
= get_freepointer(s
, freelist
))) {
1808 unsigned long counters
;
1811 prior
= page
->freelist
;
1812 counters
= page
->counters
;
1813 set_freepointer(s
, freelist
, prior
);
1814 new.counters
= counters
;
1816 VM_BUG_ON(!new.frozen
);
1818 } while (!__cmpxchg_double_slab(s
, page
,
1820 freelist
, new.counters
,
1821 "drain percpu freelist"));
1823 freelist
= nextfree
;
1827 * Stage two: Ensure that the page is unfrozen while the
1828 * list presence reflects the actual number of objects
1831 * We setup the list membership and then perform a cmpxchg
1832 * with the count. If there is a mismatch then the page
1833 * is not unfrozen but the page is on the wrong list.
1835 * Then we restart the process which may have to remove
1836 * the page from the list that we just put it on again
1837 * because the number of objects in the slab may have
1842 old
.freelist
= page
->freelist
;
1843 old
.counters
= page
->counters
;
1844 VM_BUG_ON(!old
.frozen
);
1846 /* Determine target state of the slab */
1847 new.counters
= old
.counters
;
1850 set_freepointer(s
, freelist
, old
.freelist
);
1851 new.freelist
= freelist
;
1853 new.freelist
= old
.freelist
;
1857 if (!new.inuse
&& n
->nr_partial
< s
->min_partial
)
1859 else if (new.freelist
) {
1864 * Taking the spinlock removes the possiblity
1865 * that acquire_slab() will see a slab page that
1868 spin_lock(&n
->list_lock
);
1872 if (kmem_cache_debug(s
) && !lock
) {
1875 * This also ensures that the scanning of full
1876 * slabs from diagnostic functions will not see
1879 spin_lock(&n
->list_lock
);
1887 remove_partial(n
, page
);
1889 else if (l
== M_FULL
)
1891 remove_full(s
, page
);
1893 if (m
== M_PARTIAL
) {
1895 add_partial(n
, page
, tail
);
1896 stat(s
, tail
? DEACTIVATE_TO_TAIL
: DEACTIVATE_TO_HEAD
);
1898 } else if (m
== M_FULL
) {
1900 stat(s
, DEACTIVATE_FULL
);
1901 add_full(s
, n
, page
);
1907 if (!__cmpxchg_double_slab(s
, page
,
1908 old
.freelist
, old
.counters
,
1909 new.freelist
, new.counters
,
1914 spin_unlock(&n
->list_lock
);
1917 stat(s
, DEACTIVATE_EMPTY
);
1918 discard_slab(s
, page
);
1923 static inline void flush_slab(struct kmem_cache
*s
, struct kmem_cache_cpu
*c
)
1925 stat(s
, CPUSLAB_FLUSH
);
1926 deactivate_slab(s
, c
);
1932 * Called from IPI handler with interrupts disabled.
1934 static inline void __flush_cpu_slab(struct kmem_cache
*s
, int cpu
)
1936 struct kmem_cache_cpu
*c
= per_cpu_ptr(s
->cpu_slab
, cpu
);
1938 if (likely(c
&& c
->page
))
1942 static void flush_cpu_slab(void *d
)
1944 struct kmem_cache
*s
= d
;
1946 __flush_cpu_slab(s
, smp_processor_id());
1949 static void flush_all(struct kmem_cache
*s
)
1951 on_each_cpu(flush_cpu_slab
, s
, 1);
1955 * Check if the objects in a per cpu structure fit numa
1956 * locality expectations.
1958 static inline int node_match(struct kmem_cache_cpu
*c
, int node
)
1961 if (node
!= NUMA_NO_NODE
&& c
->node
!= node
)
1967 static int count_free(struct page
*page
)
1969 return page
->objects
- page
->inuse
;
1972 static unsigned long count_partial(struct kmem_cache_node
*n
,
1973 int (*get_count
)(struct page
*))
1975 unsigned long flags
;
1976 unsigned long x
= 0;
1979 spin_lock_irqsave(&n
->list_lock
, flags
);
1980 list_for_each_entry(page
, &n
->partial
, lru
)
1981 x
+= get_count(page
);
1982 spin_unlock_irqrestore(&n
->list_lock
, flags
);
1986 static inline unsigned long node_nr_objs(struct kmem_cache_node
*n
)
1988 #ifdef CONFIG_SLUB_DEBUG
1989 return atomic_long_read(&n
->total_objects
);
1995 static noinline
void
1996 slab_out_of_memory(struct kmem_cache
*s
, gfp_t gfpflags
, int nid
)
2001 "SLUB: Unable to allocate memory on node %d (gfp=0x%x)\n",
2003 printk(KERN_WARNING
" cache: %s, object size: %d, buffer size: %d, "
2004 "default order: %d, min order: %d\n", s
->name
, s
->objsize
,
2005 s
->size
, oo_order(s
->oo
), oo_order(s
->min
));
2007 if (oo_order(s
->min
) > get_order(s
->objsize
))
2008 printk(KERN_WARNING
" %s debugging increased min order, use "
2009 "slub_debug=O to disable.\n", s
->name
);
2011 for_each_online_node(node
) {
2012 struct kmem_cache_node
*n
= get_node(s
, node
);
2013 unsigned long nr_slabs
;
2014 unsigned long nr_objs
;
2015 unsigned long nr_free
;
2020 nr_free
= count_partial(n
, count_free
);
2021 nr_slabs
= node_nr_slabs(n
);
2022 nr_objs
= node_nr_objs(n
);
2025 " node %d: slabs: %ld, objs: %ld, free: %ld\n",
2026 node
, nr_slabs
, nr_objs
, nr_free
);
2031 * Slow path. The lockless freelist is empty or we need to perform
2034 * Interrupts are disabled.
2036 * Processing is still very fast if new objects have been freed to the
2037 * regular freelist. In that case we simply take over the regular freelist
2038 * as the lockless freelist and zap the regular freelist.
2040 * If that is not working then we fall back to the partial lists. We take the
2041 * first element of the freelist as the object to allocate now and move the
2042 * rest of the freelist to the lockless freelist.
2044 * And if we were unable to get a new slab from the partial slab lists then
2045 * we need to allocate a new slab. This is the slowest path since it involves
2046 * a call to the page allocator and the setup of a new slab.
2048 static void *__slab_alloc(struct kmem_cache
*s
, gfp_t gfpflags
, int node
,
2049 unsigned long addr
, struct kmem_cache_cpu
*c
)
2053 unsigned long flags
;
2055 unsigned long counters
;
2057 local_irq_save(flags
);
2058 #ifdef CONFIG_PREEMPT
2060 * We may have been preempted and rescheduled on a different
2061 * cpu before disabling interrupts. Need to reload cpu area
2064 c
= this_cpu_ptr(s
->cpu_slab
);
2067 /* We handle __GFP_ZERO in the caller */
2068 gfpflags
&= ~__GFP_ZERO
;
2074 if (unlikely(!node_match(c
, node
))) {
2075 stat(s
, ALLOC_NODE_MISMATCH
);
2076 deactivate_slab(s
, c
);
2080 stat(s
, ALLOC_SLOWPATH
);
2083 object
= page
->freelist
;
2084 counters
= page
->counters
;
2085 new.counters
= counters
;
2086 VM_BUG_ON(!new.frozen
);
2089 * If there is no object left then we use this loop to
2090 * deactivate the slab which is simple since no objects
2091 * are left in the slab and therefore we do not need to
2092 * put the page back onto the partial list.
2094 * If there are objects left then we retrieve them
2095 * and use them to refill the per cpu queue.
2098 new.inuse
= page
->objects
;
2099 new.frozen
= object
!= NULL
;
2101 } while (!__cmpxchg_double_slab(s
, page
,
2106 if (unlikely(!object
)) {
2108 stat(s
, DEACTIVATE_BYPASS
);
2112 stat(s
, ALLOC_REFILL
);
2115 VM_BUG_ON(!page
->frozen
);
2116 c
->freelist
= get_freepointer(s
, object
);
2117 c
->tid
= next_tid(c
->tid
);
2118 local_irq_restore(flags
);
2122 page
= get_partial(s
, gfpflags
, node
);
2124 stat(s
, ALLOC_FROM_PARTIAL
);
2125 object
= c
->freelist
;
2127 if (kmem_cache_debug(s
))
2132 page
= new_slab(s
, gfpflags
, node
);
2135 c
= __this_cpu_ptr(s
->cpu_slab
);
2140 * No other reference to the page yet so we can
2141 * muck around with it freely without cmpxchg
2143 object
= page
->freelist
;
2144 page
->freelist
= NULL
;
2145 page
->inuse
= page
->objects
;
2147 stat(s
, ALLOC_SLAB
);
2148 c
->node
= page_to_nid(page
);
2151 if (kmem_cache_debug(s
))
2155 if (!(gfpflags
& __GFP_NOWARN
) && printk_ratelimit())
2156 slab_out_of_memory(s
, gfpflags
, node
);
2157 local_irq_restore(flags
);
2161 if (!object
|| !alloc_debug_processing(s
, page
, object
, addr
))
2164 c
->freelist
= get_freepointer(s
, object
);
2165 deactivate_slab(s
, c
);
2167 c
->node
= NUMA_NO_NODE
;
2168 local_irq_restore(flags
);
2173 * Inlined fastpath so that allocation functions (kmalloc, kmem_cache_alloc)
2174 * have the fastpath folded into their functions. So no function call
2175 * overhead for requests that can be satisfied on the fastpath.
2177 * The fastpath works by first checking if the lockless freelist can be used.
2178 * If not then __slab_alloc is called for slow processing.
2180 * Otherwise we can simply pick the next object from the lockless free list.
2182 static __always_inline
void *slab_alloc(struct kmem_cache
*s
,
2183 gfp_t gfpflags
, int node
, unsigned long addr
)
2186 struct kmem_cache_cpu
*c
;
2189 if (slab_pre_alloc_hook(s
, gfpflags
))
2195 * Must read kmem_cache cpu data via this cpu ptr. Preemption is
2196 * enabled. We may switch back and forth between cpus while
2197 * reading from one cpu area. That does not matter as long
2198 * as we end up on the original cpu again when doing the cmpxchg.
2200 c
= __this_cpu_ptr(s
->cpu_slab
);
2203 * The transaction ids are globally unique per cpu and per operation on
2204 * a per cpu queue. Thus they can be guarantee that the cmpxchg_double
2205 * occurs on the right processor and that there was no operation on the
2206 * linked list in between.
2211 object
= c
->freelist
;
2212 if (unlikely(!object
|| !node_match(c
, node
)))
2214 object
= __slab_alloc(s
, gfpflags
, node
, addr
, c
);
2218 * The cmpxchg will only match if there was no additional
2219 * operation and if we are on the right processor.
2221 * The cmpxchg does the following atomically (without lock semantics!)
2222 * 1. Relocate first pointer to the current per cpu area.
2223 * 2. Verify that tid and freelist have not been changed
2224 * 3. If they were not changed replace tid and freelist
2226 * Since this is without lock semantics the protection is only against
2227 * code executing on this cpu *not* from access by other cpus.
2229 if (unlikely(!irqsafe_cpu_cmpxchg_double(
2230 s
->cpu_slab
->freelist
, s
->cpu_slab
->tid
,
2232 get_freepointer_safe(s
, object
), next_tid(tid
)))) {
2234 note_cmpxchg_failure("slab_alloc", s
, tid
);
2237 stat(s
, ALLOC_FASTPATH
);
2240 if (unlikely(gfpflags
& __GFP_ZERO
) && object
)
2241 memset(object
, 0, s
->objsize
);
2243 slab_post_alloc_hook(s
, gfpflags
, object
);
2248 void *kmem_cache_alloc(struct kmem_cache
*s
, gfp_t gfpflags
)
2250 void *ret
= slab_alloc(s
, gfpflags
, NUMA_NO_NODE
, _RET_IP_
);
2252 trace_kmem_cache_alloc(_RET_IP_
, ret
, s
->objsize
, s
->size
, gfpflags
);
2256 EXPORT_SYMBOL(kmem_cache_alloc
);
2258 #ifdef CONFIG_TRACING
2259 void *kmem_cache_alloc_trace(struct kmem_cache
*s
, gfp_t gfpflags
, size_t size
)
2261 void *ret
= slab_alloc(s
, gfpflags
, NUMA_NO_NODE
, _RET_IP_
);
2262 trace_kmalloc(_RET_IP_
, ret
, size
, s
->size
, gfpflags
);
2265 EXPORT_SYMBOL(kmem_cache_alloc_trace
);
2267 void *kmalloc_order_trace(size_t size
, gfp_t flags
, unsigned int order
)
2269 void *ret
= kmalloc_order(size
, flags
, order
);
2270 trace_kmalloc(_RET_IP_
, ret
, size
, PAGE_SIZE
<< order
, flags
);
2273 EXPORT_SYMBOL(kmalloc_order_trace
);
2277 void *kmem_cache_alloc_node(struct kmem_cache
*s
, gfp_t gfpflags
, int node
)
2279 void *ret
= slab_alloc(s
, gfpflags
, node
, _RET_IP_
);
2281 trace_kmem_cache_alloc_node(_RET_IP_
, ret
,
2282 s
->objsize
, s
->size
, gfpflags
, node
);
2286 EXPORT_SYMBOL(kmem_cache_alloc_node
);
2288 #ifdef CONFIG_TRACING
2289 void *kmem_cache_alloc_node_trace(struct kmem_cache
*s
,
2291 int node
, size_t size
)
2293 void *ret
= slab_alloc(s
, gfpflags
, node
, _RET_IP_
);
2295 trace_kmalloc_node(_RET_IP_
, ret
,
2296 size
, s
->size
, gfpflags
, node
);
2299 EXPORT_SYMBOL(kmem_cache_alloc_node_trace
);
2304 * Slow patch handling. This may still be called frequently since objects
2305 * have a longer lifetime than the cpu slabs in most processing loads.
2307 * So we still attempt to reduce cache line usage. Just take the slab
2308 * lock and free the item. If there is no additional partial page
2309 * handling required then we can return immediately.
2311 static void __slab_free(struct kmem_cache
*s
, struct page
*page
,
2312 void *x
, unsigned long addr
)
2315 void **object
= (void *)x
;
2319 unsigned long counters
;
2320 struct kmem_cache_node
*n
= NULL
;
2321 unsigned long uninitialized_var(flags
);
2323 stat(s
, FREE_SLOWPATH
);
2325 if (kmem_cache_debug(s
) && !free_debug_processing(s
, page
, x
, addr
))
2329 prior
= page
->freelist
;
2330 counters
= page
->counters
;
2331 set_freepointer(s
, object
, prior
);
2332 new.counters
= counters
;
2333 was_frozen
= new.frozen
;
2335 if ((!new.inuse
|| !prior
) && !was_frozen
&& !n
) {
2336 n
= get_node(s
, page_to_nid(page
));
2338 * Speculatively acquire the list_lock.
2339 * If the cmpxchg does not succeed then we may
2340 * drop the list_lock without any processing.
2342 * Otherwise the list_lock will synchronize with
2343 * other processors updating the list of slabs.
2345 spin_lock_irqsave(&n
->list_lock
, flags
);
2349 } while (!cmpxchg_double_slab(s
, page
,
2351 object
, new.counters
,
2356 * The list lock was not taken therefore no list
2357 * activity can be necessary.
2360 stat(s
, FREE_FROZEN
);
2365 * was_frozen may have been set after we acquired the list_lock in
2366 * an earlier loop. So we need to check it here again.
2369 stat(s
, FREE_FROZEN
);
2371 if (unlikely(!inuse
&& n
->nr_partial
> s
->min_partial
))
2375 * Objects left in the slab. If it was not on the partial list before
2378 if (unlikely(!prior
)) {
2379 remove_full(s
, page
);
2380 add_partial(n
, page
, 0);
2381 stat(s
, FREE_ADD_PARTIAL
);
2384 spin_unlock_irqrestore(&n
->list_lock
, flags
);
2390 * Slab still on the partial list.
2392 remove_partial(n
, page
);
2393 stat(s
, FREE_REMOVE_PARTIAL
);
2396 spin_unlock_irqrestore(&n
->list_lock
, flags
);
2398 discard_slab(s
, page
);
2402 * Fastpath with forced inlining to produce a kfree and kmem_cache_free that
2403 * can perform fastpath freeing without additional function calls.
2405 * The fastpath is only possible if we are freeing to the current cpu slab
2406 * of this processor. This typically the case if we have just allocated
2409 * If fastpath is not possible then fall back to __slab_free where we deal
2410 * with all sorts of special processing.
2412 static __always_inline
void slab_free(struct kmem_cache
*s
,
2413 struct page
*page
, void *x
, unsigned long addr
)
2415 void **object
= (void *)x
;
2416 struct kmem_cache_cpu
*c
;
2419 slab_free_hook(s
, x
);
2424 * Determine the currently cpus per cpu slab.
2425 * The cpu may change afterward. However that does not matter since
2426 * data is retrieved via this pointer. If we are on the same cpu
2427 * during the cmpxchg then the free will succedd.
2429 c
= __this_cpu_ptr(s
->cpu_slab
);
2434 if (likely(page
== c
->page
)) {
2435 set_freepointer(s
, object
, c
->freelist
);
2437 if (unlikely(!irqsafe_cpu_cmpxchg_double(
2438 s
->cpu_slab
->freelist
, s
->cpu_slab
->tid
,
2440 object
, next_tid(tid
)))) {
2442 note_cmpxchg_failure("slab_free", s
, tid
);
2445 stat(s
, FREE_FASTPATH
);
2447 __slab_free(s
, page
, x
, addr
);
2451 void kmem_cache_free(struct kmem_cache
*s
, void *x
)
2455 page
= virt_to_head_page(x
);
2457 slab_free(s
, page
, x
, _RET_IP_
);
2459 trace_kmem_cache_free(_RET_IP_
, x
);
2461 EXPORT_SYMBOL(kmem_cache_free
);
2464 * Object placement in a slab is made very easy because we always start at
2465 * offset 0. If we tune the size of the object to the alignment then we can
2466 * get the required alignment by putting one properly sized object after
2469 * Notice that the allocation order determines the sizes of the per cpu
2470 * caches. Each processor has always one slab available for allocations.
2471 * Increasing the allocation order reduces the number of times that slabs
2472 * must be moved on and off the partial lists and is therefore a factor in
2477 * Mininum / Maximum order of slab pages. This influences locking overhead
2478 * and slab fragmentation. A higher order reduces the number of partial slabs
2479 * and increases the number of allocations possible without having to
2480 * take the list_lock.
2482 static int slub_min_order
;
2483 static int slub_max_order
= PAGE_ALLOC_COSTLY_ORDER
;
2484 static int slub_min_objects
;
2487 * Merge control. If this is set then no merging of slab caches will occur.
2488 * (Could be removed. This was introduced to pacify the merge skeptics.)
2490 static int slub_nomerge
;
2493 * Calculate the order of allocation given an slab object size.
2495 * The order of allocation has significant impact on performance and other
2496 * system components. Generally order 0 allocations should be preferred since
2497 * order 0 does not cause fragmentation in the page allocator. Larger objects
2498 * be problematic to put into order 0 slabs because there may be too much
2499 * unused space left. We go to a higher order if more than 1/16th of the slab
2502 * In order to reach satisfactory performance we must ensure that a minimum
2503 * number of objects is in one slab. Otherwise we may generate too much
2504 * activity on the partial lists which requires taking the list_lock. This is
2505 * less a concern for large slabs though which are rarely used.
2507 * slub_max_order specifies the order where we begin to stop considering the
2508 * number of objects in a slab as critical. If we reach slub_max_order then
2509 * we try to keep the page order as low as possible. So we accept more waste
2510 * of space in favor of a small page order.
2512 * Higher order allocations also allow the placement of more objects in a
2513 * slab and thereby reduce object handling overhead. If the user has
2514 * requested a higher mininum order then we start with that one instead of
2515 * the smallest order which will fit the object.
2517 static inline int slab_order(int size
, int min_objects
,
2518 int max_order
, int fract_leftover
, int reserved
)
2522 int min_order
= slub_min_order
;
2524 if (order_objects(min_order
, size
, reserved
) > MAX_OBJS_PER_PAGE
)
2525 return get_order(size
* MAX_OBJS_PER_PAGE
) - 1;
2527 for (order
= max(min_order
,
2528 fls(min_objects
* size
- 1) - PAGE_SHIFT
);
2529 order
<= max_order
; order
++) {
2531 unsigned long slab_size
= PAGE_SIZE
<< order
;
2533 if (slab_size
< min_objects
* size
+ reserved
)
2536 rem
= (slab_size
- reserved
) % size
;
2538 if (rem
<= slab_size
/ fract_leftover
)
2546 static inline int calculate_order(int size
, int reserved
)
2554 * Attempt to find best configuration for a slab. This
2555 * works by first attempting to generate a layout with
2556 * the best configuration and backing off gradually.
2558 * First we reduce the acceptable waste in a slab. Then
2559 * we reduce the minimum objects required in a slab.
2561 min_objects
= slub_min_objects
;
2563 min_objects
= 4 * (fls(nr_cpu_ids
) + 1);
2564 max_objects
= order_objects(slub_max_order
, size
, reserved
);
2565 min_objects
= min(min_objects
, max_objects
);
2567 while (min_objects
> 1) {
2569 while (fraction
>= 4) {
2570 order
= slab_order(size
, min_objects
,
2571 slub_max_order
, fraction
, reserved
);
2572 if (order
<= slub_max_order
)
2580 * We were unable to place multiple objects in a slab. Now
2581 * lets see if we can place a single object there.
2583 order
= slab_order(size
, 1, slub_max_order
, 1, reserved
);
2584 if (order
<= slub_max_order
)
2588 * Doh this slab cannot be placed using slub_max_order.
2590 order
= slab_order(size
, 1, MAX_ORDER
, 1, reserved
);
2591 if (order
< MAX_ORDER
)
2597 * Figure out what the alignment of the objects will be.
2599 static unsigned long calculate_alignment(unsigned long flags
,
2600 unsigned long align
, unsigned long size
)
2603 * If the user wants hardware cache aligned objects then follow that
2604 * suggestion if the object is sufficiently large.
2606 * The hardware cache alignment cannot override the specified
2607 * alignment though. If that is greater then use it.
2609 if (flags
& SLAB_HWCACHE_ALIGN
) {
2610 unsigned long ralign
= cache_line_size();
2611 while (size
<= ralign
/ 2)
2613 align
= max(align
, ralign
);
2616 if (align
< ARCH_SLAB_MINALIGN
)
2617 align
= ARCH_SLAB_MINALIGN
;
2619 return ALIGN(align
, sizeof(void *));
2623 init_kmem_cache_node(struct kmem_cache_node
*n
, struct kmem_cache
*s
)
2626 spin_lock_init(&n
->list_lock
);
2627 INIT_LIST_HEAD(&n
->partial
);
2628 #ifdef CONFIG_SLUB_DEBUG
2629 atomic_long_set(&n
->nr_slabs
, 0);
2630 atomic_long_set(&n
->total_objects
, 0);
2631 INIT_LIST_HEAD(&n
->full
);
2635 static inline int alloc_kmem_cache_cpus(struct kmem_cache
*s
)
2637 BUILD_BUG_ON(PERCPU_DYNAMIC_EARLY_SIZE
<
2638 SLUB_PAGE_SHIFT
* sizeof(struct kmem_cache_cpu
));
2641 * Must align to double word boundary for the double cmpxchg
2642 * instructions to work; see __pcpu_double_call_return_bool().
2644 s
->cpu_slab
= __alloc_percpu(sizeof(struct kmem_cache_cpu
),
2645 2 * sizeof(void *));
2650 init_kmem_cache_cpus(s
);
2655 static struct kmem_cache
*kmem_cache_node
;
2658 * No kmalloc_node yet so do it by hand. We know that this is the first
2659 * slab on the node for this slabcache. There are no concurrent accesses
2662 * Note that this function only works on the kmalloc_node_cache
2663 * when allocating for the kmalloc_node_cache. This is used for bootstrapping
2664 * memory on a fresh node that has no slab structures yet.
2666 static void early_kmem_cache_node_alloc(int node
)
2669 struct kmem_cache_node
*n
;
2671 BUG_ON(kmem_cache_node
->size
< sizeof(struct kmem_cache_node
));
2673 page
= new_slab(kmem_cache_node
, GFP_NOWAIT
, node
);
2676 if (page_to_nid(page
) != node
) {
2677 printk(KERN_ERR
"SLUB: Unable to allocate memory from "
2679 printk(KERN_ERR
"SLUB: Allocating a useless per node structure "
2680 "in order to be able to continue\n");
2685 page
->freelist
= get_freepointer(kmem_cache_node
, n
);
2688 kmem_cache_node
->node
[node
] = n
;
2689 #ifdef CONFIG_SLUB_DEBUG
2690 init_object(kmem_cache_node
, n
, SLUB_RED_ACTIVE
);
2691 init_tracking(kmem_cache_node
, n
);
2693 init_kmem_cache_node(n
, kmem_cache_node
);
2694 inc_slabs_node(kmem_cache_node
, node
, page
->objects
);
2696 add_partial(n
, page
, 0);
2699 static void free_kmem_cache_nodes(struct kmem_cache
*s
)
2703 for_each_node_state(node
, N_NORMAL_MEMORY
) {
2704 struct kmem_cache_node
*n
= s
->node
[node
];
2707 kmem_cache_free(kmem_cache_node
, n
);
2709 s
->node
[node
] = NULL
;
2713 static int init_kmem_cache_nodes(struct kmem_cache
*s
)
2717 for_each_node_state(node
, N_NORMAL_MEMORY
) {
2718 struct kmem_cache_node
*n
;
2720 if (slab_state
== DOWN
) {
2721 early_kmem_cache_node_alloc(node
);
2724 n
= kmem_cache_alloc_node(kmem_cache_node
,
2728 free_kmem_cache_nodes(s
);
2733 init_kmem_cache_node(n
, s
);
2738 static void set_min_partial(struct kmem_cache
*s
, unsigned long min
)
2740 if (min
< MIN_PARTIAL
)
2742 else if (min
> MAX_PARTIAL
)
2744 s
->min_partial
= min
;
2748 * calculate_sizes() determines the order and the distribution of data within
2751 static int calculate_sizes(struct kmem_cache
*s
, int forced_order
)
2753 unsigned long flags
= s
->flags
;
2754 unsigned long size
= s
->objsize
;
2755 unsigned long align
= s
->align
;
2759 * Round up object size to the next word boundary. We can only
2760 * place the free pointer at word boundaries and this determines
2761 * the possible location of the free pointer.
2763 size
= ALIGN(size
, sizeof(void *));
2765 #ifdef CONFIG_SLUB_DEBUG
2767 * Determine if we can poison the object itself. If the user of
2768 * the slab may touch the object after free or before allocation
2769 * then we should never poison the object itself.
2771 if ((flags
& SLAB_POISON
) && !(flags
& SLAB_DESTROY_BY_RCU
) &&
2773 s
->flags
|= __OBJECT_POISON
;
2775 s
->flags
&= ~__OBJECT_POISON
;
2779 * If we are Redzoning then check if there is some space between the
2780 * end of the object and the free pointer. If not then add an
2781 * additional word to have some bytes to store Redzone information.
2783 if ((flags
& SLAB_RED_ZONE
) && size
== s
->objsize
)
2784 size
+= sizeof(void *);
2788 * With that we have determined the number of bytes in actual use
2789 * by the object. This is the potential offset to the free pointer.
2793 if (((flags
& (SLAB_DESTROY_BY_RCU
| SLAB_POISON
)) ||
2796 * Relocate free pointer after the object if it is not
2797 * permitted to overwrite the first word of the object on
2800 * This is the case if we do RCU, have a constructor or
2801 * destructor or are poisoning the objects.
2804 size
+= sizeof(void *);
2807 #ifdef CONFIG_SLUB_DEBUG
2808 if (flags
& SLAB_STORE_USER
)
2810 * Need to store information about allocs and frees after
2813 size
+= 2 * sizeof(struct track
);
2815 if (flags
& SLAB_RED_ZONE
)
2817 * Add some empty padding so that we can catch
2818 * overwrites from earlier objects rather than let
2819 * tracking information or the free pointer be
2820 * corrupted if a user writes before the start
2823 size
+= sizeof(void *);
2827 * Determine the alignment based on various parameters that the
2828 * user specified and the dynamic determination of cache line size
2831 align
= calculate_alignment(flags
, align
, s
->objsize
);
2835 * SLUB stores one object immediately after another beginning from
2836 * offset 0. In order to align the objects we have to simply size
2837 * each object to conform to the alignment.
2839 size
= ALIGN(size
, align
);
2841 if (forced_order
>= 0)
2842 order
= forced_order
;
2844 order
= calculate_order(size
, s
->reserved
);
2851 s
->allocflags
|= __GFP_COMP
;
2853 if (s
->flags
& SLAB_CACHE_DMA
)
2854 s
->allocflags
|= SLUB_DMA
;
2856 if (s
->flags
& SLAB_RECLAIM_ACCOUNT
)
2857 s
->allocflags
|= __GFP_RECLAIMABLE
;
2860 * Determine the number of objects per slab
2862 s
->oo
= oo_make(order
, size
, s
->reserved
);
2863 s
->min
= oo_make(get_order(size
), size
, s
->reserved
);
2864 if (oo_objects(s
->oo
) > oo_objects(s
->max
))
2867 return !!oo_objects(s
->oo
);
2871 static int kmem_cache_open(struct kmem_cache
*s
,
2872 const char *name
, size_t size
,
2873 size_t align
, unsigned long flags
,
2874 void (*ctor
)(void *))
2876 memset(s
, 0, kmem_size
);
2881 s
->flags
= kmem_cache_flags(size
, flags
, name
, ctor
);
2884 if (need_reserve_slab_rcu
&& (s
->flags
& SLAB_DESTROY_BY_RCU
))
2885 s
->reserved
= sizeof(struct rcu_head
);
2887 if (!calculate_sizes(s
, -1))
2889 if (disable_higher_order_debug
) {
2891 * Disable debugging flags that store metadata if the min slab
2894 if (get_order(s
->size
) > get_order(s
->objsize
)) {
2895 s
->flags
&= ~DEBUG_METADATA_FLAGS
;
2897 if (!calculate_sizes(s
, -1))
2902 #ifdef CONFIG_CMPXCHG_DOUBLE
2903 if (system_has_cmpxchg_double() && (s
->flags
& SLAB_DEBUG_FLAGS
) == 0)
2904 /* Enable fast mode */
2905 s
->flags
|= __CMPXCHG_DOUBLE
;
2909 * The larger the object size is, the more pages we want on the partial
2910 * list to avoid pounding the page allocator excessively.
2912 set_min_partial(s
, ilog2(s
->size
));
2915 s
->remote_node_defrag_ratio
= 1000;
2917 if (!init_kmem_cache_nodes(s
))
2920 if (alloc_kmem_cache_cpus(s
))
2923 free_kmem_cache_nodes(s
);
2925 if (flags
& SLAB_PANIC
)
2926 panic("Cannot create slab %s size=%lu realsize=%u "
2927 "order=%u offset=%u flags=%lx\n",
2928 s
->name
, (unsigned long)size
, s
->size
, oo_order(s
->oo
),
2934 * Determine the size of a slab object
2936 unsigned int kmem_cache_size(struct kmem_cache
*s
)
2940 EXPORT_SYMBOL(kmem_cache_size
);
2942 static void list_slab_objects(struct kmem_cache
*s
, struct page
*page
,
2945 #ifdef CONFIG_SLUB_DEBUG
2946 void *addr
= page_address(page
);
2948 unsigned long *map
= kzalloc(BITS_TO_LONGS(page
->objects
) *
2949 sizeof(long), GFP_ATOMIC
);
2952 slab_err(s
, page
, "%s", text
);
2955 get_map(s
, page
, map
);
2956 for_each_object(p
, s
, addr
, page
->objects
) {
2958 if (!test_bit(slab_index(p
, s
, addr
), map
)) {
2959 printk(KERN_ERR
"INFO: Object 0x%p @offset=%tu\n",
2961 print_tracking(s
, p
);
2970 * Attempt to free all partial slabs on a node.
2972 static void free_partial(struct kmem_cache
*s
, struct kmem_cache_node
*n
)
2974 unsigned long flags
;
2975 struct page
*page
, *h
;
2977 spin_lock_irqsave(&n
->list_lock
, flags
);
2978 list_for_each_entry_safe(page
, h
, &n
->partial
, lru
) {
2980 remove_partial(n
, page
);
2981 discard_slab(s
, page
);
2983 list_slab_objects(s
, page
,
2984 "Objects remaining on kmem_cache_close()");
2987 spin_unlock_irqrestore(&n
->list_lock
, flags
);
2991 * Release all resources used by a slab cache.
2993 static inline int kmem_cache_close(struct kmem_cache
*s
)
2998 free_percpu(s
->cpu_slab
);
2999 /* Attempt to free all objects */
3000 for_each_node_state(node
, N_NORMAL_MEMORY
) {
3001 struct kmem_cache_node
*n
= get_node(s
, node
);
3004 if (n
->nr_partial
|| slabs_node(s
, node
))
3007 free_kmem_cache_nodes(s
);
3012 * Close a cache and release the kmem_cache structure
3013 * (must be used for caches created using kmem_cache_create)
3015 void kmem_cache_destroy(struct kmem_cache
*s
)
3017 down_write(&slub_lock
);
3021 if (kmem_cache_close(s
)) {
3022 printk(KERN_ERR
"SLUB %s: %s called for cache that "
3023 "still has objects.\n", s
->name
, __func__
);
3026 if (s
->flags
& SLAB_DESTROY_BY_RCU
)
3028 sysfs_slab_remove(s
);
3030 up_write(&slub_lock
);
3032 EXPORT_SYMBOL(kmem_cache_destroy
);
3034 /********************************************************************
3036 *******************************************************************/
3038 struct kmem_cache
*kmalloc_caches
[SLUB_PAGE_SHIFT
];
3039 EXPORT_SYMBOL(kmalloc_caches
);
3041 static struct kmem_cache
*kmem_cache
;
3043 #ifdef CONFIG_ZONE_DMA
3044 static struct kmem_cache
*kmalloc_dma_caches
[SLUB_PAGE_SHIFT
];
3047 static int __init
setup_slub_min_order(char *str
)
3049 get_option(&str
, &slub_min_order
);
3054 __setup("slub_min_order=", setup_slub_min_order
);
3056 static int __init
setup_slub_max_order(char *str
)
3058 get_option(&str
, &slub_max_order
);
3059 slub_max_order
= min(slub_max_order
, MAX_ORDER
- 1);
3064 __setup("slub_max_order=", setup_slub_max_order
);
3066 static int __init
setup_slub_min_objects(char *str
)
3068 get_option(&str
, &slub_min_objects
);
3073 __setup("slub_min_objects=", setup_slub_min_objects
);
3075 static int __init
setup_slub_nomerge(char *str
)
3081 __setup("slub_nomerge", setup_slub_nomerge
);
3083 static struct kmem_cache
*__init
create_kmalloc_cache(const char *name
,
3084 int size
, unsigned int flags
)
3086 struct kmem_cache
*s
;
3088 s
= kmem_cache_alloc(kmem_cache
, GFP_NOWAIT
);
3091 * This function is called with IRQs disabled during early-boot on
3092 * single CPU so there's no need to take slub_lock here.
3094 if (!kmem_cache_open(s
, name
, size
, ARCH_KMALLOC_MINALIGN
,
3098 list_add(&s
->list
, &slab_caches
);
3102 panic("Creation of kmalloc slab %s size=%d failed.\n", name
, size
);
3107 * Conversion table for small slabs sizes / 8 to the index in the
3108 * kmalloc array. This is necessary for slabs < 192 since we have non power
3109 * of two cache sizes there. The size of larger slabs can be determined using
3112 static s8 size_index
[24] = {
3139 static inline int size_index_elem(size_t bytes
)
3141 return (bytes
- 1) / 8;
3144 static struct kmem_cache
*get_slab(size_t size
, gfp_t flags
)
3150 return ZERO_SIZE_PTR
;
3152 index
= size_index
[size_index_elem(size
)];
3154 index
= fls(size
- 1);
3156 #ifdef CONFIG_ZONE_DMA
3157 if (unlikely((flags
& SLUB_DMA
)))
3158 return kmalloc_dma_caches
[index
];
3161 return kmalloc_caches
[index
];
3164 void *__kmalloc(size_t size
, gfp_t flags
)
3166 struct kmem_cache
*s
;
3169 if (unlikely(size
> SLUB_MAX_SIZE
))
3170 return kmalloc_large(size
, flags
);
3172 s
= get_slab(size
, flags
);
3174 if (unlikely(ZERO_OR_NULL_PTR(s
)))
3177 ret
= slab_alloc(s
, flags
, NUMA_NO_NODE
, _RET_IP_
);
3179 trace_kmalloc(_RET_IP_
, ret
, size
, s
->size
, flags
);
3183 EXPORT_SYMBOL(__kmalloc
);
3186 static void *kmalloc_large_node(size_t size
, gfp_t flags
, int node
)
3191 flags
|= __GFP_COMP
| __GFP_NOTRACK
;
3192 page
= alloc_pages_node(node
, flags
, get_order(size
));
3194 ptr
= page_address(page
);
3196 kmemleak_alloc(ptr
, size
, 1, flags
);
3200 void *__kmalloc_node(size_t size
, gfp_t flags
, int node
)
3202 struct kmem_cache
*s
;
3205 if (unlikely(size
> SLUB_MAX_SIZE
)) {
3206 ret
= kmalloc_large_node(size
, flags
, node
);
3208 trace_kmalloc_node(_RET_IP_
, ret
,
3209 size
, PAGE_SIZE
<< get_order(size
),
3215 s
= get_slab(size
, flags
);
3217 if (unlikely(ZERO_OR_NULL_PTR(s
)))
3220 ret
= slab_alloc(s
, flags
, node
, _RET_IP_
);
3222 trace_kmalloc_node(_RET_IP_
, ret
, size
, s
->size
, flags
, node
);
3226 EXPORT_SYMBOL(__kmalloc_node
);
3229 size_t ksize(const void *object
)
3233 if (unlikely(object
== ZERO_SIZE_PTR
))
3236 page
= virt_to_head_page(object
);
3238 if (unlikely(!PageSlab(page
))) {
3239 WARN_ON(!PageCompound(page
));
3240 return PAGE_SIZE
<< compound_order(page
);
3243 return slab_ksize(page
->slab
);
3245 EXPORT_SYMBOL(ksize
);
3247 #ifdef CONFIG_SLUB_DEBUG
3248 bool verify_mem_not_deleted(const void *x
)
3251 void *object
= (void *)x
;
3252 unsigned long flags
;
3255 if (unlikely(ZERO_OR_NULL_PTR(x
)))
3258 local_irq_save(flags
);
3260 page
= virt_to_head_page(x
);
3261 if (unlikely(!PageSlab(page
))) {
3262 /* maybe it was from stack? */
3268 if (on_freelist(page
->slab
, page
, object
)) {
3269 object_err(page
->slab
, page
, object
, "Object is on free-list");
3277 local_irq_restore(flags
);
3280 EXPORT_SYMBOL(verify_mem_not_deleted
);
3283 void kfree(const void *x
)
3286 void *object
= (void *)x
;
3288 trace_kfree(_RET_IP_
, x
);
3290 if (unlikely(ZERO_OR_NULL_PTR(x
)))
3293 page
= virt_to_head_page(x
);
3294 if (unlikely(!PageSlab(page
))) {
3295 BUG_ON(!PageCompound(page
));
3300 slab_free(page
->slab
, page
, object
, _RET_IP_
);
3302 EXPORT_SYMBOL(kfree
);
3305 * kmem_cache_shrink removes empty slabs from the partial lists and sorts
3306 * the remaining slabs by the number of items in use. The slabs with the
3307 * most items in use come first. New allocations will then fill those up
3308 * and thus they can be removed from the partial lists.
3310 * The slabs with the least items are placed last. This results in them
3311 * being allocated from last increasing the chance that the last objects
3312 * are freed in them.
3314 int kmem_cache_shrink(struct kmem_cache
*s
)
3318 struct kmem_cache_node
*n
;
3321 int objects
= oo_objects(s
->max
);
3322 struct list_head
*slabs_by_inuse
=
3323 kmalloc(sizeof(struct list_head
) * objects
, GFP_KERNEL
);
3324 unsigned long flags
;
3326 if (!slabs_by_inuse
)
3330 for_each_node_state(node
, N_NORMAL_MEMORY
) {
3331 n
= get_node(s
, node
);
3336 for (i
= 0; i
< objects
; i
++)
3337 INIT_LIST_HEAD(slabs_by_inuse
+ i
);
3339 spin_lock_irqsave(&n
->list_lock
, flags
);
3342 * Build lists indexed by the items in use in each slab.
3344 * Note that concurrent frees may occur while we hold the
3345 * list_lock. page->inuse here is the upper limit.
3347 list_for_each_entry_safe(page
, t
, &n
->partial
, lru
) {
3349 remove_partial(n
, page
);
3350 discard_slab(s
, page
);
3352 list_move(&page
->lru
,
3353 slabs_by_inuse
+ page
->inuse
);
3358 * Rebuild the partial list with the slabs filled up most
3359 * first and the least used slabs at the end.
3361 for (i
= objects
- 1; i
>= 0; i
--)
3362 list_splice(slabs_by_inuse
+ i
, n
->partial
.prev
);
3364 spin_unlock_irqrestore(&n
->list_lock
, flags
);
3367 kfree(slabs_by_inuse
);
3370 EXPORT_SYMBOL(kmem_cache_shrink
);
3372 #if defined(CONFIG_MEMORY_HOTPLUG)
3373 static int slab_mem_going_offline_callback(void *arg
)
3375 struct kmem_cache
*s
;
3377 down_read(&slub_lock
);
3378 list_for_each_entry(s
, &slab_caches
, list
)
3379 kmem_cache_shrink(s
);
3380 up_read(&slub_lock
);
3385 static void slab_mem_offline_callback(void *arg
)
3387 struct kmem_cache_node
*n
;
3388 struct kmem_cache
*s
;
3389 struct memory_notify
*marg
= arg
;
3392 offline_node
= marg
->status_change_nid
;
3395 * If the node still has available memory. we need kmem_cache_node
3398 if (offline_node
< 0)
3401 down_read(&slub_lock
);
3402 list_for_each_entry(s
, &slab_caches
, list
) {
3403 n
= get_node(s
, offline_node
);
3406 * if n->nr_slabs > 0, slabs still exist on the node
3407 * that is going down. We were unable to free them,
3408 * and offline_pages() function shouldn't call this
3409 * callback. So, we must fail.
3411 BUG_ON(slabs_node(s
, offline_node
));
3413 s
->node
[offline_node
] = NULL
;
3414 kmem_cache_free(kmem_cache_node
, n
);
3417 up_read(&slub_lock
);
3420 static int slab_mem_going_online_callback(void *arg
)
3422 struct kmem_cache_node
*n
;
3423 struct kmem_cache
*s
;
3424 struct memory_notify
*marg
= arg
;
3425 int nid
= marg
->status_change_nid
;
3429 * If the node's memory is already available, then kmem_cache_node is
3430 * already created. Nothing to do.
3436 * We are bringing a node online. No memory is available yet. We must
3437 * allocate a kmem_cache_node structure in order to bring the node
3440 down_read(&slub_lock
);
3441 list_for_each_entry(s
, &slab_caches
, list
) {
3443 * XXX: kmem_cache_alloc_node will fallback to other nodes
3444 * since memory is not yet available from the node that
3447 n
= kmem_cache_alloc(kmem_cache_node
, GFP_KERNEL
);
3452 init_kmem_cache_node(n
, s
);
3456 up_read(&slub_lock
);
3460 static int slab_memory_callback(struct notifier_block
*self
,
3461 unsigned long action
, void *arg
)
3466 case MEM_GOING_ONLINE
:
3467 ret
= slab_mem_going_online_callback(arg
);
3469 case MEM_GOING_OFFLINE
:
3470 ret
= slab_mem_going_offline_callback(arg
);
3473 case MEM_CANCEL_ONLINE
:
3474 slab_mem_offline_callback(arg
);
3477 case MEM_CANCEL_OFFLINE
:
3481 ret
= notifier_from_errno(ret
);
3487 #endif /* CONFIG_MEMORY_HOTPLUG */
3489 /********************************************************************
3490 * Basic setup of slabs
3491 *******************************************************************/
3494 * Used for early kmem_cache structures that were allocated using
3495 * the page allocator
3498 static void __init
kmem_cache_bootstrap_fixup(struct kmem_cache
*s
)
3502 list_add(&s
->list
, &slab_caches
);
3505 for_each_node_state(node
, N_NORMAL_MEMORY
) {
3506 struct kmem_cache_node
*n
= get_node(s
, node
);
3510 list_for_each_entry(p
, &n
->partial
, lru
)
3513 #ifdef CONFIG_SLUB_DEBUG
3514 list_for_each_entry(p
, &n
->full
, lru
)
3521 void __init
kmem_cache_init(void)
3525 struct kmem_cache
*temp_kmem_cache
;
3527 struct kmem_cache
*temp_kmem_cache_node
;
3528 unsigned long kmalloc_size
;
3530 kmem_size
= offsetof(struct kmem_cache
, node
) +
3531 nr_node_ids
* sizeof(struct kmem_cache_node
*);
3533 /* Allocate two kmem_caches from the page allocator */
3534 kmalloc_size
= ALIGN(kmem_size
, cache_line_size());
3535 order
= get_order(2 * kmalloc_size
);
3536 kmem_cache
= (void *)__get_free_pages(GFP_NOWAIT
, order
);
3539 * Must first have the slab cache available for the allocations of the
3540 * struct kmem_cache_node's. There is special bootstrap code in
3541 * kmem_cache_open for slab_state == DOWN.
3543 kmem_cache_node
= (void *)kmem_cache
+ kmalloc_size
;
3545 kmem_cache_open(kmem_cache_node
, "kmem_cache_node",
3546 sizeof(struct kmem_cache_node
),
3547 0, SLAB_HWCACHE_ALIGN
| SLAB_PANIC
, NULL
);
3549 hotplug_memory_notifier(slab_memory_callback
, SLAB_CALLBACK_PRI
);
3551 /* Able to allocate the per node structures */
3552 slab_state
= PARTIAL
;
3554 temp_kmem_cache
= kmem_cache
;
3555 kmem_cache_open(kmem_cache
, "kmem_cache", kmem_size
,
3556 0, SLAB_HWCACHE_ALIGN
| SLAB_PANIC
, NULL
);
3557 kmem_cache
= kmem_cache_alloc(kmem_cache
, GFP_NOWAIT
);
3558 memcpy(kmem_cache
, temp_kmem_cache
, kmem_size
);
3561 * Allocate kmem_cache_node properly from the kmem_cache slab.
3562 * kmem_cache_node is separately allocated so no need to
3563 * update any list pointers.
3565 temp_kmem_cache_node
= kmem_cache_node
;
3567 kmem_cache_node
= kmem_cache_alloc(kmem_cache
, GFP_NOWAIT
);
3568 memcpy(kmem_cache_node
, temp_kmem_cache_node
, kmem_size
);
3570 kmem_cache_bootstrap_fixup(kmem_cache_node
);
3573 kmem_cache_bootstrap_fixup(kmem_cache
);
3575 /* Free temporary boot structure */
3576 free_pages((unsigned long)temp_kmem_cache
, order
);
3578 /* Now we can use the kmem_cache to allocate kmalloc slabs */
3581 * Patch up the size_index table if we have strange large alignment
3582 * requirements for the kmalloc array. This is only the case for
3583 * MIPS it seems. The standard arches will not generate any code here.
3585 * Largest permitted alignment is 256 bytes due to the way we
3586 * handle the index determination for the smaller caches.
3588 * Make sure that nothing crazy happens if someone starts tinkering
3589 * around with ARCH_KMALLOC_MINALIGN
3591 BUILD_BUG_ON(KMALLOC_MIN_SIZE
> 256 ||
3592 (KMALLOC_MIN_SIZE
& (KMALLOC_MIN_SIZE
- 1)));
3594 for (i
= 8; i
< KMALLOC_MIN_SIZE
; i
+= 8) {
3595 int elem
= size_index_elem(i
);
3596 if (elem
>= ARRAY_SIZE(size_index
))
3598 size_index
[elem
] = KMALLOC_SHIFT_LOW
;
3601 if (KMALLOC_MIN_SIZE
== 64) {
3603 * The 96 byte size cache is not used if the alignment
3606 for (i
= 64 + 8; i
<= 96; i
+= 8)
3607 size_index
[size_index_elem(i
)] = 7;
3608 } else if (KMALLOC_MIN_SIZE
== 128) {
3610 * The 192 byte sized cache is not used if the alignment
3611 * is 128 byte. Redirect kmalloc to use the 256 byte cache
3614 for (i
= 128 + 8; i
<= 192; i
+= 8)
3615 size_index
[size_index_elem(i
)] = 8;
3618 /* Caches that are not of the two-to-the-power-of size */
3619 if (KMALLOC_MIN_SIZE
<= 32) {
3620 kmalloc_caches
[1] = create_kmalloc_cache("kmalloc-96", 96, 0);
3624 if (KMALLOC_MIN_SIZE
<= 64) {
3625 kmalloc_caches
[2] = create_kmalloc_cache("kmalloc-192", 192, 0);
3629 for (i
= KMALLOC_SHIFT_LOW
; i
< SLUB_PAGE_SHIFT
; i
++) {
3630 kmalloc_caches
[i
] = create_kmalloc_cache("kmalloc", 1 << i
, 0);
3636 /* Provide the correct kmalloc names now that the caches are up */
3637 if (KMALLOC_MIN_SIZE
<= 32) {
3638 kmalloc_caches
[1]->name
= kstrdup(kmalloc_caches
[1]->name
, GFP_NOWAIT
);
3639 BUG_ON(!kmalloc_caches
[1]->name
);
3642 if (KMALLOC_MIN_SIZE
<= 64) {
3643 kmalloc_caches
[2]->name
= kstrdup(kmalloc_caches
[2]->name
, GFP_NOWAIT
);
3644 BUG_ON(!kmalloc_caches
[2]->name
);
3647 for (i
= KMALLOC_SHIFT_LOW
; i
< SLUB_PAGE_SHIFT
; i
++) {
3648 char *s
= kasprintf(GFP_NOWAIT
, "kmalloc-%d", 1 << i
);
3651 kmalloc_caches
[i
]->name
= s
;
3655 register_cpu_notifier(&slab_notifier
);
3658 #ifdef CONFIG_ZONE_DMA
3659 for (i
= 0; i
< SLUB_PAGE_SHIFT
; i
++) {
3660 struct kmem_cache
*s
= kmalloc_caches
[i
];
3663 char *name
= kasprintf(GFP_NOWAIT
,
3664 "dma-kmalloc-%d", s
->objsize
);
3667 kmalloc_dma_caches
[i
] = create_kmalloc_cache(name
,
3668 s
->objsize
, SLAB_CACHE_DMA
);
3673 "SLUB: Genslabs=%d, HWalign=%d, Order=%d-%d, MinObjects=%d,"
3674 " CPUs=%d, Nodes=%d\n",
3675 caches
, cache_line_size(),
3676 slub_min_order
, slub_max_order
, slub_min_objects
,
3677 nr_cpu_ids
, nr_node_ids
);
3680 void __init
kmem_cache_init_late(void)
3685 * Find a mergeable slab cache
3687 static int slab_unmergeable(struct kmem_cache
*s
)
3689 if (slub_nomerge
|| (s
->flags
& SLUB_NEVER_MERGE
))
3696 * We may have set a slab to be unmergeable during bootstrap.
3698 if (s
->refcount
< 0)
3704 static struct kmem_cache
*find_mergeable(size_t size
,
3705 size_t align
, unsigned long flags
, const char *name
,
3706 void (*ctor
)(void *))
3708 struct kmem_cache
*s
;
3710 if (slub_nomerge
|| (flags
& SLUB_NEVER_MERGE
))
3716 size
= ALIGN(size
, sizeof(void *));
3717 align
= calculate_alignment(flags
, align
, size
);
3718 size
= ALIGN(size
, align
);
3719 flags
= kmem_cache_flags(size
, flags
, name
, NULL
);
3721 list_for_each_entry(s
, &slab_caches
, list
) {
3722 if (slab_unmergeable(s
))
3728 if ((flags
& SLUB_MERGE_SAME
) != (s
->flags
& SLUB_MERGE_SAME
))
3731 * Check if alignment is compatible.
3732 * Courtesy of Adrian Drzewiecki
3734 if ((s
->size
& ~(align
- 1)) != s
->size
)
3737 if (s
->size
- size
>= sizeof(void *))
3745 struct kmem_cache
*kmem_cache_create(const char *name
, size_t size
,
3746 size_t align
, unsigned long flags
, void (*ctor
)(void *))
3748 struct kmem_cache
*s
;
3754 down_write(&slub_lock
);
3755 s
= find_mergeable(size
, align
, flags
, name
, ctor
);
3759 * Adjust the object sizes so that we clear
3760 * the complete object on kzalloc.
3762 s
->objsize
= max(s
->objsize
, (int)size
);
3763 s
->inuse
= max_t(int, s
->inuse
, ALIGN(size
, sizeof(void *)));
3765 if (sysfs_slab_alias(s
, name
)) {
3769 up_write(&slub_lock
);
3773 n
= kstrdup(name
, GFP_KERNEL
);
3777 s
= kmalloc(kmem_size
, GFP_KERNEL
);
3779 if (kmem_cache_open(s
, n
,
3780 size
, align
, flags
, ctor
)) {
3781 list_add(&s
->list
, &slab_caches
);
3782 if (sysfs_slab_add(s
)) {
3788 up_write(&slub_lock
);
3795 up_write(&slub_lock
);
3797 if (flags
& SLAB_PANIC
)
3798 panic("Cannot create slabcache %s\n", name
);
3803 EXPORT_SYMBOL(kmem_cache_create
);
3807 * Use the cpu notifier to insure that the cpu slabs are flushed when
3810 static int __cpuinit
slab_cpuup_callback(struct notifier_block
*nfb
,
3811 unsigned long action
, void *hcpu
)
3813 long cpu
= (long)hcpu
;
3814 struct kmem_cache
*s
;
3815 unsigned long flags
;
3818 case CPU_UP_CANCELED
:
3819 case CPU_UP_CANCELED_FROZEN
:
3821 case CPU_DEAD_FROZEN
:
3822 down_read(&slub_lock
);
3823 list_for_each_entry(s
, &slab_caches
, list
) {
3824 local_irq_save(flags
);
3825 __flush_cpu_slab(s
, cpu
);
3826 local_irq_restore(flags
);
3828 up_read(&slub_lock
);
3836 static struct notifier_block __cpuinitdata slab_notifier
= {
3837 .notifier_call
= slab_cpuup_callback
3842 void *__kmalloc_track_caller(size_t size
, gfp_t gfpflags
, unsigned long caller
)
3844 struct kmem_cache
*s
;
3847 if (unlikely(size
> SLUB_MAX_SIZE
))
3848 return kmalloc_large(size
, gfpflags
);
3850 s
= get_slab(size
, gfpflags
);
3852 if (unlikely(ZERO_OR_NULL_PTR(s
)))
3855 ret
= slab_alloc(s
, gfpflags
, NUMA_NO_NODE
, caller
);
3857 /* Honor the call site pointer we received. */
3858 trace_kmalloc(caller
, ret
, size
, s
->size
, gfpflags
);
3864 void *__kmalloc_node_track_caller(size_t size
, gfp_t gfpflags
,
3865 int node
, unsigned long caller
)
3867 struct kmem_cache
*s
;
3870 if (unlikely(size
> SLUB_MAX_SIZE
)) {
3871 ret
= kmalloc_large_node(size
, gfpflags
, node
);
3873 trace_kmalloc_node(caller
, ret
,
3874 size
, PAGE_SIZE
<< get_order(size
),
3880 s
= get_slab(size
, gfpflags
);
3882 if (unlikely(ZERO_OR_NULL_PTR(s
)))
3885 ret
= slab_alloc(s
, gfpflags
, node
, caller
);
3887 /* Honor the call site pointer we received. */
3888 trace_kmalloc_node(caller
, ret
, size
, s
->size
, gfpflags
, node
);
3895 static int count_inuse(struct page
*page
)
3900 static int count_total(struct page
*page
)
3902 return page
->objects
;
3906 #ifdef CONFIG_SLUB_DEBUG
3907 static int validate_slab(struct kmem_cache
*s
, struct page
*page
,
3911 void *addr
= page_address(page
);
3913 if (!check_slab(s
, page
) ||
3914 !on_freelist(s
, page
, NULL
))
3917 /* Now we know that a valid freelist exists */
3918 bitmap_zero(map
, page
->objects
);
3920 get_map(s
, page
, map
);
3921 for_each_object(p
, s
, addr
, page
->objects
) {
3922 if (test_bit(slab_index(p
, s
, addr
), map
))
3923 if (!check_object(s
, page
, p
, SLUB_RED_INACTIVE
))
3927 for_each_object(p
, s
, addr
, page
->objects
)
3928 if (!test_bit(slab_index(p
, s
, addr
), map
))
3929 if (!check_object(s
, page
, p
, SLUB_RED_ACTIVE
))
3934 static void validate_slab_slab(struct kmem_cache
*s
, struct page
*page
,
3938 validate_slab(s
, page
, map
);
3942 static int validate_slab_node(struct kmem_cache
*s
,
3943 struct kmem_cache_node
*n
, unsigned long *map
)
3945 unsigned long count
= 0;
3947 unsigned long flags
;
3949 spin_lock_irqsave(&n
->list_lock
, flags
);
3951 list_for_each_entry(page
, &n
->partial
, lru
) {
3952 validate_slab_slab(s
, page
, map
);
3955 if (count
!= n
->nr_partial
)
3956 printk(KERN_ERR
"SLUB %s: %ld partial slabs counted but "
3957 "counter=%ld\n", s
->name
, count
, n
->nr_partial
);
3959 if (!(s
->flags
& SLAB_STORE_USER
))
3962 list_for_each_entry(page
, &n
->full
, lru
) {
3963 validate_slab_slab(s
, page
, map
);
3966 if (count
!= atomic_long_read(&n
->nr_slabs
))
3967 printk(KERN_ERR
"SLUB: %s %ld slabs counted but "
3968 "counter=%ld\n", s
->name
, count
,
3969 atomic_long_read(&n
->nr_slabs
));
3972 spin_unlock_irqrestore(&n
->list_lock
, flags
);
3976 static long validate_slab_cache(struct kmem_cache
*s
)
3979 unsigned long count
= 0;
3980 unsigned long *map
= kmalloc(BITS_TO_LONGS(oo_objects(s
->max
)) *
3981 sizeof(unsigned long), GFP_KERNEL
);
3987 for_each_node_state(node
, N_NORMAL_MEMORY
) {
3988 struct kmem_cache_node
*n
= get_node(s
, node
);
3990 count
+= validate_slab_node(s
, n
, map
);
3996 * Generate lists of code addresses where slabcache objects are allocated
4001 unsigned long count
;
4008 DECLARE_BITMAP(cpus
, NR_CPUS
);
4014 unsigned long count
;
4015 struct location
*loc
;
4018 static void free_loc_track(struct loc_track
*t
)
4021 free_pages((unsigned long)t
->loc
,
4022 get_order(sizeof(struct location
) * t
->max
));
4025 static int alloc_loc_track(struct loc_track
*t
, unsigned long max
, gfp_t flags
)
4030 order
= get_order(sizeof(struct location
) * max
);
4032 l
= (void *)__get_free_pages(flags
, order
);
4037 memcpy(l
, t
->loc
, sizeof(struct location
) * t
->count
);
4045 static int add_location(struct loc_track
*t
, struct kmem_cache
*s
,
4046 const struct track
*track
)
4048 long start
, end
, pos
;
4050 unsigned long caddr
;
4051 unsigned long age
= jiffies
- track
->when
;
4057 pos
= start
+ (end
- start
+ 1) / 2;
4060 * There is nothing at "end". If we end up there
4061 * we need to add something to before end.
4066 caddr
= t
->loc
[pos
].addr
;
4067 if (track
->addr
== caddr
) {
4073 if (age
< l
->min_time
)
4075 if (age
> l
->max_time
)
4078 if (track
->pid
< l
->min_pid
)
4079 l
->min_pid
= track
->pid
;
4080 if (track
->pid
> l
->max_pid
)
4081 l
->max_pid
= track
->pid
;
4083 cpumask_set_cpu(track
->cpu
,
4084 to_cpumask(l
->cpus
));
4086 node_set(page_to_nid(virt_to_page(track
)), l
->nodes
);
4090 if (track
->addr
< caddr
)
4097 * Not found. Insert new tracking element.
4099 if (t
->count
>= t
->max
&& !alloc_loc_track(t
, 2 * t
->max
, GFP_ATOMIC
))
4105 (t
->count
- pos
) * sizeof(struct location
));
4108 l
->addr
= track
->addr
;
4112 l
->min_pid
= track
->pid
;
4113 l
->max_pid
= track
->pid
;
4114 cpumask_clear(to_cpumask(l
->cpus
));
4115 cpumask_set_cpu(track
->cpu
, to_cpumask(l
->cpus
));
4116 nodes_clear(l
->nodes
);
4117 node_set(page_to_nid(virt_to_page(track
)), l
->nodes
);
4121 static void process_slab(struct loc_track
*t
, struct kmem_cache
*s
,
4122 struct page
*page
, enum track_item alloc
,
4125 void *addr
= page_address(page
);
4128 bitmap_zero(map
, page
->objects
);
4129 get_map(s
, page
, map
);
4131 for_each_object(p
, s
, addr
, page
->objects
)
4132 if (!test_bit(slab_index(p
, s
, addr
), map
))
4133 add_location(t
, s
, get_track(s
, p
, alloc
));
4136 static int list_locations(struct kmem_cache
*s
, char *buf
,
4137 enum track_item alloc
)
4141 struct loc_track t
= { 0, 0, NULL
};
4143 unsigned long *map
= kmalloc(BITS_TO_LONGS(oo_objects(s
->max
)) *
4144 sizeof(unsigned long), GFP_KERNEL
);
4146 if (!map
|| !alloc_loc_track(&t
, PAGE_SIZE
/ sizeof(struct location
),
4149 return sprintf(buf
, "Out of memory\n");
4151 /* Push back cpu slabs */
4154 for_each_node_state(node
, N_NORMAL_MEMORY
) {
4155 struct kmem_cache_node
*n
= get_node(s
, node
);
4156 unsigned long flags
;
4159 if (!atomic_long_read(&n
->nr_slabs
))
4162 spin_lock_irqsave(&n
->list_lock
, flags
);
4163 list_for_each_entry(page
, &n
->partial
, lru
)
4164 process_slab(&t
, s
, page
, alloc
, map
);
4165 list_for_each_entry(page
, &n
->full
, lru
)
4166 process_slab(&t
, s
, page
, alloc
, map
);
4167 spin_unlock_irqrestore(&n
->list_lock
, flags
);
4170 for (i
= 0; i
< t
.count
; i
++) {
4171 struct location
*l
= &t
.loc
[i
];
4173 if (len
> PAGE_SIZE
- KSYM_SYMBOL_LEN
- 100)
4175 len
+= sprintf(buf
+ len
, "%7ld ", l
->count
);
4178 len
+= sprintf(buf
+ len
, "%pS", (void *)l
->addr
);
4180 len
+= sprintf(buf
+ len
, "<not-available>");
4182 if (l
->sum_time
!= l
->min_time
) {
4183 len
+= sprintf(buf
+ len
, " age=%ld/%ld/%ld",
4185 (long)div_u64(l
->sum_time
, l
->count
),
4188 len
+= sprintf(buf
+ len
, " age=%ld",
4191 if (l
->min_pid
!= l
->max_pid
)
4192 len
+= sprintf(buf
+ len
, " pid=%ld-%ld",
4193 l
->min_pid
, l
->max_pid
);
4195 len
+= sprintf(buf
+ len
, " pid=%ld",
4198 if (num_online_cpus() > 1 &&
4199 !cpumask_empty(to_cpumask(l
->cpus
)) &&
4200 len
< PAGE_SIZE
- 60) {
4201 len
+= sprintf(buf
+ len
, " cpus=");
4202 len
+= cpulist_scnprintf(buf
+ len
, PAGE_SIZE
- len
- 50,
4203 to_cpumask(l
->cpus
));
4206 if (nr_online_nodes
> 1 && !nodes_empty(l
->nodes
) &&
4207 len
< PAGE_SIZE
- 60) {
4208 len
+= sprintf(buf
+ len
, " nodes=");
4209 len
+= nodelist_scnprintf(buf
+ len
, PAGE_SIZE
- len
- 50,
4213 len
+= sprintf(buf
+ len
, "\n");
4219 len
+= sprintf(buf
, "No data\n");
4224 #ifdef SLUB_RESILIENCY_TEST
4225 static void resiliency_test(void)
4229 BUILD_BUG_ON(KMALLOC_MIN_SIZE
> 16 || SLUB_PAGE_SHIFT
< 10);
4231 printk(KERN_ERR
"SLUB resiliency testing\n");
4232 printk(KERN_ERR
"-----------------------\n");
4233 printk(KERN_ERR
"A. Corruption after allocation\n");
4235 p
= kzalloc(16, GFP_KERNEL
);
4237 printk(KERN_ERR
"\n1. kmalloc-16: Clobber Redzone/next pointer"
4238 " 0x12->0x%p\n\n", p
+ 16);
4240 validate_slab_cache(kmalloc_caches
[4]);
4242 /* Hmmm... The next two are dangerous */
4243 p
= kzalloc(32, GFP_KERNEL
);
4244 p
[32 + sizeof(void *)] = 0x34;
4245 printk(KERN_ERR
"\n2. kmalloc-32: Clobber next pointer/next slab"
4246 " 0x34 -> -0x%p\n", p
);
4248 "If allocated object is overwritten then not detectable\n\n");
4250 validate_slab_cache(kmalloc_caches
[5]);
4251 p
= kzalloc(64, GFP_KERNEL
);
4252 p
+= 64 + (get_cycles() & 0xff) * sizeof(void *);
4254 printk(KERN_ERR
"\n3. kmalloc-64: corrupting random byte 0x56->0x%p\n",
4257 "If allocated object is overwritten then not detectable\n\n");
4258 validate_slab_cache(kmalloc_caches
[6]);
4260 printk(KERN_ERR
"\nB. Corruption after free\n");
4261 p
= kzalloc(128, GFP_KERNEL
);
4264 printk(KERN_ERR
"1. kmalloc-128: Clobber first word 0x78->0x%p\n\n", p
);
4265 validate_slab_cache(kmalloc_caches
[7]);
4267 p
= kzalloc(256, GFP_KERNEL
);
4270 printk(KERN_ERR
"\n2. kmalloc-256: Clobber 50th byte 0x9a->0x%p\n\n",
4272 validate_slab_cache(kmalloc_caches
[8]);
4274 p
= kzalloc(512, GFP_KERNEL
);
4277 printk(KERN_ERR
"\n3. kmalloc-512: Clobber redzone 0xab->0x%p\n\n", p
);
4278 validate_slab_cache(kmalloc_caches
[9]);
4282 static void resiliency_test(void) {};
4287 enum slab_stat_type
{
4288 SL_ALL
, /* All slabs */
4289 SL_PARTIAL
, /* Only partially allocated slabs */
4290 SL_CPU
, /* Only slabs used for cpu caches */
4291 SL_OBJECTS
, /* Determine allocated objects not slabs */
4292 SL_TOTAL
/* Determine object capacity not slabs */
4295 #define SO_ALL (1 << SL_ALL)
4296 #define SO_PARTIAL (1 << SL_PARTIAL)
4297 #define SO_CPU (1 << SL_CPU)
4298 #define SO_OBJECTS (1 << SL_OBJECTS)
4299 #define SO_TOTAL (1 << SL_TOTAL)
4301 static ssize_t
show_slab_objects(struct kmem_cache
*s
,
4302 char *buf
, unsigned long flags
)
4304 unsigned long total
= 0;
4307 unsigned long *nodes
;
4308 unsigned long *per_cpu
;
4310 nodes
= kzalloc(2 * sizeof(unsigned long) * nr_node_ids
, GFP_KERNEL
);
4313 per_cpu
= nodes
+ nr_node_ids
;
4315 if (flags
& SO_CPU
) {
4318 for_each_possible_cpu(cpu
) {
4319 struct kmem_cache_cpu
*c
= per_cpu_ptr(s
->cpu_slab
, cpu
);
4321 if (!c
|| c
->node
< 0)
4325 if (flags
& SO_TOTAL
)
4326 x
= c
->page
->objects
;
4327 else if (flags
& SO_OBJECTS
)
4333 nodes
[c
->node
] += x
;
4339 lock_memory_hotplug();
4340 #ifdef CONFIG_SLUB_DEBUG
4341 if (flags
& SO_ALL
) {
4342 for_each_node_state(node
, N_NORMAL_MEMORY
) {
4343 struct kmem_cache_node
*n
= get_node(s
, node
);
4345 if (flags
& SO_TOTAL
)
4346 x
= atomic_long_read(&n
->total_objects
);
4347 else if (flags
& SO_OBJECTS
)
4348 x
= atomic_long_read(&n
->total_objects
) -
4349 count_partial(n
, count_free
);
4352 x
= atomic_long_read(&n
->nr_slabs
);
4359 if (flags
& SO_PARTIAL
) {
4360 for_each_node_state(node
, N_NORMAL_MEMORY
) {
4361 struct kmem_cache_node
*n
= get_node(s
, node
);
4363 if (flags
& SO_TOTAL
)
4364 x
= count_partial(n
, count_total
);
4365 else if (flags
& SO_OBJECTS
)
4366 x
= count_partial(n
, count_inuse
);
4373 x
= sprintf(buf
, "%lu", total
);
4375 for_each_node_state(node
, N_NORMAL_MEMORY
)
4377 x
+= sprintf(buf
+ x
, " N%d=%lu",
4380 unlock_memory_hotplug();
4382 return x
+ sprintf(buf
+ x
, "\n");
4385 #ifdef CONFIG_SLUB_DEBUG
4386 static int any_slab_objects(struct kmem_cache
*s
)
4390 for_each_online_node(node
) {
4391 struct kmem_cache_node
*n
= get_node(s
, node
);
4396 if (atomic_long_read(&n
->total_objects
))
4403 #define to_slab_attr(n) container_of(n, struct slab_attribute, attr)
4404 #define to_slab(n) container_of(n, struct kmem_cache, kobj)
4406 struct slab_attribute
{
4407 struct attribute attr
;
4408 ssize_t (*show
)(struct kmem_cache
*s
, char *buf
);
4409 ssize_t (*store
)(struct kmem_cache
*s
, const char *x
, size_t count
);
4412 #define SLAB_ATTR_RO(_name) \
4413 static struct slab_attribute _name##_attr = __ATTR_RO(_name)
4415 #define SLAB_ATTR(_name) \
4416 static struct slab_attribute _name##_attr = \
4417 __ATTR(_name, 0644, _name##_show, _name##_store)
4419 static ssize_t
slab_size_show(struct kmem_cache
*s
, char *buf
)
4421 return sprintf(buf
, "%d\n", s
->size
);
4423 SLAB_ATTR_RO(slab_size
);
4425 static ssize_t
align_show(struct kmem_cache
*s
, char *buf
)
4427 return sprintf(buf
, "%d\n", s
->align
);
4429 SLAB_ATTR_RO(align
);
4431 static ssize_t
object_size_show(struct kmem_cache
*s
, char *buf
)
4433 return sprintf(buf
, "%d\n", s
->objsize
);
4435 SLAB_ATTR_RO(object_size
);
4437 static ssize_t
objs_per_slab_show(struct kmem_cache
*s
, char *buf
)
4439 return sprintf(buf
, "%d\n", oo_objects(s
->oo
));
4441 SLAB_ATTR_RO(objs_per_slab
);
4443 static ssize_t
order_store(struct kmem_cache
*s
,
4444 const char *buf
, size_t length
)
4446 unsigned long order
;
4449 err
= strict_strtoul(buf
, 10, &order
);
4453 if (order
> slub_max_order
|| order
< slub_min_order
)
4456 calculate_sizes(s
, order
);
4460 static ssize_t
order_show(struct kmem_cache
*s
, char *buf
)
4462 return sprintf(buf
, "%d\n", oo_order(s
->oo
));
4466 static ssize_t
min_partial_show(struct kmem_cache
*s
, char *buf
)
4468 return sprintf(buf
, "%lu\n", s
->min_partial
);
4471 static ssize_t
min_partial_store(struct kmem_cache
*s
, const char *buf
,
4477 err
= strict_strtoul(buf
, 10, &min
);
4481 set_min_partial(s
, min
);
4484 SLAB_ATTR(min_partial
);
4486 static ssize_t
ctor_show(struct kmem_cache
*s
, char *buf
)
4490 return sprintf(buf
, "%pS\n", s
->ctor
);
4494 static ssize_t
aliases_show(struct kmem_cache
*s
, char *buf
)
4496 return sprintf(buf
, "%d\n", s
->refcount
- 1);
4498 SLAB_ATTR_RO(aliases
);
4500 static ssize_t
partial_show(struct kmem_cache
*s
, char *buf
)
4502 return show_slab_objects(s
, buf
, SO_PARTIAL
);
4504 SLAB_ATTR_RO(partial
);
4506 static ssize_t
cpu_slabs_show(struct kmem_cache
*s
, char *buf
)
4508 return show_slab_objects(s
, buf
, SO_CPU
);
4510 SLAB_ATTR_RO(cpu_slabs
);
4512 static ssize_t
objects_show(struct kmem_cache
*s
, char *buf
)
4514 return show_slab_objects(s
, buf
, SO_ALL
|SO_OBJECTS
);
4516 SLAB_ATTR_RO(objects
);
4518 static ssize_t
objects_partial_show(struct kmem_cache
*s
, char *buf
)
4520 return show_slab_objects(s
, buf
, SO_PARTIAL
|SO_OBJECTS
);
4522 SLAB_ATTR_RO(objects_partial
);
4524 static ssize_t
reclaim_account_show(struct kmem_cache
*s
, char *buf
)
4526 return sprintf(buf
, "%d\n", !!(s
->flags
& SLAB_RECLAIM_ACCOUNT
));
4529 static ssize_t
reclaim_account_store(struct kmem_cache
*s
,
4530 const char *buf
, size_t length
)
4532 s
->flags
&= ~SLAB_RECLAIM_ACCOUNT
;
4534 s
->flags
|= SLAB_RECLAIM_ACCOUNT
;
4537 SLAB_ATTR(reclaim_account
);
4539 static ssize_t
hwcache_align_show(struct kmem_cache
*s
, char *buf
)
4541 return sprintf(buf
, "%d\n", !!(s
->flags
& SLAB_HWCACHE_ALIGN
));
4543 SLAB_ATTR_RO(hwcache_align
);
4545 #ifdef CONFIG_ZONE_DMA
4546 static ssize_t
cache_dma_show(struct kmem_cache
*s
, char *buf
)
4548 return sprintf(buf
, "%d\n", !!(s
->flags
& SLAB_CACHE_DMA
));
4550 SLAB_ATTR_RO(cache_dma
);
4553 static ssize_t
destroy_by_rcu_show(struct kmem_cache
*s
, char *buf
)
4555 return sprintf(buf
, "%d\n", !!(s
->flags
& SLAB_DESTROY_BY_RCU
));
4557 SLAB_ATTR_RO(destroy_by_rcu
);
4559 static ssize_t
reserved_show(struct kmem_cache
*s
, char *buf
)
4561 return sprintf(buf
, "%d\n", s
->reserved
);
4563 SLAB_ATTR_RO(reserved
);
4565 #ifdef CONFIG_SLUB_DEBUG
4566 static ssize_t
slabs_show(struct kmem_cache
*s
, char *buf
)
4568 return show_slab_objects(s
, buf
, SO_ALL
);
4570 SLAB_ATTR_RO(slabs
);
4572 static ssize_t
total_objects_show(struct kmem_cache
*s
, char *buf
)
4574 return show_slab_objects(s
, buf
, SO_ALL
|SO_TOTAL
);
4576 SLAB_ATTR_RO(total_objects
);
4578 static ssize_t
sanity_checks_show(struct kmem_cache
*s
, char *buf
)
4580 return sprintf(buf
, "%d\n", !!(s
->flags
& SLAB_DEBUG_FREE
));
4583 static ssize_t
sanity_checks_store(struct kmem_cache
*s
,
4584 const char *buf
, size_t length
)
4586 s
->flags
&= ~SLAB_DEBUG_FREE
;
4587 if (buf
[0] == '1') {
4588 s
->flags
&= ~__CMPXCHG_DOUBLE
;
4589 s
->flags
|= SLAB_DEBUG_FREE
;
4593 SLAB_ATTR(sanity_checks
);
4595 static ssize_t
trace_show(struct kmem_cache
*s
, char *buf
)
4597 return sprintf(buf
, "%d\n", !!(s
->flags
& SLAB_TRACE
));
4600 static ssize_t
trace_store(struct kmem_cache
*s
, const char *buf
,
4603 s
->flags
&= ~SLAB_TRACE
;
4604 if (buf
[0] == '1') {
4605 s
->flags
&= ~__CMPXCHG_DOUBLE
;
4606 s
->flags
|= SLAB_TRACE
;
4612 static ssize_t
red_zone_show(struct kmem_cache
*s
, char *buf
)
4614 return sprintf(buf
, "%d\n", !!(s
->flags
& SLAB_RED_ZONE
));
4617 static ssize_t
red_zone_store(struct kmem_cache
*s
,
4618 const char *buf
, size_t length
)
4620 if (any_slab_objects(s
))
4623 s
->flags
&= ~SLAB_RED_ZONE
;
4624 if (buf
[0] == '1') {
4625 s
->flags
&= ~__CMPXCHG_DOUBLE
;
4626 s
->flags
|= SLAB_RED_ZONE
;
4628 calculate_sizes(s
, -1);
4631 SLAB_ATTR(red_zone
);
4633 static ssize_t
poison_show(struct kmem_cache
*s
, char *buf
)
4635 return sprintf(buf
, "%d\n", !!(s
->flags
& SLAB_POISON
));
4638 static ssize_t
poison_store(struct kmem_cache
*s
,
4639 const char *buf
, size_t length
)
4641 if (any_slab_objects(s
))
4644 s
->flags
&= ~SLAB_POISON
;
4645 if (buf
[0] == '1') {
4646 s
->flags
&= ~__CMPXCHG_DOUBLE
;
4647 s
->flags
|= SLAB_POISON
;
4649 calculate_sizes(s
, -1);
4654 static ssize_t
store_user_show(struct kmem_cache
*s
, char *buf
)
4656 return sprintf(buf
, "%d\n", !!(s
->flags
& SLAB_STORE_USER
));
4659 static ssize_t
store_user_store(struct kmem_cache
*s
,
4660 const char *buf
, size_t length
)
4662 if (any_slab_objects(s
))
4665 s
->flags
&= ~SLAB_STORE_USER
;
4666 if (buf
[0] == '1') {
4667 s
->flags
&= ~__CMPXCHG_DOUBLE
;
4668 s
->flags
|= SLAB_STORE_USER
;
4670 calculate_sizes(s
, -1);
4673 SLAB_ATTR(store_user
);
4675 static ssize_t
validate_show(struct kmem_cache
*s
, char *buf
)
4680 static ssize_t
validate_store(struct kmem_cache
*s
,
4681 const char *buf
, size_t length
)
4685 if (buf
[0] == '1') {
4686 ret
= validate_slab_cache(s
);
4692 SLAB_ATTR(validate
);
4694 static ssize_t
alloc_calls_show(struct kmem_cache
*s
, char *buf
)
4696 if (!(s
->flags
& SLAB_STORE_USER
))
4698 return list_locations(s
, buf
, TRACK_ALLOC
);
4700 SLAB_ATTR_RO(alloc_calls
);
4702 static ssize_t
free_calls_show(struct kmem_cache
*s
, char *buf
)
4704 if (!(s
->flags
& SLAB_STORE_USER
))
4706 return list_locations(s
, buf
, TRACK_FREE
);
4708 SLAB_ATTR_RO(free_calls
);
4709 #endif /* CONFIG_SLUB_DEBUG */
4711 #ifdef CONFIG_FAILSLAB
4712 static ssize_t
failslab_show(struct kmem_cache
*s
, char *buf
)
4714 return sprintf(buf
, "%d\n", !!(s
->flags
& SLAB_FAILSLAB
));
4717 static ssize_t
failslab_store(struct kmem_cache
*s
, const char *buf
,
4720 s
->flags
&= ~SLAB_FAILSLAB
;
4722 s
->flags
|= SLAB_FAILSLAB
;
4725 SLAB_ATTR(failslab
);
4728 static ssize_t
shrink_show(struct kmem_cache
*s
, char *buf
)
4733 static ssize_t
shrink_store(struct kmem_cache
*s
,
4734 const char *buf
, size_t length
)
4736 if (buf
[0] == '1') {
4737 int rc
= kmem_cache_shrink(s
);
4748 static ssize_t
remote_node_defrag_ratio_show(struct kmem_cache
*s
, char *buf
)
4750 return sprintf(buf
, "%d\n", s
->remote_node_defrag_ratio
/ 10);
4753 static ssize_t
remote_node_defrag_ratio_store(struct kmem_cache
*s
,
4754 const char *buf
, size_t length
)
4756 unsigned long ratio
;
4759 err
= strict_strtoul(buf
, 10, &ratio
);
4764 s
->remote_node_defrag_ratio
= ratio
* 10;
4768 SLAB_ATTR(remote_node_defrag_ratio
);
4771 #ifdef CONFIG_SLUB_STATS
4772 static int show_stat(struct kmem_cache
*s
, char *buf
, enum stat_item si
)
4774 unsigned long sum
= 0;
4777 int *data
= kmalloc(nr_cpu_ids
* sizeof(int), GFP_KERNEL
);
4782 for_each_online_cpu(cpu
) {
4783 unsigned x
= per_cpu_ptr(s
->cpu_slab
, cpu
)->stat
[si
];
4789 len
= sprintf(buf
, "%lu", sum
);
4792 for_each_online_cpu(cpu
) {
4793 if (data
[cpu
] && len
< PAGE_SIZE
- 20)
4794 len
+= sprintf(buf
+ len
, " C%d=%u", cpu
, data
[cpu
]);
4798 return len
+ sprintf(buf
+ len
, "\n");
4801 static void clear_stat(struct kmem_cache
*s
, enum stat_item si
)
4805 for_each_online_cpu(cpu
)
4806 per_cpu_ptr(s
->cpu_slab
, cpu
)->stat
[si
] = 0;
4809 #define STAT_ATTR(si, text) \
4810 static ssize_t text##_show(struct kmem_cache *s, char *buf) \
4812 return show_stat(s, buf, si); \
4814 static ssize_t text##_store(struct kmem_cache *s, \
4815 const char *buf, size_t length) \
4817 if (buf[0] != '0') \
4819 clear_stat(s, si); \
4824 STAT_ATTR(ALLOC_FASTPATH, alloc_fastpath);
4825 STAT_ATTR(ALLOC_SLOWPATH
, alloc_slowpath
);
4826 STAT_ATTR(FREE_FASTPATH
, free_fastpath
);
4827 STAT_ATTR(FREE_SLOWPATH
, free_slowpath
);
4828 STAT_ATTR(FREE_FROZEN
, free_frozen
);
4829 STAT_ATTR(FREE_ADD_PARTIAL
, free_add_partial
);
4830 STAT_ATTR(FREE_REMOVE_PARTIAL
, free_remove_partial
);
4831 STAT_ATTR(ALLOC_FROM_PARTIAL
, alloc_from_partial
);
4832 STAT_ATTR(ALLOC_SLAB
, alloc_slab
);
4833 STAT_ATTR(ALLOC_REFILL
, alloc_refill
);
4834 STAT_ATTR(ALLOC_NODE_MISMATCH
, alloc_node_mismatch
);
4835 STAT_ATTR(FREE_SLAB
, free_slab
);
4836 STAT_ATTR(CPUSLAB_FLUSH
, cpuslab_flush
);
4837 STAT_ATTR(DEACTIVATE_FULL
, deactivate_full
);
4838 STAT_ATTR(DEACTIVATE_EMPTY
, deactivate_empty
);
4839 STAT_ATTR(DEACTIVATE_TO_HEAD
, deactivate_to_head
);
4840 STAT_ATTR(DEACTIVATE_TO_TAIL
, deactivate_to_tail
);
4841 STAT_ATTR(DEACTIVATE_REMOTE_FREES
, deactivate_remote_frees
);
4842 STAT_ATTR(DEACTIVATE_BYPASS
, deactivate_bypass
);
4843 STAT_ATTR(ORDER_FALLBACK
, order_fallback
);
4844 STAT_ATTR(CMPXCHG_DOUBLE_CPU_FAIL
, cmpxchg_double_cpu_fail
);
4845 STAT_ATTR(CMPXCHG_DOUBLE_FAIL
, cmpxchg_double_fail
);
4848 static struct attribute
*slab_attrs
[] = {
4849 &slab_size_attr
.attr
,
4850 &object_size_attr
.attr
,
4851 &objs_per_slab_attr
.attr
,
4853 &min_partial_attr
.attr
,
4855 &objects_partial_attr
.attr
,
4857 &cpu_slabs_attr
.attr
,
4861 &hwcache_align_attr
.attr
,
4862 &reclaim_account_attr
.attr
,
4863 &destroy_by_rcu_attr
.attr
,
4865 &reserved_attr
.attr
,
4866 #ifdef CONFIG_SLUB_DEBUG
4867 &total_objects_attr
.attr
,
4869 &sanity_checks_attr
.attr
,
4871 &red_zone_attr
.attr
,
4873 &store_user_attr
.attr
,
4874 &validate_attr
.attr
,
4875 &alloc_calls_attr
.attr
,
4876 &free_calls_attr
.attr
,
4878 #ifdef CONFIG_ZONE_DMA
4879 &cache_dma_attr
.attr
,
4882 &remote_node_defrag_ratio_attr
.attr
,
4884 #ifdef CONFIG_SLUB_STATS
4885 &alloc_fastpath_attr
.attr
,
4886 &alloc_slowpath_attr
.attr
,
4887 &free_fastpath_attr
.attr
,
4888 &free_slowpath_attr
.attr
,
4889 &free_frozen_attr
.attr
,
4890 &free_add_partial_attr
.attr
,
4891 &free_remove_partial_attr
.attr
,
4892 &alloc_from_partial_attr
.attr
,
4893 &alloc_slab_attr
.attr
,
4894 &alloc_refill_attr
.attr
,
4895 &alloc_node_mismatch_attr
.attr
,
4896 &free_slab_attr
.attr
,
4897 &cpuslab_flush_attr
.attr
,
4898 &deactivate_full_attr
.attr
,
4899 &deactivate_empty_attr
.attr
,
4900 &deactivate_to_head_attr
.attr
,
4901 &deactivate_to_tail_attr
.attr
,
4902 &deactivate_remote_frees_attr
.attr
,
4903 &deactivate_bypass_attr
.attr
,
4904 &order_fallback_attr
.attr
,
4905 &cmpxchg_double_fail_attr
.attr
,
4906 &cmpxchg_double_cpu_fail_attr
.attr
,
4908 #ifdef CONFIG_FAILSLAB
4909 &failslab_attr
.attr
,
4915 static struct attribute_group slab_attr_group
= {
4916 .attrs
= slab_attrs
,
4919 static ssize_t
slab_attr_show(struct kobject
*kobj
,
4920 struct attribute
*attr
,
4923 struct slab_attribute
*attribute
;
4924 struct kmem_cache
*s
;
4927 attribute
= to_slab_attr(attr
);
4930 if (!attribute
->show
)
4933 err
= attribute
->show(s
, buf
);
4938 static ssize_t
slab_attr_store(struct kobject
*kobj
,
4939 struct attribute
*attr
,
4940 const char *buf
, size_t len
)
4942 struct slab_attribute
*attribute
;
4943 struct kmem_cache
*s
;
4946 attribute
= to_slab_attr(attr
);
4949 if (!attribute
->store
)
4952 err
= attribute
->store(s
, buf
, len
);
4957 static void kmem_cache_release(struct kobject
*kobj
)
4959 struct kmem_cache
*s
= to_slab(kobj
);
4965 static const struct sysfs_ops slab_sysfs_ops
= {
4966 .show
= slab_attr_show
,
4967 .store
= slab_attr_store
,
4970 static struct kobj_type slab_ktype
= {
4971 .sysfs_ops
= &slab_sysfs_ops
,
4972 .release
= kmem_cache_release
4975 static int uevent_filter(struct kset
*kset
, struct kobject
*kobj
)
4977 struct kobj_type
*ktype
= get_ktype(kobj
);
4979 if (ktype
== &slab_ktype
)
4984 static const struct kset_uevent_ops slab_uevent_ops
= {
4985 .filter
= uevent_filter
,
4988 static struct kset
*slab_kset
;
4990 #define ID_STR_LENGTH 64
4992 /* Create a unique string id for a slab cache:
4994 * Format :[flags-]size
4996 static char *create_unique_id(struct kmem_cache
*s
)
4998 char *name
= kmalloc(ID_STR_LENGTH
, GFP_KERNEL
);
5005 * First flags affecting slabcache operations. We will only
5006 * get here for aliasable slabs so we do not need to support
5007 * too many flags. The flags here must cover all flags that
5008 * are matched during merging to guarantee that the id is
5011 if (s
->flags
& SLAB_CACHE_DMA
)
5013 if (s
->flags
& SLAB_RECLAIM_ACCOUNT
)
5015 if (s
->flags
& SLAB_DEBUG_FREE
)
5017 if (!(s
->flags
& SLAB_NOTRACK
))
5021 p
+= sprintf(p
, "%07d", s
->size
);
5022 BUG_ON(p
> name
+ ID_STR_LENGTH
- 1);
5026 static int sysfs_slab_add(struct kmem_cache
*s
)
5032 if (slab_state
< SYSFS
)
5033 /* Defer until later */
5036 unmergeable
= slab_unmergeable(s
);
5039 * Slabcache can never be merged so we can use the name proper.
5040 * This is typically the case for debug situations. In that
5041 * case we can catch duplicate names easily.
5043 sysfs_remove_link(&slab_kset
->kobj
, s
->name
);
5047 * Create a unique name for the slab as a target
5050 name
= create_unique_id(s
);
5053 s
->kobj
.kset
= slab_kset
;
5054 err
= kobject_init_and_add(&s
->kobj
, &slab_ktype
, NULL
, name
);
5056 kobject_put(&s
->kobj
);
5060 err
= sysfs_create_group(&s
->kobj
, &slab_attr_group
);
5062 kobject_del(&s
->kobj
);
5063 kobject_put(&s
->kobj
);
5066 kobject_uevent(&s
->kobj
, KOBJ_ADD
);
5068 /* Setup first alias */
5069 sysfs_slab_alias(s
, s
->name
);
5075 static void sysfs_slab_remove(struct kmem_cache
*s
)
5077 if (slab_state
< SYSFS
)
5079 * Sysfs has not been setup yet so no need to remove the
5084 kobject_uevent(&s
->kobj
, KOBJ_REMOVE
);
5085 kobject_del(&s
->kobj
);
5086 kobject_put(&s
->kobj
);
5090 * Need to buffer aliases during bootup until sysfs becomes
5091 * available lest we lose that information.
5093 struct saved_alias
{
5094 struct kmem_cache
*s
;
5096 struct saved_alias
*next
;
5099 static struct saved_alias
*alias_list
;
5101 static int sysfs_slab_alias(struct kmem_cache
*s
, const char *name
)
5103 struct saved_alias
*al
;
5105 if (slab_state
== SYSFS
) {
5107 * If we have a leftover link then remove it.
5109 sysfs_remove_link(&slab_kset
->kobj
, name
);
5110 return sysfs_create_link(&slab_kset
->kobj
, &s
->kobj
, name
);
5113 al
= kmalloc(sizeof(struct saved_alias
), GFP_KERNEL
);
5119 al
->next
= alias_list
;
5124 static int __init
slab_sysfs_init(void)
5126 struct kmem_cache
*s
;
5129 down_write(&slub_lock
);
5131 slab_kset
= kset_create_and_add("slab", &slab_uevent_ops
, kernel_kobj
);
5133 up_write(&slub_lock
);
5134 printk(KERN_ERR
"Cannot register slab subsystem.\n");
5140 list_for_each_entry(s
, &slab_caches
, list
) {
5141 err
= sysfs_slab_add(s
);
5143 printk(KERN_ERR
"SLUB: Unable to add boot slab %s"
5144 " to sysfs\n", s
->name
);
5147 while (alias_list
) {
5148 struct saved_alias
*al
= alias_list
;
5150 alias_list
= alias_list
->next
;
5151 err
= sysfs_slab_alias(al
->s
, al
->name
);
5153 printk(KERN_ERR
"SLUB: Unable to add boot slab alias"
5154 " %s to sysfs\n", s
->name
);
5158 up_write(&slub_lock
);
5163 __initcall(slab_sysfs_init
);
5164 #endif /* CONFIG_SYSFS */
5167 * The /proc/slabinfo ABI
5169 #ifdef CONFIG_SLABINFO
5170 static void print_slabinfo_header(struct seq_file
*m
)
5172 seq_puts(m
, "slabinfo - version: 2.1\n");
5173 seq_puts(m
, "# name <active_objs> <num_objs> <objsize> "
5174 "<objperslab> <pagesperslab>");
5175 seq_puts(m
, " : tunables <limit> <batchcount> <sharedfactor>");
5176 seq_puts(m
, " : slabdata <active_slabs> <num_slabs> <sharedavail>");
5180 static void *s_start(struct seq_file
*m
, loff_t
*pos
)
5184 down_read(&slub_lock
);
5186 print_slabinfo_header(m
);
5188 return seq_list_start(&slab_caches
, *pos
);
5191 static void *s_next(struct seq_file
*m
, void *p
, loff_t
*pos
)
5193 return seq_list_next(p
, &slab_caches
, pos
);
5196 static void s_stop(struct seq_file
*m
, void *p
)
5198 up_read(&slub_lock
);
5201 static int s_show(struct seq_file
*m
, void *p
)
5203 unsigned long nr_partials
= 0;
5204 unsigned long nr_slabs
= 0;
5205 unsigned long nr_inuse
= 0;
5206 unsigned long nr_objs
= 0;
5207 unsigned long nr_free
= 0;
5208 struct kmem_cache
*s
;
5211 s
= list_entry(p
, struct kmem_cache
, list
);
5213 for_each_online_node(node
) {
5214 struct kmem_cache_node
*n
= get_node(s
, node
);
5219 nr_partials
+= n
->nr_partial
;
5220 nr_slabs
+= atomic_long_read(&n
->nr_slabs
);
5221 nr_objs
+= atomic_long_read(&n
->total_objects
);
5222 nr_free
+= count_partial(n
, count_free
);
5225 nr_inuse
= nr_objs
- nr_free
;
5227 seq_printf(m
, "%-17s %6lu %6lu %6u %4u %4d", s
->name
, nr_inuse
,
5228 nr_objs
, s
->size
, oo_objects(s
->oo
),
5229 (1 << oo_order(s
->oo
)));
5230 seq_printf(m
, " : tunables %4u %4u %4u", 0, 0, 0);
5231 seq_printf(m
, " : slabdata %6lu %6lu %6lu", nr_slabs
, nr_slabs
,
5237 static const struct seq_operations slabinfo_op
= {
5244 static int slabinfo_open(struct inode
*inode
, struct file
*file
)
5246 return seq_open(file
, &slabinfo_op
);
5249 static const struct file_operations proc_slabinfo_operations
= {
5250 .open
= slabinfo_open
,
5252 .llseek
= seq_lseek
,
5253 .release
= seq_release
,
5256 static int __init
slab_proc_init(void)
5258 proc_create("slabinfo", S_IRUGO
, NULL
, &proc_slabinfo_operations
);
5261 module_init(slab_proc_init
);
5262 #endif /* CONFIG_SLABINFO */