<?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>struct utrace_engine</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="The utrace User Debugging Infrastructure" /><link rel="up" href="ch02.html" title="Chapter 2. utrace core API" /><link rel="prev" href="re06.html" title="utrace_syscall_action" /><link rel="next" href="re08.html" title="utrace_engine_get" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>struct utrace_engine</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re06.html">Prev</a> </td><th width="60%" align="center">Chapter 2. utrace core API</th><td width="20%" align="right"> <a accesskey="n" href="re08.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="struct utrace_engine"><a id="API-struct-utrace-engine"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>struct utrace_engine —
per-engine structure
</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
struct utrace_engine {
const struct utrace_engine_ops * ops;
void * data;
unsigned long flags;
}; </pre></div><div class="refsect1" title="Members"><a id="id3096336"></a><h2>Members</h2><div class="variablelist"><dl><dt><span class="term">ops</span></dt><dd><p>
<span class="structname">struct utrace_engine_ops</span> pointer passed to <code class="function">utrace_attach_task</code>
</p></dd><dt><span class="term">data</span></dt><dd><p>
engine-private <span class="structname">void</span> * passed to <code class="function">utrace_attach_task</code>
</p></dd><dt><span class="term">flags</span></dt><dd><p>
event mask set by <code class="function">utrace_set_events</code> plus internal flag bits
</p></dd></dl></div></div><div class="refsect1" title="Description"><a id="id3096401"></a><h2>Description</h2><p>
The task itself never has to worry about engines detaching while
it's doing event callbacks. These structures are removed from the
task's active list only when it's stopped, or by the task itself.
</p><p>
<code class="function">utrace_engine_get</code> and <code class="function">utrace_engine_put</code> maintain a reference count.
When it drops to zero, the structure is freed. One reference is held
implicitly while the engine is attached to its task.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re06.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re08.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>utrace_syscall_action</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>utrace_engine_get</span></td></tr></table></div></body></html>
