1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>debug_object_init</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Debug objects life time"><link rel="up" href="debugfunctions.html" title="Chapter&#160;3.&#160;Debug functions"><link rel="prev" href="API-debug-object-active-state.html" title="debug_object_active_state"><link rel="next" href="debug_object_init_on_stack.html" title="debug_object_init_on_stack"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">debug_object_init</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-debug-object-active-state.html">Prev</a>&#160;</td><th width="60%" align="center">Chapter&#160;3.&#160;Debug functions</th><td width="20%" align="right">&#160;<a accesskey="n" href="debug_object_init_on_stack.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="debug_object_init"></a>debug_object_init</h2></div></div></div><p>
2	This function is called whenever the initialization function
3	of a real object is called.
4      </p><p>
5	When the real object is already tracked by debugobjects it is
6	checked, whether the object can be initialized.  Initializing
7	is not allowed for active and destroyed objects. When
8	debugobjects detects an error, then it calls the fixup_init
9	function of the object type description structure if provided
10	by the caller. The fixup function can correct the problem
11	before the real initialization of the object happens. E.g. it
12	can deactivate an active object in order to prevent damage to
13	the subsystem.
14      </p><p>
15	When the real object is not yet tracked by debugobjects,
16	debugobjects allocates a tracker object for the real object
17	and sets the tracker object state to ODEBUG_STATE_INIT. It
18	verifies that the object is not on the callers stack. If it is
19	on the callers stack then a limited number of warnings
20	including a full stack trace is printk'ed. The calling code
21	must use debug_object_init_on_stack() and remove the object
22	before leaving the function which allocated it. See next
23	section.
24      </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-debug-object-active-state.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="debugfunctions.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="debug_object_init_on_stack.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">debug_object_active_state</span>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;debug_object_init_on_stack</td></tr></table></div></body></html>
25