2 * Generic infrastructure for lifetime debugging of objects.
4 * Started by Thomas Gleixner
6 * Copyright (C) 2008, Thomas Gleixner <tglx@linutronix.de>
8 * For licencing details see kernel-base/COPYING
11 #define pr_fmt(fmt) "ODEBUG: " fmt
13 #include <linux/debugobjects.h>
14 #include <linux/interrupt.h>
15 #include <linux/sched.h>
16 #include <linux/sched/task_stack.h>
17 #include <linux/seq_file.h>
18 #include <linux/debugfs.h>
19 #include <linux/slab.h>
20 #include <linux/hash.h>
21 #include <linux/kmemleak.h>
23 #define ODEBUG_HASH_BITS 14
24 #define ODEBUG_HASH_SIZE (1 << ODEBUG_HASH_BITS)
26 #define ODEBUG_POOL_SIZE 1024
27 #define ODEBUG_POOL_MIN_LEVEL 256
29 #define ODEBUG_CHUNK_SHIFT PAGE_SHIFT
30 #define ODEBUG_CHUNK_SIZE (1 << ODEBUG_CHUNK_SHIFT)
31 #define ODEBUG_CHUNK_MASK (~(ODEBUG_CHUNK_SIZE - 1))
34 struct hlist_head list
;
38 static struct debug_bucket obj_hash
[ODEBUG_HASH_SIZE
];
40 static struct debug_obj obj_static_pool
[ODEBUG_POOL_SIZE
] __initdata
;
42 static DEFINE_RAW_SPINLOCK(pool_lock
);
44 static HLIST_HEAD(obj_pool
);
46 static int obj_pool_min_free
= ODEBUG_POOL_SIZE
;
47 static int obj_pool_free
= ODEBUG_POOL_SIZE
;
48 static int obj_pool_used
;
49 static int obj_pool_max_used
;
50 static struct kmem_cache
*obj_cache
;
52 static int debug_objects_maxchain __read_mostly
;
53 static int debug_objects_fixups __read_mostly
;
54 static int debug_objects_warnings __read_mostly
;
55 static int debug_objects_enabled __read_mostly
56 = CONFIG_DEBUG_OBJECTS_ENABLE_DEFAULT
;
57 static int debug_objects_pool_size __read_mostly
59 static int debug_objects_pool_min_level __read_mostly
60 = ODEBUG_POOL_MIN_LEVEL
;
61 static struct debug_obj_descr
*descr_test __read_mostly
;
64 * Track numbers of kmem_cache_alloc()/free() calls done.
66 static int debug_objects_allocated
;
67 static int debug_objects_freed
;
69 static void free_obj_work(struct work_struct
*work
);
70 static DECLARE_WORK(debug_obj_work
, free_obj_work
);
72 static int __init
enable_object_debug(char *str
)
74 debug_objects_enabled
= 1;
78 static int __init
disable_object_debug(char *str
)
80 debug_objects_enabled
= 0;
84 early_param("debug_objects", enable_object_debug
);
85 early_param("no_debug_objects", disable_object_debug
);
87 static const char *obj_states
[ODEBUG_STATE_MAX
] = {
88 [ODEBUG_STATE_NONE
] = "none",
89 [ODEBUG_STATE_INIT
] = "initialized",
90 [ODEBUG_STATE_INACTIVE
] = "inactive",
91 [ODEBUG_STATE_ACTIVE
] = "active",
92 [ODEBUG_STATE_DESTROYED
] = "destroyed",
93 [ODEBUG_STATE_NOTAVAILABLE
] = "not available",
96 static void fill_pool(void)
98 gfp_t gfp
= GFP_ATOMIC
| __GFP_NORETRY
| __GFP_NOWARN
;
99 struct debug_obj
*new;
102 if (likely(obj_pool_free
>= debug_objects_pool_min_level
))
105 if (unlikely(!obj_cache
))
108 while (obj_pool_free
< debug_objects_pool_min_level
) {
110 new = kmem_cache_zalloc(obj_cache
, gfp
);
114 kmemleak_ignore(new);
115 raw_spin_lock_irqsave(&pool_lock
, flags
);
116 hlist_add_head(&new->node
, &obj_pool
);
117 debug_objects_allocated
++;
119 raw_spin_unlock_irqrestore(&pool_lock
, flags
);
124 * Lookup an object in the hash bucket.
126 static struct debug_obj
*lookup_object(void *addr
, struct debug_bucket
*b
)
128 struct debug_obj
*obj
;
131 hlist_for_each_entry(obj
, &b
->list
, node
) {
133 if (obj
->object
== addr
)
136 if (cnt
> debug_objects_maxchain
)
137 debug_objects_maxchain
= cnt
;
143 * Allocate a new object. If the pool is empty, switch off the debugger.
144 * Must be called with interrupts disabled.
146 static struct debug_obj
*
147 alloc_object(void *addr
, struct debug_bucket
*b
, struct debug_obj_descr
*descr
)
149 struct debug_obj
*obj
= NULL
;
151 raw_spin_lock(&pool_lock
);
152 if (obj_pool
.first
) {
153 obj
= hlist_entry(obj_pool
.first
, typeof(*obj
), node
);
157 obj
->state
= ODEBUG_STATE_NONE
;
159 hlist_del(&obj
->node
);
161 hlist_add_head(&obj
->node
, &b
->list
);
164 if (obj_pool_used
> obj_pool_max_used
)
165 obj_pool_max_used
= obj_pool_used
;
168 if (obj_pool_free
< obj_pool_min_free
)
169 obj_pool_min_free
= obj_pool_free
;
171 raw_spin_unlock(&pool_lock
);
177 * workqueue function to free objects.
179 * To reduce contention on the global pool_lock, the actual freeing of
180 * debug objects will be delayed if the pool_lock is busy. We also free
181 * the objects in a batch of 4 for each lock/unlock cycle.
183 #define ODEBUG_FREE_BATCH 4
185 static void free_obj_work(struct work_struct
*work
)
187 struct debug_obj
*objs
[ODEBUG_FREE_BATCH
];
191 if (!raw_spin_trylock_irqsave(&pool_lock
, flags
))
193 while (obj_pool_free
>= debug_objects_pool_size
+ ODEBUG_FREE_BATCH
) {
194 for (i
= 0; i
< ODEBUG_FREE_BATCH
; i
++) {
195 objs
[i
] = hlist_entry(obj_pool
.first
,
196 typeof(*objs
[0]), node
);
197 hlist_del(&objs
[i
]->node
);
200 obj_pool_free
-= ODEBUG_FREE_BATCH
;
201 debug_objects_freed
+= ODEBUG_FREE_BATCH
;
203 * We release pool_lock across kmem_cache_free() to
204 * avoid contention on pool_lock.
206 raw_spin_unlock_irqrestore(&pool_lock
, flags
);
207 for (i
= 0; i
< ODEBUG_FREE_BATCH
; i
++)
208 kmem_cache_free(obj_cache
, objs
[i
]);
209 if (!raw_spin_trylock_irqsave(&pool_lock
, flags
))
212 raw_spin_unlock_irqrestore(&pool_lock
, flags
);
216 * Put the object back into the pool and schedule work to free objects
219 static void free_object(struct debug_obj
*obj
)
224 raw_spin_lock_irqsave(&pool_lock
, flags
);
226 * schedule work when the pool is filled and the cache is
229 if (obj_pool_free
> debug_objects_pool_size
&& obj_cache
)
231 hlist_add_head(&obj
->node
, &obj_pool
);
234 raw_spin_unlock_irqrestore(&pool_lock
, flags
);
236 schedule_work(&debug_obj_work
);
240 * We run out of memory. That means we probably have tons of objects
243 static void debug_objects_oom(void)
245 struct debug_bucket
*db
= obj_hash
;
246 struct hlist_node
*tmp
;
247 HLIST_HEAD(freelist
);
248 struct debug_obj
*obj
;
252 pr_warn("Out of memory. ODEBUG disabled\n");
254 for (i
= 0; i
< ODEBUG_HASH_SIZE
; i
++, db
++) {
255 raw_spin_lock_irqsave(&db
->lock
, flags
);
256 hlist_move_list(&db
->list
, &freelist
);
257 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
260 hlist_for_each_entry_safe(obj
, tmp
, &freelist
, node
) {
261 hlist_del(&obj
->node
);
268 * We use the pfn of the address for the hash. That way we can check
269 * for freed objects simply by checking the affected bucket.
271 static struct debug_bucket
*get_bucket(unsigned long addr
)
275 hash
= hash_long((addr
>> ODEBUG_CHUNK_SHIFT
), ODEBUG_HASH_BITS
);
276 return &obj_hash
[hash
];
279 static void debug_print_object(struct debug_obj
*obj
, char *msg
)
281 struct debug_obj_descr
*descr
= obj
->descr
;
284 if (limit
< 5 && descr
!= descr_test
) {
285 void *hint
= descr
->debug_hint
?
286 descr
->debug_hint(obj
->object
) : NULL
;
288 WARN(1, KERN_ERR
"ODEBUG: %s %s (active state %u) "
289 "object type: %s hint: %pS\n",
290 msg
, obj_states
[obj
->state
], obj
->astate
,
293 debug_objects_warnings
++;
297 * Try to repair the damage, so we have a better chance to get useful
301 debug_object_fixup(bool (*fixup
)(void *addr
, enum debug_obj_state state
),
302 void * addr
, enum debug_obj_state state
)
304 if (fixup
&& fixup(addr
, state
)) {
305 debug_objects_fixups
++;
311 static void debug_object_is_on_stack(void *addr
, int onstack
)
319 is_on_stack
= object_is_on_stack(addr
);
320 if (is_on_stack
== onstack
)
325 pr_warn("object is on stack, but not annotated\n");
327 pr_warn("object is not on stack, but annotated\n");
332 __debug_object_init(void *addr
, struct debug_obj_descr
*descr
, int onstack
)
334 enum debug_obj_state state
;
335 struct debug_bucket
*db
;
336 struct debug_obj
*obj
;
341 db
= get_bucket((unsigned long) addr
);
343 raw_spin_lock_irqsave(&db
->lock
, flags
);
345 obj
= lookup_object(addr
, db
);
347 obj
= alloc_object(addr
, db
, descr
);
349 debug_objects_enabled
= 0;
350 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
354 debug_object_is_on_stack(addr
, onstack
);
357 switch (obj
->state
) {
358 case ODEBUG_STATE_NONE
:
359 case ODEBUG_STATE_INIT
:
360 case ODEBUG_STATE_INACTIVE
:
361 obj
->state
= ODEBUG_STATE_INIT
;
364 case ODEBUG_STATE_ACTIVE
:
365 debug_print_object(obj
, "init");
367 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
368 debug_object_fixup(descr
->fixup_init
, addr
, state
);
371 case ODEBUG_STATE_DESTROYED
:
372 debug_print_object(obj
, "init");
378 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
382 * debug_object_init - debug checks when an object is initialized
383 * @addr: address of the object
384 * @descr: pointer to an object specific debug description structure
386 void debug_object_init(void *addr
, struct debug_obj_descr
*descr
)
388 if (!debug_objects_enabled
)
391 __debug_object_init(addr
, descr
, 0);
393 EXPORT_SYMBOL_GPL(debug_object_init
);
396 * debug_object_init_on_stack - debug checks when an object on stack is
398 * @addr: address of the object
399 * @descr: pointer to an object specific debug description structure
401 void debug_object_init_on_stack(void *addr
, struct debug_obj_descr
*descr
)
403 if (!debug_objects_enabled
)
406 __debug_object_init(addr
, descr
, 1);
408 EXPORT_SYMBOL_GPL(debug_object_init_on_stack
);
411 * debug_object_activate - debug checks when an object is activated
412 * @addr: address of the object
413 * @descr: pointer to an object specific debug description structure
414 * Returns 0 for success, -EINVAL for check failed.
416 int debug_object_activate(void *addr
, struct debug_obj_descr
*descr
)
418 enum debug_obj_state state
;
419 struct debug_bucket
*db
;
420 struct debug_obj
*obj
;
423 struct debug_obj o
= { .object
= addr
,
424 .state
= ODEBUG_STATE_NOTAVAILABLE
,
427 if (!debug_objects_enabled
)
430 db
= get_bucket((unsigned long) addr
);
432 raw_spin_lock_irqsave(&db
->lock
, flags
);
434 obj
= lookup_object(addr
, db
);
436 switch (obj
->state
) {
437 case ODEBUG_STATE_INIT
:
438 case ODEBUG_STATE_INACTIVE
:
439 obj
->state
= ODEBUG_STATE_ACTIVE
;
443 case ODEBUG_STATE_ACTIVE
:
444 debug_print_object(obj
, "activate");
446 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
447 ret
= debug_object_fixup(descr
->fixup_activate
, addr
, state
);
448 return ret
? 0 : -EINVAL
;
450 case ODEBUG_STATE_DESTROYED
:
451 debug_print_object(obj
, "activate");
458 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
462 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
464 * We are here when a static object is activated. We
465 * let the type specific code confirm whether this is
466 * true or not. if true, we just make sure that the
467 * static object is tracked in the object tracker. If
468 * not, this must be a bug, so we try to fix it up.
470 if (descr
->is_static_object
&& descr
->is_static_object(addr
)) {
471 /* track this static object */
472 debug_object_init(addr
, descr
);
473 debug_object_activate(addr
, descr
);
475 debug_print_object(&o
, "activate");
476 ret
= debug_object_fixup(descr
->fixup_activate
, addr
,
477 ODEBUG_STATE_NOTAVAILABLE
);
478 return ret
? 0 : -EINVAL
;
482 EXPORT_SYMBOL_GPL(debug_object_activate
);
485 * debug_object_deactivate - debug checks when an object is deactivated
486 * @addr: address of the object
487 * @descr: pointer to an object specific debug description structure
489 void debug_object_deactivate(void *addr
, struct debug_obj_descr
*descr
)
491 struct debug_bucket
*db
;
492 struct debug_obj
*obj
;
495 if (!debug_objects_enabled
)
498 db
= get_bucket((unsigned long) addr
);
500 raw_spin_lock_irqsave(&db
->lock
, flags
);
502 obj
= lookup_object(addr
, db
);
504 switch (obj
->state
) {
505 case ODEBUG_STATE_INIT
:
506 case ODEBUG_STATE_INACTIVE
:
507 case ODEBUG_STATE_ACTIVE
:
509 obj
->state
= ODEBUG_STATE_INACTIVE
;
511 debug_print_object(obj
, "deactivate");
514 case ODEBUG_STATE_DESTROYED
:
515 debug_print_object(obj
, "deactivate");
521 struct debug_obj o
= { .object
= addr
,
522 .state
= ODEBUG_STATE_NOTAVAILABLE
,
525 debug_print_object(&o
, "deactivate");
528 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
530 EXPORT_SYMBOL_GPL(debug_object_deactivate
);
533 * debug_object_destroy - debug checks when an object is destroyed
534 * @addr: address of the object
535 * @descr: pointer to an object specific debug description structure
537 void debug_object_destroy(void *addr
, struct debug_obj_descr
*descr
)
539 enum debug_obj_state state
;
540 struct debug_bucket
*db
;
541 struct debug_obj
*obj
;
544 if (!debug_objects_enabled
)
547 db
= get_bucket((unsigned long) addr
);
549 raw_spin_lock_irqsave(&db
->lock
, flags
);
551 obj
= lookup_object(addr
, db
);
555 switch (obj
->state
) {
556 case ODEBUG_STATE_NONE
:
557 case ODEBUG_STATE_INIT
:
558 case ODEBUG_STATE_INACTIVE
:
559 obj
->state
= ODEBUG_STATE_DESTROYED
;
561 case ODEBUG_STATE_ACTIVE
:
562 debug_print_object(obj
, "destroy");
564 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
565 debug_object_fixup(descr
->fixup_destroy
, addr
, state
);
568 case ODEBUG_STATE_DESTROYED
:
569 debug_print_object(obj
, "destroy");
575 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
577 EXPORT_SYMBOL_GPL(debug_object_destroy
);
580 * debug_object_free - debug checks when an object is freed
581 * @addr: address of the object
582 * @descr: pointer to an object specific debug description structure
584 void debug_object_free(void *addr
, struct debug_obj_descr
*descr
)
586 enum debug_obj_state state
;
587 struct debug_bucket
*db
;
588 struct debug_obj
*obj
;
591 if (!debug_objects_enabled
)
594 db
= get_bucket((unsigned long) addr
);
596 raw_spin_lock_irqsave(&db
->lock
, flags
);
598 obj
= lookup_object(addr
, db
);
602 switch (obj
->state
) {
603 case ODEBUG_STATE_ACTIVE
:
604 debug_print_object(obj
, "free");
606 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
607 debug_object_fixup(descr
->fixup_free
, addr
, state
);
610 hlist_del(&obj
->node
);
611 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
616 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
618 EXPORT_SYMBOL_GPL(debug_object_free
);
621 * debug_object_assert_init - debug checks when object should be init-ed
622 * @addr: address of the object
623 * @descr: pointer to an object specific debug description structure
625 void debug_object_assert_init(void *addr
, struct debug_obj_descr
*descr
)
627 struct debug_bucket
*db
;
628 struct debug_obj
*obj
;
631 if (!debug_objects_enabled
)
634 db
= get_bucket((unsigned long) addr
);
636 raw_spin_lock_irqsave(&db
->lock
, flags
);
638 obj
= lookup_object(addr
, db
);
640 struct debug_obj o
= { .object
= addr
,
641 .state
= ODEBUG_STATE_NOTAVAILABLE
,
644 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
646 * Maybe the object is static, and we let the type specific
647 * code confirm. Track this static object if true, else invoke
650 if (descr
->is_static_object
&& descr
->is_static_object(addr
)) {
651 /* Track this static object */
652 debug_object_init(addr
, descr
);
654 debug_print_object(&o
, "assert_init");
655 debug_object_fixup(descr
->fixup_assert_init
, addr
,
656 ODEBUG_STATE_NOTAVAILABLE
);
661 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
663 EXPORT_SYMBOL_GPL(debug_object_assert_init
);
666 * debug_object_active_state - debug checks object usage state machine
667 * @addr: address of the object
668 * @descr: pointer to an object specific debug description structure
669 * @expect: expected state
670 * @next: state to move to if expected state is found
673 debug_object_active_state(void *addr
, struct debug_obj_descr
*descr
,
674 unsigned int expect
, unsigned int next
)
676 struct debug_bucket
*db
;
677 struct debug_obj
*obj
;
680 if (!debug_objects_enabled
)
683 db
= get_bucket((unsigned long) addr
);
685 raw_spin_lock_irqsave(&db
->lock
, flags
);
687 obj
= lookup_object(addr
, db
);
689 switch (obj
->state
) {
690 case ODEBUG_STATE_ACTIVE
:
691 if (obj
->astate
== expect
)
694 debug_print_object(obj
, "active_state");
698 debug_print_object(obj
, "active_state");
702 struct debug_obj o
= { .object
= addr
,
703 .state
= ODEBUG_STATE_NOTAVAILABLE
,
706 debug_print_object(&o
, "active_state");
709 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
711 EXPORT_SYMBOL_GPL(debug_object_active_state
);
713 #ifdef CONFIG_DEBUG_OBJECTS_FREE
714 static void __debug_check_no_obj_freed(const void *address
, unsigned long size
)
716 unsigned long flags
, oaddr
, saddr
, eaddr
, paddr
, chunks
;
717 struct hlist_node
*tmp
;
718 HLIST_HEAD(freelist
);
719 struct debug_obj_descr
*descr
;
720 enum debug_obj_state state
;
721 struct debug_bucket
*db
;
722 struct debug_obj
*obj
;
725 saddr
= (unsigned long) address
;
726 eaddr
= saddr
+ size
;
727 paddr
= saddr
& ODEBUG_CHUNK_MASK
;
728 chunks
= ((eaddr
- paddr
) + (ODEBUG_CHUNK_SIZE
- 1));
729 chunks
>>= ODEBUG_CHUNK_SHIFT
;
731 for (;chunks
> 0; chunks
--, paddr
+= ODEBUG_CHUNK_SIZE
) {
732 db
= get_bucket(paddr
);
736 raw_spin_lock_irqsave(&db
->lock
, flags
);
737 hlist_for_each_entry_safe(obj
, tmp
, &db
->list
, node
) {
739 oaddr
= (unsigned long) obj
->object
;
740 if (oaddr
< saddr
|| oaddr
>= eaddr
)
743 switch (obj
->state
) {
744 case ODEBUG_STATE_ACTIVE
:
745 debug_print_object(obj
, "free");
748 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
749 debug_object_fixup(descr
->fixup_free
,
750 (void *) oaddr
, state
);
753 hlist_del(&obj
->node
);
754 hlist_add_head(&obj
->node
, &freelist
);
758 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
761 hlist_for_each_entry_safe(obj
, tmp
, &freelist
, node
) {
762 hlist_del(&obj
->node
);
766 if (cnt
> debug_objects_maxchain
)
767 debug_objects_maxchain
= cnt
;
771 void debug_check_no_obj_freed(const void *address
, unsigned long size
)
773 if (debug_objects_enabled
)
774 __debug_check_no_obj_freed(address
, size
);
778 #ifdef CONFIG_DEBUG_FS
780 static int debug_stats_show(struct seq_file
*m
, void *v
)
782 seq_printf(m
, "max_chain :%d\n", debug_objects_maxchain
);
783 seq_printf(m
, "warnings :%d\n", debug_objects_warnings
);
784 seq_printf(m
, "fixups :%d\n", debug_objects_fixups
);
785 seq_printf(m
, "pool_free :%d\n", obj_pool_free
);
786 seq_printf(m
, "pool_min_free :%d\n", obj_pool_min_free
);
787 seq_printf(m
, "pool_used :%d\n", obj_pool_used
);
788 seq_printf(m
, "pool_max_used :%d\n", obj_pool_max_used
);
789 seq_printf(m
, "objs_allocated:%d\n", debug_objects_allocated
);
790 seq_printf(m
, "objs_freed :%d\n", debug_objects_freed
);
794 static int debug_stats_open(struct inode
*inode
, struct file
*filp
)
796 return single_open(filp
, debug_stats_show
, NULL
);
799 static const struct file_operations debug_stats_fops
= {
800 .open
= debug_stats_open
,
803 .release
= single_release
,
806 static int __init
debug_objects_init_debugfs(void)
808 struct dentry
*dbgdir
, *dbgstats
;
810 if (!debug_objects_enabled
)
813 dbgdir
= debugfs_create_dir("debug_objects", NULL
);
817 dbgstats
= debugfs_create_file("stats", 0444, dbgdir
, NULL
,
825 debugfs_remove(dbgdir
);
829 __initcall(debug_objects_init_debugfs
);
832 static inline void debug_objects_init_debugfs(void) { }
835 #ifdef CONFIG_DEBUG_OBJECTS_SELFTEST
837 /* Random data structure for the self test */
839 unsigned long dummy1
[6];
841 unsigned long dummy2
[3];
844 static __initdata
struct debug_obj_descr descr_type_test
;
846 static bool __init
is_static_object(void *addr
)
848 struct self_test
*obj
= addr
;
850 return obj
->static_init
;
854 * fixup_init is called when:
855 * - an active object is initialized
857 static bool __init
fixup_init(void *addr
, enum debug_obj_state state
)
859 struct self_test
*obj
= addr
;
862 case ODEBUG_STATE_ACTIVE
:
863 debug_object_deactivate(obj
, &descr_type_test
);
864 debug_object_init(obj
, &descr_type_test
);
872 * fixup_activate is called when:
873 * - an active object is activated
874 * - an unknown non-static object is activated
876 static bool __init
fixup_activate(void *addr
, enum debug_obj_state state
)
878 struct self_test
*obj
= addr
;
881 case ODEBUG_STATE_NOTAVAILABLE
:
883 case ODEBUG_STATE_ACTIVE
:
884 debug_object_deactivate(obj
, &descr_type_test
);
885 debug_object_activate(obj
, &descr_type_test
);
894 * fixup_destroy is called when:
895 * - an active object is destroyed
897 static bool __init
fixup_destroy(void *addr
, enum debug_obj_state state
)
899 struct self_test
*obj
= addr
;
902 case ODEBUG_STATE_ACTIVE
:
903 debug_object_deactivate(obj
, &descr_type_test
);
904 debug_object_destroy(obj
, &descr_type_test
);
912 * fixup_free is called when:
913 * - an active object is freed
915 static bool __init
fixup_free(void *addr
, enum debug_obj_state state
)
917 struct self_test
*obj
= addr
;
920 case ODEBUG_STATE_ACTIVE
:
921 debug_object_deactivate(obj
, &descr_type_test
);
922 debug_object_free(obj
, &descr_type_test
);
930 check_results(void *addr
, enum debug_obj_state state
, int fixups
, int warnings
)
932 struct debug_bucket
*db
;
933 struct debug_obj
*obj
;
937 db
= get_bucket((unsigned long) addr
);
939 raw_spin_lock_irqsave(&db
->lock
, flags
);
941 obj
= lookup_object(addr
, db
);
942 if (!obj
&& state
!= ODEBUG_STATE_NONE
) {
943 WARN(1, KERN_ERR
"ODEBUG: selftest object not found\n");
946 if (obj
&& obj
->state
!= state
) {
947 WARN(1, KERN_ERR
"ODEBUG: selftest wrong state: %d != %d\n",
951 if (fixups
!= debug_objects_fixups
) {
952 WARN(1, KERN_ERR
"ODEBUG: selftest fixups failed %d != %d\n",
953 fixups
, debug_objects_fixups
);
956 if (warnings
!= debug_objects_warnings
) {
957 WARN(1, KERN_ERR
"ODEBUG: selftest warnings failed %d != %d\n",
958 warnings
, debug_objects_warnings
);
963 raw_spin_unlock_irqrestore(&db
->lock
, flags
);
965 debug_objects_enabled
= 0;
969 static __initdata
struct debug_obj_descr descr_type_test
= {
971 .is_static_object
= is_static_object
,
972 .fixup_init
= fixup_init
,
973 .fixup_activate
= fixup_activate
,
974 .fixup_destroy
= fixup_destroy
,
975 .fixup_free
= fixup_free
,
978 static __initdata
struct self_test obj
= { .static_init
= 0 };
980 static void __init
debug_objects_selftest(void)
982 int fixups
, oldfixups
, warnings
, oldwarnings
;
985 local_irq_save(flags
);
987 fixups
= oldfixups
= debug_objects_fixups
;
988 warnings
= oldwarnings
= debug_objects_warnings
;
989 descr_test
= &descr_type_test
;
991 debug_object_init(&obj
, &descr_type_test
);
992 if (check_results(&obj
, ODEBUG_STATE_INIT
, fixups
, warnings
))
994 debug_object_activate(&obj
, &descr_type_test
);
995 if (check_results(&obj
, ODEBUG_STATE_ACTIVE
, fixups
, warnings
))
997 debug_object_activate(&obj
, &descr_type_test
);
998 if (check_results(&obj
, ODEBUG_STATE_ACTIVE
, ++fixups
, ++warnings
))
1000 debug_object_deactivate(&obj
, &descr_type_test
);
1001 if (check_results(&obj
, ODEBUG_STATE_INACTIVE
, fixups
, warnings
))
1003 debug_object_destroy(&obj
, &descr_type_test
);
1004 if (check_results(&obj
, ODEBUG_STATE_DESTROYED
, fixups
, warnings
))
1006 debug_object_init(&obj
, &descr_type_test
);
1007 if (check_results(&obj
, ODEBUG_STATE_DESTROYED
, fixups
, ++warnings
))
1009 debug_object_activate(&obj
, &descr_type_test
);
1010 if (check_results(&obj
, ODEBUG_STATE_DESTROYED
, fixups
, ++warnings
))
1012 debug_object_deactivate(&obj
, &descr_type_test
);
1013 if (check_results(&obj
, ODEBUG_STATE_DESTROYED
, fixups
, ++warnings
))
1015 debug_object_free(&obj
, &descr_type_test
);
1016 if (check_results(&obj
, ODEBUG_STATE_NONE
, fixups
, warnings
))
1019 obj
.static_init
= 1;
1020 debug_object_activate(&obj
, &descr_type_test
);
1021 if (check_results(&obj
, ODEBUG_STATE_ACTIVE
, fixups
, warnings
))
1023 debug_object_init(&obj
, &descr_type_test
);
1024 if (check_results(&obj
, ODEBUG_STATE_INIT
, ++fixups
, ++warnings
))
1026 debug_object_free(&obj
, &descr_type_test
);
1027 if (check_results(&obj
, ODEBUG_STATE_NONE
, fixups
, warnings
))
1030 #ifdef CONFIG_DEBUG_OBJECTS_FREE
1031 debug_object_init(&obj
, &descr_type_test
);
1032 if (check_results(&obj
, ODEBUG_STATE_INIT
, fixups
, warnings
))
1034 debug_object_activate(&obj
, &descr_type_test
);
1035 if (check_results(&obj
, ODEBUG_STATE_ACTIVE
, fixups
, warnings
))
1037 __debug_check_no_obj_freed(&obj
, sizeof(obj
));
1038 if (check_results(&obj
, ODEBUG_STATE_NONE
, ++fixups
, ++warnings
))
1041 pr_info("selftest passed\n");
1044 debug_objects_fixups
= oldfixups
;
1045 debug_objects_warnings
= oldwarnings
;
1048 local_irq_restore(flags
);
1051 static inline void debug_objects_selftest(void) { }
1055 * Called during early boot to initialize the hash buckets and link
1056 * the static object pool objects into the poll list. After this call
1057 * the object tracker is fully operational.
1059 void __init
debug_objects_early_init(void)
1063 for (i
= 0; i
< ODEBUG_HASH_SIZE
; i
++)
1064 raw_spin_lock_init(&obj_hash
[i
].lock
);
1066 for (i
= 0; i
< ODEBUG_POOL_SIZE
; i
++)
1067 hlist_add_head(&obj_static_pool
[i
].node
, &obj_pool
);
1071 * Convert the statically allocated objects to dynamic ones:
1073 static int __init
debug_objects_replace_static_objects(void)
1075 struct debug_bucket
*db
= obj_hash
;
1076 struct hlist_node
*tmp
;
1077 struct debug_obj
*obj
, *new;
1078 HLIST_HEAD(objects
);
1081 for (i
= 0; i
< ODEBUG_POOL_SIZE
; i
++) {
1082 obj
= kmem_cache_zalloc(obj_cache
, GFP_KERNEL
);
1085 kmemleak_ignore(obj
);
1086 hlist_add_head(&obj
->node
, &objects
);
1090 * When debug_objects_mem_init() is called we know that only
1091 * one CPU is up, so disabling interrupts is enough
1092 * protection. This avoids the lockdep hell of lock ordering.
1094 local_irq_disable();
1096 /* Remove the statically allocated objects from the pool */
1097 hlist_for_each_entry_safe(obj
, tmp
, &obj_pool
, node
)
1098 hlist_del(&obj
->node
);
1099 /* Move the allocated objects to the pool */
1100 hlist_move_list(&objects
, &obj_pool
);
1102 /* Replace the active object references */
1103 for (i
= 0; i
< ODEBUG_HASH_SIZE
; i
++, db
++) {
1104 hlist_move_list(&db
->list
, &objects
);
1106 hlist_for_each_entry(obj
, &objects
, node
) {
1107 new = hlist_entry(obj_pool
.first
, typeof(*obj
), node
);
1108 hlist_del(&new->node
);
1109 /* copy object data */
1111 hlist_add_head(&new->node
, &db
->list
);
1117 pr_debug("%d of %d active objects replaced\n",
1118 cnt
, obj_pool_used
);
1121 hlist_for_each_entry_safe(obj
, tmp
, &objects
, node
) {
1122 hlist_del(&obj
->node
);
1123 kmem_cache_free(obj_cache
, obj
);
1129 * Called after the kmem_caches are functional to setup a dedicated
1130 * cache pool, which has the SLAB_DEBUG_OBJECTS flag set. This flag
1131 * prevents that the debug code is called on kmem_cache_free() for the
1132 * debug tracker objects to avoid recursive calls.
1134 void __init
debug_objects_mem_init(void)
1136 if (!debug_objects_enabled
)
1139 obj_cache
= kmem_cache_create("debug_objects_cache",
1140 sizeof (struct debug_obj
), 0,
1141 SLAB_DEBUG_OBJECTS
, NULL
);
1143 if (!obj_cache
|| debug_objects_replace_static_objects()) {
1144 debug_objects_enabled
= 0;
1146 kmem_cache_destroy(obj_cache
);
1147 pr_warn("out of memory.\n");
1149 debug_objects_selftest();
1152 * Increase the thresholds for allocating and freeing objects
1153 * according to the number of possible CPUs available in the system.
1155 debug_objects_pool_size
+= num_possible_cpus() * 32;
1156 debug_objects_pool_min_level
+= num_possible_cpus() * 4;