#ifndef _LINUX_DEBUGOBJECTS_H
#define _LINUX_DEBUGOBJECTS_H

#include <linux/list.h>
#include <linux/spinlock.h>

enum debug_obj_state {
	ODEBUG_STATE_NONE,
	ODEBUG_STATE_INIT,
	ODEBUG_STATE_INACTIVE,
	ODEBUG_STATE_ACTIVE,
	ODEBUG_STATE_DESTROYED,
	ODEBUG_STATE_NOTAVAILABLE,
	ODEBUG_STATE_MAX,
};

struct debug_obj_descr;

/**
 * struct debug_obj - representaion of an tracked object
 * @node:	hlist node to link the object into the tracker list
 * @state:	tracked object state
 * @astate:	current active state
 * @object:	pointer to the real object
 * @descr:	pointer to an object type specific debug description structure
 */
struct debug_obj {
	struct hlist_node	node;
	enum debug_obj_state	state;
	unsigned int		astate;
	void			*object;
	struct debug_obj_descr	*descr;
};

/**
 * struct debug_obj_descr - object type specific debug description structure
 *
 * @name:		name of the object typee
 * @debug_hint:		function returning address, which have associated
 *			kernel symbol, to allow identify the object
 * @fixup_init:		fixup function, which is called when the init check
 *			fails
 * @fixup_activate:	fixup function, which is called when the activate check
 *			fails
 * @fixup_destroy:	fixup function, which is called when the destroy check
 *			fails
 * @fixup_free:		fixup function, which is called when the free check
 *			fails
 * @fixup_assert_init:  fixup function, which is called when the assert_init
 *			check fails
 */
struct debug_obj_descr {
	const char		*name;
	void *(*debug_hint)	(void *addr);
	int (*fixup_init)	(void *addr, enum debug_obj_state state);
	int (*fixup_activate)	(void *addr, enum debug_obj_state state);
	int (*fixup_destroy)	(void *addr, enum debug_obj_state state);
	int (*fixup_free)	(void *addr, enum debug_obj_state state);
	int (*fixup_assert_init)(void *addr, enum debug_obj_state state);
};

#ifdef CONFIG_DEBUG_OBJECTS
extern void debug_object_init      (void *addr, struct debug_obj_descr *descr);
extern void
debug_object_init_on_stack(void *addr, struct debug_obj_descr *descr);
extern void debug_object_activate  (void *addr, struct debug_obj_descr *descr);
extern void debug_object_deactivate(void *addr, struct debug_obj_descr *descr);
extern void debug_object_destroy   (void *addr, struct debug_obj_descr *descr);
extern void debug_object_free      (void *addr, struct debug_obj_descr *descr);
extern void debug_object_assert_init(void *addr, struct debug_obj_descr *descr);

/*
 * Active state:
 * - Set at 0 upon initialization.
 * - Must return to 0 before deactivation.
 */
extern void
debug_object_active_state(void *addr, struct debug_obj_descr *descr,
			  unsigned int expect, unsigned int next);

extern void debug_objects_early_init(void);
extern void debug_objects_mem_init(void);
#else
static inline void
debug_object_init      (void *addr, struct debug_obj_descr *descr) { }
static inline void
debug_object_init_on_stack(void *addr, struct debug_obj_descr *descr) { }
static inline void
debug_object_activate  (void *addr, struct debug_obj_descr *descr) { }
static inline void
debug_object_deactivate(void *addr, struct debug_obj_descr *descr) { }
static inline void
debug_object_destroy   (void *addr, struct debug_obj_descr *descr) { }
static inline void
debug_object_free      (void *addr, struct debug_obj_descr *descr) { }
static inline void
debug_object_assert_init(void *addr, struct debug_obj_descr *descr) { }

static inline void debug_objects_early_init(void) { }
static inline void debug_objects_mem_init(void) { }
#endif

#ifdef CONFIG_DEBUG_OBJECTS_FREE
extern void debug_check_no_obj_freed(const void *address, unsigned long size);
#else
static inline void
debug_check_no_obj_freed(const void *address, unsigned long size) { }
#endif

#endif
><a href='/drm-misc/commit/init/Makefile?id=2d7ce49f58dc95495b3e22e45d2be7de909b2c63'>x86/retpoline: Make sure there are no unconverted return thunks due to KCSAN</a></td><td>Josh Poimboeuf</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2023-06-25 23:12:20 +0900'>2023-06-25</span></td><td><a href='/drm-misc/commit/init/Makefile?id=ddf56288eebd1fe82c46fc9f693b5b18045cddb6'>kbuild: Fix CFI failures with GCOV</a></td><td>Sami Tolvanen</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2023-01-13 15:22:03 -0800'>2023-01-13</span></td><td><a href='/drm-misc/commit/init/Makefile?id=42633ed852deadc14d44660ad71e2f6640239120'>kbuild: Fix CFI hash randomization with KASAN</a></td><td>Sami Tolvanen</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2022-09-29 04:40:15 +0900'>2022-09-29</span></td><td><a href='/drm-misc/commit/init/Makefile?id=a55f283e8b473a3124705934a17d0ad61e34e6c1'>kbuild: generate include/generated/compile.h in top Makefile</a></td><td>Masahiro Yamada</td><td>1</td><td><span class='deletions'>-7</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2022-09-29 04:40:15 +0900'>2022-09-29</span></td><td><a href='/drm-misc/commit/init/Makefile?id=2df8220cc511326508ec4da2f43ef69311bdd7b9'>kbuild: build init/built-in.a just once</a></td><td>Masahiro Yamada</td><td>1</td><td><span class='deletions'>-13</span>/<span class='insertions'>+42</span></td></tr>
<tr><td><span title='2022-03-11 15:36:35 +0100'>2022-03-11</span></td><td><a href='/drm-misc/commit/init/Makefile?id=a0a7e453b502cbbf7ff372f907a4e27a2ebf5445'>sched/preempt: Tell about PREEMPT_DYNAMIC on kernel headers</a></td><td>Frederic Weisbecker</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+2</span></td></tr>
<tr><td><span title='2022-01-08 18:03:57 +0900'>2022-01-08</span></td><td><a href='/drm-misc/commit/init/Makefile?id=129ab0d2d9f38b9d43df35235fc66c6740d6928b'>kbuild: do not quote string values in include/config/auto.conf</a></td><td>Masahiro Yamada</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2021-11-11 13:09:33 +0100'>2021-11-11</span></td><td><a href='/drm-misc/commit/init/Makefile?id=a8b76910e465d718effce0cad306a21fa4f3526b'>preempt: Restore preemption model selection configs</a></td><td>Valentin Schneider</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2021-05-27 04:01:50 +0900'>2021-05-27</span></td><td><a href='/drm-misc/commit/init/Makefile?id=41eba23efba38b2bc4c33e3c00441e196ebdac55'>init: use $(call cmd,) for generating include/generated/compile.h</a></td><td>Masahiro Yamada</td><td>1</td><td><span class='deletions'>-6</span>/<span class='insertions'>+6</span></td></tr>
<tr><td><span title='2020-07-16 15:34:47 +0200'>2020-07-16</span></td><td><a href='/drm-misc/commit/init/Makefile?id=4f5b246b37e024955c0fcca0c7f5952089052d1d'>md: move the early init autodetect code to drivers/md/</a></td><td>Christoph Hellwig</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+0</span></td></tr>
<tr><td><span title='2020-05-12 13:28:33 +0900'>2020-05-12</span></td><td><a href='/drm-misc/commit/init/Makefile?id=9a950154668729a472d17b8e307d92e7c60f45f7'>kbuild: use CONFIG_CC_VERSION_TEXT to construct LINUX_COMPILER macro</a></td><td>Masahiro Yamada</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2020-04-09 00:13:45 +0900'>2020-04-09</span></td><td><a href='/drm-misc/commit/init/Makefile?id=01a6126b5f7efdf75480a2b970377f5724cb885a'>kbuild: do not pass $(KBUILD_CFLAGS) to scripts/mkcompile_h</a></td><td>Masahiro Yamada</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2020-04-09 00:13:45 +0900'>2020-04-09</span></td><td><a href='/drm-misc/commit/init/Makefile?id=4dcc9a88448a65a1e855228917cfbb92ac4b4f45'>kbuild: mkcompile_h: Include $LD version in /proc/version</a></td><td>Kees Cook</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2019-08-14 01:10:42 +0900'>2019-08-14</span></td><td><a href='/drm-misc/commit/init/Makefile?id=4b950bb9ac0c7246dcf75060040577c3de60c166'>Kbuild: Handle PREEMPT_RT for version string and magic</a></td><td>Thomas Gleixner</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+3</span></td></tr>
<tr><td><span title='2018-01-09 23:21:02 +0000'>2018-01-09</span></td><td><a href='/drm-misc/commit/init/Makefile?id=0500871f21b237b2bea2d9db405eadf78e5aab05'>Construct init thread stack in the linker script rather than by union</a></td><td>David Howells</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+0</span></td></tr>
<tr><td><span title='2017-11-02 11:10:55 +0100'>2017-11-02</span></td><td><a href='/drm-misc/commit/init/Makefile?id=b24413180f5600bcb3bb70fbed5cf186b60864bd'>License cleanup: add SPDX GPL-2.0 license identifier to files with no license</a></td><td>Greg Kroah-Hartman</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+1</span></td></tr>
<tr><td><span title='2016-09-09 10:47:00 +0200'>2016-09-09</span></td><td><a href='/drm-misc/commit/init/Makefile?id=b67067f1176df6ee727450546b58704e4b588563'>kbuild: allow archs to select link dead code/data elimination</a></td><td>Nicholas Piggin</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+2</span></td></tr>
<tr><td><span title='2012-05-05 13:00:46 +0200'>2012-05-05</span></td><td><a href='/drm-misc/commit/init/Makefile?id=a6359d1eec43d1fd6ffbac958149844873e0084f'>init_task: Replace CONFIG_HAVE_GENERIC_INIT_TASK</a></td><td>Thomas Gleixner</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+4</span></td></tr>
<tr><td><span title='2012-05-05 13:00:21 +0200'>2012-05-05</span></td><td><a href='/drm-misc/commit/init/Makefile?id=a4a2eb490e38aaff61eafcb8cde6725ad1be22ab'>init_task: Create generic init_task instance</a></td><td>Thomas Gleixner</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+1</span></td></tr>