<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>debug_object_free</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /><link rel="home" href="index.html" title="Debug objects life time" /><link rel="up" href="debugfunctions.html" title="Chapter 3. Debug functions" /><link rel="prev" href="debug_object_destroy.html" title="debug_object_destroy" /><link rel="next" href="fixupfunctions.html" title="Chapter 4. Fixup functions" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">debug_object_free</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="debug_object_destroy.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Debug functions</th><td width="20%" align="right"> <a accesskey="n" href="fixupfunctions.html">Next</a></td></tr></table><hr /></div><div class="sect1" title="debug_object_free"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="debug_object_free"></a>debug_object_free</h2></div></div></div><p>
This function is called before an object is freed.
</p><p>
When the real object is tracked by debugobjects it is checked,
whether the object can be freed. Free is not allowed for
active objects. When debugobjects detects an error, then it
calls the fixup_free function of the object type description
structure if provided by the caller. The fixup function can
correct the problem before the real free of the object
happens. E.g. it can deactivate an active object in order to
prevent damage to the subsystem.
</p><p>
Note that debug_object_free removes the object from the
tracker. Later usage of the object is detected by the other
debug checks.
</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="debug_object_destroy.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="debugfunctions.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="fixupfunctions.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">debug_object_destroy </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 4. Fixup functions</td></tr></table></div></body></html>
