1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>debug_object_destroy</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="debug_object_deactivate.html" title="debug_object_deactivate"><link rel="next" href="debug_object_free.html" title="debug_object_free"></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_destroy</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="debug_object_deactivate.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_free.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_destroy"></a>debug_object_destroy</h2></div></div></div><p>
2	This function is called to mark an object destroyed. This is
3	useful to prevent the usage of invalid objects, which are
4	still available in memory: either statically allocated objects
5	or objects which are freed later.
6      </p><p>
7	When the real object is tracked by debugobjects it is checked,
8	whether the object can be destroyed. Destruction is not
9	allowed for active and destroyed objects. When debugobjects
10	detects an error, then it calls the fixup_destroy function of
11	the object type description structure if provided by the
12	caller. The fixup function can correct the problem before the
13	real destruction of the object happens. E.g. it can deactivate
14	an active object in order to prevent damage to the subsystem.
15      </p><p>
16	When the destruction is legitimate, then the state of the
17	associated tracker object is set to ODEBUG_STATE_DESTROYED.
18      </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="debug_object_deactivate.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_free.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">debug_object_deactivate&#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_free</td></tr></table></div></body></html>
19