Documentation/core-api/debug-objects.rst

2 The object-lifetime debugging infrastructure
15 -  Activation of uninitialized objects
17 -  Initialization of active objects
19 -  Usage of freed/destroyed objects
21 debugobjects is not changing the data structure of the real object so it
39 -  debug_object_init
41 -  debug_object_init_on_stack
43 -  debug_object_activate
45 -  debug_object_deactivate
47 -  debug_object_destroy
49 -  debug_object_free
51 -  debug_object_assert_init
53 Each of these functions takes the address of the real object and a
67 .. kernel-doc:: lib/debugobjects.c
70 This function is called whenever the initialization function of a real
73 When the real object is already tracked by debugobjects it is checked,
78 problem before the real initialization of the object happens. E.g. it
82 When the real object is not yet tracked by debugobjects, debugobjects
83 allocates a tracker object for the real object and sets the tracker
90 .. kernel-doc:: lib/debugobjects.c
93 This function is called whenever the initialization function of a real
96 When the real object is already tracked by debugobjects it is checked,
101 problem before the real initialization of the object happens. E.g. it
105 When the real object is not yet tracked by debugobjects debugobjects
106 allocates a tracker object for the real object and sets the tracker
114 .. kernel-doc:: lib/debugobjects.c
117 This function is called whenever the activation function of a real
120 When the real object is already tracked by debugobjects it is checked,
125 problem before the real activation of the object happens. E.g. it can
128 When the real object is not yet tracked by debugobjects then the
139 .. kernel-doc:: lib/debugobjects.c
142 This function is called whenever the deactivation function of a real
145 When the real object is tracked by debugobjects it is checked, whether
152 .. kernel-doc:: lib/debugobjects.c
160 When the real object is tracked by debugobjects it is checked, whether
165 before the real destruction of the object happens. E.g. it can
171 .. kernel-doc:: lib/debugobjects.c
176 When the real object is tracked by debugobjects it is checked, whether
180 fixup function can correct the problem before the real free of the
188 .. kernel-doc:: lib/debugobjects.c
193 When the real object is not tracked by debugobjects, it calls
199 When the real object is already tracked by debugobjects it is ignored.
205 ---------------------------------------
207 .. kernel-doc:: include/linux/debugobjects.h
211 -----------
219 -  ODEBUG_STATE_ACTIVE
229 ---------------
236 -  ODEBUG_STATE_NOTAVAILABLE
238 -  ODEBUG_STATE_ACTIVE
254 the function should return false because this is not a real fixup.
257 --------------
264 -  ODEBUG_STATE_ACTIVE
270 -----------
280 -  ODEBUG_STATE_ACTIVE
286 -------------------
305 function should return false because this is not a real fixup.