]> git.proxmox.com Git - mirror_ubuntu-jammy-kernel.git/blame - lib/debugobjects.c
debugobjects: Add global free list and the counter
[mirror_ubuntu-jammy-kernel.git] / lib / debugobjects.c
CommitLineData
3ac7fe5a
TG
1/*
2 * Generic infrastructure for lifetime debugging of objects.
3 *
4 * Started by Thomas Gleixner
5 *
6 * Copyright (C) 2008, Thomas Gleixner <tglx@linutronix.de>
7 *
8 * For licencing details see kernel-base/COPYING
9 */
719e4843
FF
10
11#define pr_fmt(fmt) "ODEBUG: " fmt
12
3ac7fe5a
TG
13#include <linux/debugobjects.h>
14#include <linux/interrupt.h>
d43c36dc 15#include <linux/sched.h>
68db0cf1 16#include <linux/sched/task_stack.h>
3ac7fe5a
TG
17#include <linux/seq_file.h>
18#include <linux/debugfs.h>
5a0e3ad6 19#include <linux/slab.h>
3ac7fe5a 20#include <linux/hash.h>
caba4cbb 21#include <linux/kmemleak.h>
3ac7fe5a
TG
22
23#define ODEBUG_HASH_BITS 14
24#define ODEBUG_HASH_SIZE (1 << ODEBUG_HASH_BITS)
25
0b6ec8c0 26#define ODEBUG_POOL_SIZE 1024
3ac7fe5a
TG
27#define ODEBUG_POOL_MIN_LEVEL 256
28
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))
32
33struct debug_bucket {
34 struct hlist_head list;
aef9cb05 35 raw_spinlock_t lock;
3ac7fe5a
TG
36};
37
38static struct debug_bucket obj_hash[ODEBUG_HASH_SIZE];
39
1be1cb7b 40static struct debug_obj obj_static_pool[ODEBUG_POOL_SIZE] __initdata;
3ac7fe5a 41
aef9cb05 42static DEFINE_RAW_SPINLOCK(pool_lock);
3ac7fe5a
TG
43
44static HLIST_HEAD(obj_pool);
36c4ead6 45static HLIST_HEAD(obj_to_free);
3ac7fe5a
TG
46
47static int obj_pool_min_free = ODEBUG_POOL_SIZE;
48static int obj_pool_free = ODEBUG_POOL_SIZE;
49static int obj_pool_used;
50static int obj_pool_max_used;
36c4ead6
YS
51/* The number of objs on the global free list */
52static int obj_nr_tofree;
3ac7fe5a
TG
53static struct kmem_cache *obj_cache;
54
55static int debug_objects_maxchain __read_mostly;
bd9dcd04 56static int debug_objects_maxchecked __read_mostly;
3ac7fe5a
TG
57static int debug_objects_fixups __read_mostly;
58static int debug_objects_warnings __read_mostly;
3ae70205
IM
59static int debug_objects_enabled __read_mostly
60 = CONFIG_DEBUG_OBJECTS_ENABLE_DEFAULT;
97dd552e
WL
61static int debug_objects_pool_size __read_mostly
62 = ODEBUG_POOL_SIZE;
63static int debug_objects_pool_min_level __read_mostly
64 = ODEBUG_POOL_MIN_LEVEL;
3ac7fe5a
TG
65static struct debug_obj_descr *descr_test __read_mostly;
66
c4b73aab 67/*
0cad93c3 68 * Track numbers of kmem_cache_alloc()/free() calls done.
c4b73aab 69 */
0cad93c3 70static int debug_objects_allocated;
c4b73aab
WL
71static int debug_objects_freed;
72
337fff8b
TG
73static void free_obj_work(struct work_struct *work);
74static DECLARE_WORK(debug_obj_work, free_obj_work);
75
3ac7fe5a
TG
76static int __init enable_object_debug(char *str)
77{
78 debug_objects_enabled = 1;
79 return 0;
80}
3e8ebb5c
KM
81
82static int __init disable_object_debug(char *str)
83{
84 debug_objects_enabled = 0;
85 return 0;
86}
87
3ac7fe5a 88early_param("debug_objects", enable_object_debug);
3e8ebb5c 89early_param("no_debug_objects", disable_object_debug);
3ac7fe5a
TG
90
91static const char *obj_states[ODEBUG_STATE_MAX] = {
92 [ODEBUG_STATE_NONE] = "none",
93 [ODEBUG_STATE_INIT] = "initialized",
94 [ODEBUG_STATE_INACTIVE] = "inactive",
95 [ODEBUG_STATE_ACTIVE] = "active",
96 [ODEBUG_STATE_DESTROYED] = "destroyed",
97 [ODEBUG_STATE_NOTAVAILABLE] = "not available",
98};
99
1fda107d 100static void fill_pool(void)
3ac7fe5a
TG
101{
102 gfp_t gfp = GFP_ATOMIC | __GFP_NORETRY | __GFP_NOWARN;
36c4ead6 103 struct debug_obj *new, *obj;
50db04dd 104 unsigned long flags;
3ac7fe5a 105
97dd552e 106 if (likely(obj_pool_free >= debug_objects_pool_min_level))
1fda107d 107 return;
3ac7fe5a 108
36c4ead6
YS
109 /*
110 * Reuse objs from the global free list; they will be reinitialized
111 * when allocating.
112 */
113 while (obj_nr_tofree && (obj_pool_free < obj_pool_min_free)) {
114 raw_spin_lock_irqsave(&pool_lock, flags);
115 /*
116 * Recheck with the lock held as the worker thread might have
117 * won the race and freed the global free list already.
118 */
119 if (obj_nr_tofree) {
120 obj = hlist_entry(obj_to_free.first, typeof(*obj), node);
121 hlist_del(&obj->node);
122 obj_nr_tofree--;
123 hlist_add_head(&obj->node, &obj_pool);
124 obj_pool_free++;
125 }
126 raw_spin_unlock_irqrestore(&pool_lock, flags);
127 }
128
3ac7fe5a 129 if (unlikely(!obj_cache))
1fda107d 130 return;
3ac7fe5a 131
97dd552e 132 while (obj_pool_free < debug_objects_pool_min_level) {
3ac7fe5a
TG
133
134 new = kmem_cache_zalloc(obj_cache, gfp);
135 if (!new)
3340808c 136 return;
3ac7fe5a 137
caba4cbb 138 kmemleak_ignore(new);
aef9cb05 139 raw_spin_lock_irqsave(&pool_lock, flags);
3ac7fe5a 140 hlist_add_head(&new->node, &obj_pool);
0cad93c3 141 debug_objects_allocated++;
3ac7fe5a 142 obj_pool_free++;
aef9cb05 143 raw_spin_unlock_irqrestore(&pool_lock, flags);
3ac7fe5a 144 }
3ac7fe5a
TG
145}
146
147/*
148 * Lookup an object in the hash bucket.
149 */
150static struct debug_obj *lookup_object(void *addr, struct debug_bucket *b)
151{
3ac7fe5a
TG
152 struct debug_obj *obj;
153 int cnt = 0;
154
b67bfe0d 155 hlist_for_each_entry(obj, &b->list, node) {
3ac7fe5a
TG
156 cnt++;
157 if (obj->object == addr)
158 return obj;
159 }
160 if (cnt > debug_objects_maxchain)
161 debug_objects_maxchain = cnt;
162
163 return NULL;
164}
165
166/*
50db04dd 167 * Allocate a new object. If the pool is empty, switch off the debugger.
673d62cc 168 * Must be called with interrupts disabled.
3ac7fe5a
TG
169 */
170static struct debug_obj *
171alloc_object(void *addr, struct debug_bucket *b, struct debug_obj_descr *descr)
172{
173 struct debug_obj *obj = NULL;
3ac7fe5a 174
aef9cb05 175 raw_spin_lock(&pool_lock);
3ac7fe5a
TG
176 if (obj_pool.first) {
177 obj = hlist_entry(obj_pool.first, typeof(*obj), node);
178
179 obj->object = addr;
180 obj->descr = descr;
181 obj->state = ODEBUG_STATE_NONE;
a5d8e467 182 obj->astate = 0;
3ac7fe5a
TG
183 hlist_del(&obj->node);
184
185 hlist_add_head(&obj->node, &b->list);
186
187 obj_pool_used++;
188 if (obj_pool_used > obj_pool_max_used)
189 obj_pool_max_used = obj_pool_used;
190
191 obj_pool_free--;
192 if (obj_pool_free < obj_pool_min_free)
193 obj_pool_min_free = obj_pool_free;
194 }
aef9cb05 195 raw_spin_unlock(&pool_lock);
3ac7fe5a 196
3ac7fe5a
TG
197 return obj;
198}
199
200/*
337fff8b 201 * workqueue function to free objects.
858274b6
WL
202 *
203 * To reduce contention on the global pool_lock, the actual freeing of
204 * debug objects will be delayed if the pool_lock is busy. We also free
205 * the objects in a batch of 4 for each lock/unlock cycle.
3ac7fe5a 206 */
858274b6
WL
207#define ODEBUG_FREE_BATCH 4
208
337fff8b 209static void free_obj_work(struct work_struct *work)
3ac7fe5a 210{
858274b6 211 struct debug_obj *objs[ODEBUG_FREE_BATCH];
36c4ead6
YS
212 struct hlist_node *tmp;
213 struct debug_obj *obj;
673d62cc 214 unsigned long flags;
858274b6 215 int i;
36c4ead6 216 HLIST_HEAD(tofree);
3ac7fe5a 217
858274b6
WL
218 if (!raw_spin_trylock_irqsave(&pool_lock, flags))
219 return;
36c4ead6
YS
220
221 /*
222 * The objs on the pool list might be allocated before the work is
223 * run, so recheck if pool list it full or not, if not fill pool
224 * list from the global free list
225 */
226 while (obj_nr_tofree && obj_pool_free < debug_objects_pool_size) {
227 obj = hlist_entry(obj_to_free.first, typeof(*obj), node);
228 hlist_del(&obj->node);
229 hlist_add_head(&obj->node, &obj_pool);
230 obj_pool_free++;
231 obj_nr_tofree--;
232 }
233
234 /*
235 * Pool list is already full and there are still objs on the free
236 * list. Move remaining free objs to a temporary list to free the
237 * memory outside the pool_lock held region.
238 */
239 if (obj_nr_tofree) {
240 hlist_move_list(&obj_to_free, &tofree);
241 obj_nr_tofree = 0;
242 }
243
858274b6
WL
244 while (obj_pool_free >= debug_objects_pool_size + ODEBUG_FREE_BATCH) {
245 for (i = 0; i < ODEBUG_FREE_BATCH; i++) {
246 objs[i] = hlist_entry(obj_pool.first,
247 typeof(*objs[0]), node);
248 hlist_del(&objs[i]->node);
249 }
250
251 obj_pool_free -= ODEBUG_FREE_BATCH;
252 debug_objects_freed += ODEBUG_FREE_BATCH;
337fff8b
TG
253 /*
254 * We release pool_lock across kmem_cache_free() to
255 * avoid contention on pool_lock.
256 */
aef9cb05 257 raw_spin_unlock_irqrestore(&pool_lock, flags);
858274b6
WL
258 for (i = 0; i < ODEBUG_FREE_BATCH; i++)
259 kmem_cache_free(obj_cache, objs[i]);
260 if (!raw_spin_trylock_irqsave(&pool_lock, flags))
261 return;
3ac7fe5a 262 }
aef9cb05 263 raw_spin_unlock_irqrestore(&pool_lock, flags);
36c4ead6
YS
264
265 hlist_for_each_entry_safe(obj, tmp, &tofree, node) {
266 hlist_del(&obj->node);
267 kmem_cache_free(obj_cache, obj);
268 }
337fff8b
TG
269}
270
271/*
272 * Put the object back into the pool and schedule work to free objects
273 * if necessary.
274 */
275static void free_object(struct debug_obj *obj)
276{
277 unsigned long flags;
278 int sched = 0;
279
aef9cb05 280 raw_spin_lock_irqsave(&pool_lock, flags);
337fff8b
TG
281 /*
282 * schedule work when the pool is filled and the cache is
283 * initialized:
284 */
97dd552e 285 if (obj_pool_free > debug_objects_pool_size && obj_cache)
7092dff2 286 sched = 1;
337fff8b
TG
287 hlist_add_head(&obj->node, &obj_pool);
288 obj_pool_free++;
289 obj_pool_used--;
aef9cb05 290 raw_spin_unlock_irqrestore(&pool_lock, flags);
337fff8b
TG
291 if (sched)
292 schedule_work(&debug_obj_work);
3ac7fe5a
TG
293}
294
295/*
296 * We run out of memory. That means we probably have tons of objects
297 * allocated.
298 */
299static void debug_objects_oom(void)
300{
301 struct debug_bucket *db = obj_hash;
b67bfe0d 302 struct hlist_node *tmp;
673d62cc 303 HLIST_HEAD(freelist);
3ac7fe5a
TG
304 struct debug_obj *obj;
305 unsigned long flags;
306 int i;
307
719e4843 308 pr_warn("Out of memory. ODEBUG disabled\n");
3ac7fe5a
TG
309
310 for (i = 0; i < ODEBUG_HASH_SIZE; i++, db++) {
aef9cb05 311 raw_spin_lock_irqsave(&db->lock, flags);
673d62cc 312 hlist_move_list(&db->list, &freelist);
aef9cb05 313 raw_spin_unlock_irqrestore(&db->lock, flags);
673d62cc
VN
314
315 /* Now free them */
b67bfe0d 316 hlist_for_each_entry_safe(obj, tmp, &freelist, node) {
3ac7fe5a
TG
317 hlist_del(&obj->node);
318 free_object(obj);
319 }
3ac7fe5a
TG
320 }
321}
322
323/*
324 * We use the pfn of the address for the hash. That way we can check
325 * for freed objects simply by checking the affected bucket.
326 */
327static struct debug_bucket *get_bucket(unsigned long addr)
328{
329 unsigned long hash;
330
331 hash = hash_long((addr >> ODEBUG_CHUNK_SHIFT), ODEBUG_HASH_BITS);
332 return &obj_hash[hash];
333}
334
335static void debug_print_object(struct debug_obj *obj, char *msg)
336{
99777288 337 struct debug_obj_descr *descr = obj->descr;
3ac7fe5a
TG
338 static int limit;
339
99777288
SG
340 if (limit < 5 && descr != descr_test) {
341 void *hint = descr->debug_hint ?
342 descr->debug_hint(obj->object) : NULL;
3ac7fe5a 343 limit++;
a5d8e467 344 WARN(1, KERN_ERR "ODEBUG: %s %s (active state %u) "
99777288 345 "object type: %s hint: %pS\n",
a5d8e467 346 msg, obj_states[obj->state], obj->astate,
99777288 347 descr->name, hint);
3ac7fe5a
TG
348 }
349 debug_objects_warnings++;
350}
351
352/*
353 * Try to repair the damage, so we have a better chance to get useful
354 * debug output.
355 */
b1e4d9d8
CD
356static bool
357debug_object_fixup(bool (*fixup)(void *addr, enum debug_obj_state state),
3ac7fe5a
TG
358 void * addr, enum debug_obj_state state)
359{
b1e4d9d8
CD
360 if (fixup && fixup(addr, state)) {
361 debug_objects_fixups++;
362 return true;
363 }
364 return false;
3ac7fe5a
TG
365}
366
367static void debug_object_is_on_stack(void *addr, int onstack)
368{
3ac7fe5a
TG
369 int is_on_stack;
370 static int limit;
371
372 if (limit > 4)
373 return;
374
8b05c7e6 375 is_on_stack = object_is_on_stack(addr);
3ac7fe5a
TG
376 if (is_on_stack == onstack)
377 return;
378
379 limit++;
380 if (is_on_stack)
719e4843 381 pr_warn("object is on stack, but not annotated\n");
3ac7fe5a 382 else
719e4843 383 pr_warn("object is not on stack, but annotated\n");
3ac7fe5a
TG
384 WARN_ON(1);
385}
386
387static void
388__debug_object_init(void *addr, struct debug_obj_descr *descr, int onstack)
389{
390 enum debug_obj_state state;
391 struct debug_bucket *db;
392 struct debug_obj *obj;
393 unsigned long flags;
394
50db04dd
VN
395 fill_pool();
396
3ac7fe5a
TG
397 db = get_bucket((unsigned long) addr);
398
aef9cb05 399 raw_spin_lock_irqsave(&db->lock, flags);
3ac7fe5a
TG
400
401 obj = lookup_object(addr, db);
402 if (!obj) {
403 obj = alloc_object(addr, db, descr);
404 if (!obj) {
405 debug_objects_enabled = 0;
aef9cb05 406 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a
TG
407 debug_objects_oom();
408 return;
409 }
410 debug_object_is_on_stack(addr, onstack);
411 }
412
413 switch (obj->state) {
414 case ODEBUG_STATE_NONE:
415 case ODEBUG_STATE_INIT:
416 case ODEBUG_STATE_INACTIVE:
417 obj->state = ODEBUG_STATE_INIT;
418 break;
419
420 case ODEBUG_STATE_ACTIVE:
421 debug_print_object(obj, "init");
422 state = obj->state;
aef9cb05 423 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a
TG
424 debug_object_fixup(descr->fixup_init, addr, state);
425 return;
426
427 case ODEBUG_STATE_DESTROYED:
428 debug_print_object(obj, "init");
429 break;
430 default:
431 break;
432 }
433
aef9cb05 434 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a
TG
435}
436
437/**
438 * debug_object_init - debug checks when an object is initialized
439 * @addr: address of the object
440 * @descr: pointer to an object specific debug description structure
441 */
442void debug_object_init(void *addr, struct debug_obj_descr *descr)
443{
444 if (!debug_objects_enabled)
445 return;
446
447 __debug_object_init(addr, descr, 0);
448}
f8ff04e2 449EXPORT_SYMBOL_GPL(debug_object_init);
3ac7fe5a
TG
450
451/**
452 * debug_object_init_on_stack - debug checks when an object on stack is
453 * initialized
454 * @addr: address of the object
455 * @descr: pointer to an object specific debug description structure
456 */
457void debug_object_init_on_stack(void *addr, struct debug_obj_descr *descr)
458{
459 if (!debug_objects_enabled)
460 return;
461
462 __debug_object_init(addr, descr, 1);
463}
f8ff04e2 464EXPORT_SYMBOL_GPL(debug_object_init_on_stack);
3ac7fe5a
TG
465
466/**
467 * debug_object_activate - debug checks when an object is activated
468 * @addr: address of the object
469 * @descr: pointer to an object specific debug description structure
b778ae25 470 * Returns 0 for success, -EINVAL for check failed.
3ac7fe5a 471 */
b778ae25 472int debug_object_activate(void *addr, struct debug_obj_descr *descr)
3ac7fe5a
TG
473{
474 enum debug_obj_state state;
475 struct debug_bucket *db;
476 struct debug_obj *obj;
477 unsigned long flags;
b778ae25 478 int ret;
feac18dd
SB
479 struct debug_obj o = { .object = addr,
480 .state = ODEBUG_STATE_NOTAVAILABLE,
481 .descr = descr };
3ac7fe5a
TG
482
483 if (!debug_objects_enabled)
b778ae25 484 return 0;
3ac7fe5a
TG
485
486 db = get_bucket((unsigned long) addr);
487
aef9cb05 488 raw_spin_lock_irqsave(&db->lock, flags);
3ac7fe5a
TG
489
490 obj = lookup_object(addr, db);
491 if (obj) {
492 switch (obj->state) {
493 case ODEBUG_STATE_INIT:
494 case ODEBUG_STATE_INACTIVE:
495 obj->state = ODEBUG_STATE_ACTIVE;
b778ae25 496 ret = 0;
3ac7fe5a
TG
497 break;
498
499 case ODEBUG_STATE_ACTIVE:
500 debug_print_object(obj, "activate");
501 state = obj->state;
aef9cb05 502 raw_spin_unlock_irqrestore(&db->lock, flags);
b778ae25 503 ret = debug_object_fixup(descr->fixup_activate, addr, state);
e7a8e78b 504 return ret ? 0 : -EINVAL;
3ac7fe5a
TG
505
506 case ODEBUG_STATE_DESTROYED:
507 debug_print_object(obj, "activate");
b778ae25 508 ret = -EINVAL;
3ac7fe5a
TG
509 break;
510 default:
b778ae25 511 ret = 0;
3ac7fe5a
TG
512 break;
513 }
aef9cb05 514 raw_spin_unlock_irqrestore(&db->lock, flags);
b778ae25 515 return ret;
3ac7fe5a
TG
516 }
517
aef9cb05 518 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a 519 /*
b9fdac7f
CD
520 * We are here when a static object is activated. We
521 * let the type specific code confirm whether this is
522 * true or not. if true, we just make sure that the
523 * static object is tracked in the object tracker. If
524 * not, this must be a bug, so we try to fix it up.
3ac7fe5a 525 */
b9fdac7f
CD
526 if (descr->is_static_object && descr->is_static_object(addr)) {
527 /* track this static object */
528 debug_object_init(addr, descr);
529 debug_object_activate(addr, descr);
530 } else {
feac18dd 531 debug_print_object(&o, "activate");
b9fdac7f
CD
532 ret = debug_object_fixup(descr->fixup_activate, addr,
533 ODEBUG_STATE_NOTAVAILABLE);
534 return ret ? 0 : -EINVAL;
b778ae25
PM
535 }
536 return 0;
3ac7fe5a 537}
f8ff04e2 538EXPORT_SYMBOL_GPL(debug_object_activate);
3ac7fe5a
TG
539
540/**
541 * debug_object_deactivate - debug checks when an object is deactivated
542 * @addr: address of the object
543 * @descr: pointer to an object specific debug description structure
544 */
545void debug_object_deactivate(void *addr, struct debug_obj_descr *descr)
546{
547 struct debug_bucket *db;
548 struct debug_obj *obj;
549 unsigned long flags;
550
551 if (!debug_objects_enabled)
552 return;
553
554 db = get_bucket((unsigned long) addr);
555
aef9cb05 556 raw_spin_lock_irqsave(&db->lock, flags);
3ac7fe5a
TG
557
558 obj = lookup_object(addr, db);
559 if (obj) {
560 switch (obj->state) {
561 case ODEBUG_STATE_INIT:
562 case ODEBUG_STATE_INACTIVE:
563 case ODEBUG_STATE_ACTIVE:
a5d8e467
MD
564 if (!obj->astate)
565 obj->state = ODEBUG_STATE_INACTIVE;
566 else
567 debug_print_object(obj, "deactivate");
3ac7fe5a
TG
568 break;
569
570 case ODEBUG_STATE_DESTROYED:
571 debug_print_object(obj, "deactivate");
572 break;
573 default:
574 break;
575 }
576 } else {
577 struct debug_obj o = { .object = addr,
578 .state = ODEBUG_STATE_NOTAVAILABLE,
579 .descr = descr };
580
581 debug_print_object(&o, "deactivate");
582 }
583
aef9cb05 584 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a 585}
f8ff04e2 586EXPORT_SYMBOL_GPL(debug_object_deactivate);
3ac7fe5a
TG
587
588/**
589 * debug_object_destroy - debug checks when an object is destroyed
590 * @addr: address of the object
591 * @descr: pointer to an object specific debug description structure
592 */
593void debug_object_destroy(void *addr, struct debug_obj_descr *descr)
594{
595 enum debug_obj_state state;
596 struct debug_bucket *db;
597 struct debug_obj *obj;
598 unsigned long flags;
599
600 if (!debug_objects_enabled)
601 return;
602
603 db = get_bucket((unsigned long) addr);
604
aef9cb05 605 raw_spin_lock_irqsave(&db->lock, flags);
3ac7fe5a
TG
606
607 obj = lookup_object(addr, db);
608 if (!obj)
609 goto out_unlock;
610
611 switch (obj->state) {
612 case ODEBUG_STATE_NONE:
613 case ODEBUG_STATE_INIT:
614 case ODEBUG_STATE_INACTIVE:
615 obj->state = ODEBUG_STATE_DESTROYED;
616 break;
617 case ODEBUG_STATE_ACTIVE:
618 debug_print_object(obj, "destroy");
619 state = obj->state;
aef9cb05 620 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a
TG
621 debug_object_fixup(descr->fixup_destroy, addr, state);
622 return;
623
624 case ODEBUG_STATE_DESTROYED:
625 debug_print_object(obj, "destroy");
626 break;
627 default:
628 break;
629 }
630out_unlock:
aef9cb05 631 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a 632}
f8ff04e2 633EXPORT_SYMBOL_GPL(debug_object_destroy);
3ac7fe5a
TG
634
635/**
636 * debug_object_free - debug checks when an object is freed
637 * @addr: address of the object
638 * @descr: pointer to an object specific debug description structure
639 */
640void debug_object_free(void *addr, struct debug_obj_descr *descr)
641{
642 enum debug_obj_state state;
643 struct debug_bucket *db;
644 struct debug_obj *obj;
645 unsigned long flags;
646
647 if (!debug_objects_enabled)
648 return;
649
650 db = get_bucket((unsigned long) addr);
651
aef9cb05 652 raw_spin_lock_irqsave(&db->lock, flags);
3ac7fe5a
TG
653
654 obj = lookup_object(addr, db);
655 if (!obj)
656 goto out_unlock;
657
658 switch (obj->state) {
659 case ODEBUG_STATE_ACTIVE:
660 debug_print_object(obj, "free");
661 state = obj->state;
aef9cb05 662 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a
TG
663 debug_object_fixup(descr->fixup_free, addr, state);
664 return;
665 default:
666 hlist_del(&obj->node);
aef9cb05 667 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a 668 free_object(obj);
673d62cc 669 return;
3ac7fe5a
TG
670 }
671out_unlock:
aef9cb05 672 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a 673}
f8ff04e2 674EXPORT_SYMBOL_GPL(debug_object_free);
3ac7fe5a 675
b84d435c
CC
676/**
677 * debug_object_assert_init - debug checks when object should be init-ed
678 * @addr: address of the object
679 * @descr: pointer to an object specific debug description structure
680 */
681void debug_object_assert_init(void *addr, struct debug_obj_descr *descr)
682{
683 struct debug_bucket *db;
684 struct debug_obj *obj;
685 unsigned long flags;
686
687 if (!debug_objects_enabled)
688 return;
689
690 db = get_bucket((unsigned long) addr);
691
692 raw_spin_lock_irqsave(&db->lock, flags);
693
694 obj = lookup_object(addr, db);
695 if (!obj) {
696 struct debug_obj o = { .object = addr,
697 .state = ODEBUG_STATE_NOTAVAILABLE,
698 .descr = descr };
699
700 raw_spin_unlock_irqrestore(&db->lock, flags);
701 /*
b9fdac7f
CD
702 * Maybe the object is static, and we let the type specific
703 * code confirm. Track this static object if true, else invoke
704 * fixup.
b84d435c 705 */
b9fdac7f
CD
706 if (descr->is_static_object && descr->is_static_object(addr)) {
707 /* Track this static object */
708 debug_object_init(addr, descr);
709 } else {
b84d435c 710 debug_print_object(&o, "assert_init");
b9fdac7f
CD
711 debug_object_fixup(descr->fixup_assert_init, addr,
712 ODEBUG_STATE_NOTAVAILABLE);
713 }
b84d435c
CC
714 return;
715 }
716
717 raw_spin_unlock_irqrestore(&db->lock, flags);
718}
f8ff04e2 719EXPORT_SYMBOL_GPL(debug_object_assert_init);
b84d435c 720
a5d8e467
MD
721/**
722 * debug_object_active_state - debug checks object usage state machine
723 * @addr: address of the object
724 * @descr: pointer to an object specific debug description structure
725 * @expect: expected state
726 * @next: state to move to if expected state is found
727 */
728void
729debug_object_active_state(void *addr, struct debug_obj_descr *descr,
730 unsigned int expect, unsigned int next)
731{
732 struct debug_bucket *db;
733 struct debug_obj *obj;
734 unsigned long flags;
735
736 if (!debug_objects_enabled)
737 return;
738
739 db = get_bucket((unsigned long) addr);
740
741 raw_spin_lock_irqsave(&db->lock, flags);
742
743 obj = lookup_object(addr, db);
744 if (obj) {
745 switch (obj->state) {
746 case ODEBUG_STATE_ACTIVE:
747 if (obj->astate == expect)
748 obj->astate = next;
749 else
750 debug_print_object(obj, "active_state");
751 break;
752
753 default:
754 debug_print_object(obj, "active_state");
755 break;
756 }
757 } else {
758 struct debug_obj o = { .object = addr,
759 .state = ODEBUG_STATE_NOTAVAILABLE,
760 .descr = descr };
761
762 debug_print_object(&o, "active_state");
763 }
764
765 raw_spin_unlock_irqrestore(&db->lock, flags);
766}
f8ff04e2 767EXPORT_SYMBOL_GPL(debug_object_active_state);
a5d8e467 768
3ac7fe5a
TG
769#ifdef CONFIG_DEBUG_OBJECTS_FREE
770static void __debug_check_no_obj_freed(const void *address, unsigned long size)
771{
772 unsigned long flags, oaddr, saddr, eaddr, paddr, chunks;
b67bfe0d 773 struct hlist_node *tmp;
673d62cc 774 HLIST_HEAD(freelist);
3ac7fe5a
TG
775 struct debug_obj_descr *descr;
776 enum debug_obj_state state;
777 struct debug_bucket *db;
778 struct debug_obj *obj;
bd9dcd04 779 int cnt, objs_checked = 0;
3ac7fe5a
TG
780
781 saddr = (unsigned long) address;
782 eaddr = saddr + size;
783 paddr = saddr & ODEBUG_CHUNK_MASK;
784 chunks = ((eaddr - paddr) + (ODEBUG_CHUNK_SIZE - 1));
785 chunks >>= ODEBUG_CHUNK_SHIFT;
786
787 for (;chunks > 0; chunks--, paddr += ODEBUG_CHUNK_SIZE) {
788 db = get_bucket(paddr);
789
790repeat:
791 cnt = 0;
aef9cb05 792 raw_spin_lock_irqsave(&db->lock, flags);
b67bfe0d 793 hlist_for_each_entry_safe(obj, tmp, &db->list, node) {
3ac7fe5a
TG
794 cnt++;
795 oaddr = (unsigned long) obj->object;
796 if (oaddr < saddr || oaddr >= eaddr)
797 continue;
798
799 switch (obj->state) {
800 case ODEBUG_STATE_ACTIVE:
801 debug_print_object(obj, "free");
802 descr = obj->descr;
803 state = obj->state;
aef9cb05 804 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a
TG
805 debug_object_fixup(descr->fixup_free,
806 (void *) oaddr, state);
807 goto repeat;
808 default:
809 hlist_del(&obj->node);
673d62cc 810 hlist_add_head(&obj->node, &freelist);
3ac7fe5a
TG
811 break;
812 }
813 }
aef9cb05 814 raw_spin_unlock_irqrestore(&db->lock, flags);
673d62cc
VN
815
816 /* Now free them */
b67bfe0d 817 hlist_for_each_entry_safe(obj, tmp, &freelist, node) {
673d62cc
VN
818 hlist_del(&obj->node);
819 free_object(obj);
820 }
821
3ac7fe5a
TG
822 if (cnt > debug_objects_maxchain)
823 debug_objects_maxchain = cnt;
bd9dcd04
YS
824
825 objs_checked += cnt;
3ac7fe5a 826 }
bd9dcd04
YS
827
828 if (objs_checked > debug_objects_maxchecked)
829 debug_objects_maxchecked = objs_checked;
3ac7fe5a
TG
830}
831
832void debug_check_no_obj_freed(const void *address, unsigned long size)
833{
834 if (debug_objects_enabled)
835 __debug_check_no_obj_freed(address, size);
836}
837#endif
838
839#ifdef CONFIG_DEBUG_FS
840
841static int debug_stats_show(struct seq_file *m, void *v)
842{
843 seq_printf(m, "max_chain :%d\n", debug_objects_maxchain);
bd9dcd04 844 seq_printf(m, "max_checked :%d\n", debug_objects_maxchecked);
3ac7fe5a
TG
845 seq_printf(m, "warnings :%d\n", debug_objects_warnings);
846 seq_printf(m, "fixups :%d\n", debug_objects_fixups);
847 seq_printf(m, "pool_free :%d\n", obj_pool_free);
848 seq_printf(m, "pool_min_free :%d\n", obj_pool_min_free);
849 seq_printf(m, "pool_used :%d\n", obj_pool_used);
850 seq_printf(m, "pool_max_used :%d\n", obj_pool_max_used);
36c4ead6 851 seq_printf(m, "on_free_list :%d\n", obj_nr_tofree);
0cad93c3
WL
852 seq_printf(m, "objs_allocated:%d\n", debug_objects_allocated);
853 seq_printf(m, "objs_freed :%d\n", debug_objects_freed);
3ac7fe5a
TG
854 return 0;
855}
856
857static int debug_stats_open(struct inode *inode, struct file *filp)
858{
859 return single_open(filp, debug_stats_show, NULL);
860}
861
862static const struct file_operations debug_stats_fops = {
863 .open = debug_stats_open,
864 .read = seq_read,
865 .llseek = seq_lseek,
866 .release = single_release,
867};
868
869static int __init debug_objects_init_debugfs(void)
870{
871 struct dentry *dbgdir, *dbgstats;
872
873 if (!debug_objects_enabled)
874 return 0;
875
876 dbgdir = debugfs_create_dir("debug_objects", NULL);
877 if (!dbgdir)
878 return -ENOMEM;
879
880 dbgstats = debugfs_create_file("stats", 0444, dbgdir, NULL,
881 &debug_stats_fops);
882 if (!dbgstats)
883 goto err;
884
885 return 0;
886
887err:
888 debugfs_remove(dbgdir);
889
890 return -ENOMEM;
891}
892__initcall(debug_objects_init_debugfs);
893
894#else
895static inline void debug_objects_init_debugfs(void) { }
896#endif
897
898#ifdef CONFIG_DEBUG_OBJECTS_SELFTEST
899
900/* Random data structure for the self test */
901struct self_test {
902 unsigned long dummy1[6];
903 int static_init;
904 unsigned long dummy2[3];
905};
906
907static __initdata struct debug_obj_descr descr_type_test;
908
b9fdac7f
CD
909static bool __init is_static_object(void *addr)
910{
911 struct self_test *obj = addr;
912
913 return obj->static_init;
914}
915
3ac7fe5a
TG
916/*
917 * fixup_init is called when:
918 * - an active object is initialized
919 */
b1e4d9d8 920static bool __init fixup_init(void *addr, enum debug_obj_state state)
3ac7fe5a
TG
921{
922 struct self_test *obj = addr;
923
924 switch (state) {
925 case ODEBUG_STATE_ACTIVE:
926 debug_object_deactivate(obj, &descr_type_test);
927 debug_object_init(obj, &descr_type_test);
b1e4d9d8 928 return true;
3ac7fe5a 929 default:
b1e4d9d8 930 return false;
3ac7fe5a
TG
931 }
932}
933
934/*
935 * fixup_activate is called when:
936 * - an active object is activated
b9fdac7f 937 * - an unknown non-static object is activated
3ac7fe5a 938 */
b1e4d9d8 939static bool __init fixup_activate(void *addr, enum debug_obj_state state)
3ac7fe5a
TG
940{
941 struct self_test *obj = addr;
942
943 switch (state) {
944 case ODEBUG_STATE_NOTAVAILABLE:
b1e4d9d8 945 return true;
3ac7fe5a
TG
946 case ODEBUG_STATE_ACTIVE:
947 debug_object_deactivate(obj, &descr_type_test);
948 debug_object_activate(obj, &descr_type_test);
b1e4d9d8 949 return true;
3ac7fe5a
TG
950
951 default:
b1e4d9d8 952 return false;
3ac7fe5a
TG
953 }
954}
955
956/*
957 * fixup_destroy is called when:
958 * - an active object is destroyed
959 */
b1e4d9d8 960static bool __init fixup_destroy(void *addr, enum debug_obj_state state)
3ac7fe5a
TG
961{
962 struct self_test *obj = addr;
963
964 switch (state) {
965 case ODEBUG_STATE_ACTIVE:
966 debug_object_deactivate(obj, &descr_type_test);
967 debug_object_destroy(obj, &descr_type_test);
b1e4d9d8 968 return true;
3ac7fe5a 969 default:
b1e4d9d8 970 return false;
3ac7fe5a
TG
971 }
972}
973
974/*
975 * fixup_free is called when:
976 * - an active object is freed
977 */
b1e4d9d8 978static bool __init fixup_free(void *addr, enum debug_obj_state state)
3ac7fe5a
TG
979{
980 struct self_test *obj = addr;
981
982 switch (state) {
983 case ODEBUG_STATE_ACTIVE:
984 debug_object_deactivate(obj, &descr_type_test);
985 debug_object_free(obj, &descr_type_test);
b1e4d9d8 986 return true;
3ac7fe5a 987 default:
b1e4d9d8 988 return false;
3ac7fe5a
TG
989 }
990}
991
1fb2f77c 992static int __init
3ac7fe5a
TG
993check_results(void *addr, enum debug_obj_state state, int fixups, int warnings)
994{
995 struct debug_bucket *db;
996 struct debug_obj *obj;
997 unsigned long flags;
998 int res = -EINVAL;
999
1000 db = get_bucket((unsigned long) addr);
1001
aef9cb05 1002 raw_spin_lock_irqsave(&db->lock, flags);
3ac7fe5a
TG
1003
1004 obj = lookup_object(addr, db);
1005 if (!obj && state != ODEBUG_STATE_NONE) {
5cd2b459 1006 WARN(1, KERN_ERR "ODEBUG: selftest object not found\n");
3ac7fe5a
TG
1007 goto out;
1008 }
1009 if (obj && obj->state != state) {
5cd2b459 1010 WARN(1, KERN_ERR "ODEBUG: selftest wrong state: %d != %d\n",
3ac7fe5a 1011 obj->state, state);
3ac7fe5a
TG
1012 goto out;
1013 }
1014 if (fixups != debug_objects_fixups) {
5cd2b459 1015 WARN(1, KERN_ERR "ODEBUG: selftest fixups failed %d != %d\n",
3ac7fe5a 1016 fixups, debug_objects_fixups);
3ac7fe5a
TG
1017 goto out;
1018 }
1019 if (warnings != debug_objects_warnings) {
5cd2b459 1020 WARN(1, KERN_ERR "ODEBUG: selftest warnings failed %d != %d\n",
3ac7fe5a 1021 warnings, debug_objects_warnings);
3ac7fe5a
TG
1022 goto out;
1023 }
1024 res = 0;
1025out:
aef9cb05 1026 raw_spin_unlock_irqrestore(&db->lock, flags);
3ac7fe5a
TG
1027 if (res)
1028 debug_objects_enabled = 0;
1029 return res;
1030}
1031
1032static __initdata struct debug_obj_descr descr_type_test = {
1033 .name = "selftest",
b9fdac7f 1034 .is_static_object = is_static_object,
3ac7fe5a
TG
1035 .fixup_init = fixup_init,
1036 .fixup_activate = fixup_activate,
1037 .fixup_destroy = fixup_destroy,
1038 .fixup_free = fixup_free,
1039};
1040
1041static __initdata struct self_test obj = { .static_init = 0 };
1042
1043static void __init debug_objects_selftest(void)
1044{
1045 int fixups, oldfixups, warnings, oldwarnings;
1046 unsigned long flags;
1047
1048 local_irq_save(flags);
1049
1050 fixups = oldfixups = debug_objects_fixups;
1051 warnings = oldwarnings = debug_objects_warnings;
1052 descr_test = &descr_type_test;
1053
1054 debug_object_init(&obj, &descr_type_test);
1055 if (check_results(&obj, ODEBUG_STATE_INIT, fixups, warnings))
1056 goto out;
1057 debug_object_activate(&obj, &descr_type_test);
1058 if (check_results(&obj, ODEBUG_STATE_ACTIVE, fixups, warnings))
1059 goto out;
1060 debug_object_activate(&obj, &descr_type_test);
1061 if (check_results(&obj, ODEBUG_STATE_ACTIVE, ++fixups, ++warnings))
1062 goto out;
1063 debug_object_deactivate(&obj, &descr_type_test);
1064 if (check_results(&obj, ODEBUG_STATE_INACTIVE, fixups, warnings))
1065 goto out;
1066 debug_object_destroy(&obj, &descr_type_test);
1067 if (check_results(&obj, ODEBUG_STATE_DESTROYED, fixups, warnings))
1068 goto out;
1069 debug_object_init(&obj, &descr_type_test);
1070 if (check_results(&obj, ODEBUG_STATE_DESTROYED, fixups, ++warnings))
1071 goto out;
1072 debug_object_activate(&obj, &descr_type_test);
1073 if (check_results(&obj, ODEBUG_STATE_DESTROYED, fixups, ++warnings))
1074 goto out;
1075 debug_object_deactivate(&obj, &descr_type_test);
1076 if (check_results(&obj, ODEBUG_STATE_DESTROYED, fixups, ++warnings))
1077 goto out;
1078 debug_object_free(&obj, &descr_type_test);
1079 if (check_results(&obj, ODEBUG_STATE_NONE, fixups, warnings))
1080 goto out;
1081
1082 obj.static_init = 1;
1083 debug_object_activate(&obj, &descr_type_test);
9f78ff00 1084 if (check_results(&obj, ODEBUG_STATE_ACTIVE, fixups, warnings))
3ac7fe5a
TG
1085 goto out;
1086 debug_object_init(&obj, &descr_type_test);
1087 if (check_results(&obj, ODEBUG_STATE_INIT, ++fixups, ++warnings))
1088 goto out;
1089 debug_object_free(&obj, &descr_type_test);
1090 if (check_results(&obj, ODEBUG_STATE_NONE, fixups, warnings))
1091 goto out;
1092
1093#ifdef CONFIG_DEBUG_OBJECTS_FREE
1094 debug_object_init(&obj, &descr_type_test);
1095 if (check_results(&obj, ODEBUG_STATE_INIT, fixups, warnings))
1096 goto out;
1097 debug_object_activate(&obj, &descr_type_test);
1098 if (check_results(&obj, ODEBUG_STATE_ACTIVE, fixups, warnings))
1099 goto out;
1100 __debug_check_no_obj_freed(&obj, sizeof(obj));
1101 if (check_results(&obj, ODEBUG_STATE_NONE, ++fixups, ++warnings))
1102 goto out;
1103#endif
719e4843 1104 pr_info("selftest passed\n");
3ac7fe5a
TG
1105
1106out:
1107 debug_objects_fixups = oldfixups;
1108 debug_objects_warnings = oldwarnings;
1109 descr_test = NULL;
1110
1111 local_irq_restore(flags);
1112}
1113#else
1114static inline void debug_objects_selftest(void) { }
1115#endif
1116
1117/*
1118 * Called during early boot to initialize the hash buckets and link
1119 * the static object pool objects into the poll list. After this call
1120 * the object tracker is fully operational.
1121 */
1122void __init debug_objects_early_init(void)
1123{
1124 int i;
1125
1126 for (i = 0; i < ODEBUG_HASH_SIZE; i++)
aef9cb05 1127 raw_spin_lock_init(&obj_hash[i].lock);
3ac7fe5a
TG
1128
1129 for (i = 0; i < ODEBUG_POOL_SIZE; i++)
1130 hlist_add_head(&obj_static_pool[i].node, &obj_pool);
1131}
1132
1be1cb7b
TG
1133/*
1134 * Convert the statically allocated objects to dynamic ones:
1135 */
1fb2f77c 1136static int __init debug_objects_replace_static_objects(void)
1be1cb7b
TG
1137{
1138 struct debug_bucket *db = obj_hash;
b67bfe0d 1139 struct hlist_node *tmp;
1be1cb7b
TG
1140 struct debug_obj *obj, *new;
1141 HLIST_HEAD(objects);
1142 int i, cnt = 0;
1143
1144 for (i = 0; i < ODEBUG_POOL_SIZE; i++) {
1145 obj = kmem_cache_zalloc(obj_cache, GFP_KERNEL);
1146 if (!obj)
1147 goto free;
caba4cbb 1148 kmemleak_ignore(obj);
1be1cb7b
TG
1149 hlist_add_head(&obj->node, &objects);
1150 }
1151
1152 /*
1153 * When debug_objects_mem_init() is called we know that only
1154 * one CPU is up, so disabling interrupts is enough
1155 * protection. This avoids the lockdep hell of lock ordering.
1156 */
1157 local_irq_disable();
1158
1159 /* Remove the statically allocated objects from the pool */
b67bfe0d 1160 hlist_for_each_entry_safe(obj, tmp, &obj_pool, node)
1be1cb7b
TG
1161 hlist_del(&obj->node);
1162 /* Move the allocated objects to the pool */
1163 hlist_move_list(&objects, &obj_pool);
1164
1165 /* Replace the active object references */
1166 for (i = 0; i < ODEBUG_HASH_SIZE; i++, db++) {
1167 hlist_move_list(&db->list, &objects);
1168
b67bfe0d 1169 hlist_for_each_entry(obj, &objects, node) {
1be1cb7b
TG
1170 new = hlist_entry(obj_pool.first, typeof(*obj), node);
1171 hlist_del(&new->node);
1172 /* copy object data */
1173 *new = *obj;
1174 hlist_add_head(&new->node, &db->list);
1175 cnt++;
1176 }
1177 }
765a5e0c 1178 local_irq_enable();
1be1cb7b 1179
c0f35cc0
FF
1180 pr_debug("%d of %d active objects replaced\n",
1181 cnt, obj_pool_used);
1be1cb7b
TG
1182 return 0;
1183free:
b67bfe0d 1184 hlist_for_each_entry_safe(obj, tmp, &objects, node) {
1be1cb7b
TG
1185 hlist_del(&obj->node);
1186 kmem_cache_free(obj_cache, obj);
1187 }
1188 return -ENOMEM;
1189}
1190
3ac7fe5a
TG
1191/*
1192 * Called after the kmem_caches are functional to setup a dedicated
1193 * cache pool, which has the SLAB_DEBUG_OBJECTS flag set. This flag
1194 * prevents that the debug code is called on kmem_cache_free() for the
1195 * debug tracker objects to avoid recursive calls.
1196 */
1197void __init debug_objects_mem_init(void)
1198{
1199 if (!debug_objects_enabled)
1200 return;
1201
1202 obj_cache = kmem_cache_create("debug_objects_cache",
1203 sizeof (struct debug_obj), 0,
1204 SLAB_DEBUG_OBJECTS, NULL);
1205
1be1cb7b 1206 if (!obj_cache || debug_objects_replace_static_objects()) {
3ac7fe5a 1207 debug_objects_enabled = 0;
1be1cb7b
TG
1208 if (obj_cache)
1209 kmem_cache_destroy(obj_cache);
719e4843 1210 pr_warn("out of memory.\n");
1be1cb7b 1211 } else
3ac7fe5a 1212 debug_objects_selftest();
97dd552e
WL
1213
1214 /*
1215 * Increase the thresholds for allocating and freeing objects
1216 * according to the number of possible CPUs available in the system.
1217 */
1218 debug_objects_pool_size += num_possible_cpus() * 32;
1219 debug_objects_pool_min_level += num_possible_cpus() * 4;
3ac7fe5a 1220}