<?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>The utrace User Debugging Infrastructure</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="next" href="ch01.html" title="Chapter 1. utrace concepts" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The utrace User Debugging Infrastructure</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr></table><hr /></div><div class="book" title="The utrace User Debugging Infrastructure"><div class="titlepage"><div><div><h1 class="title"><a id="utrace"></a>The utrace User Debugging Infrastructure</h1></div></div><hr /></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="ch01.html">1. utrace concepts</a></span></dt><dd><dl><dt><span class="sect1"><a href="ch01.html#intro">Introduction</a></span></dt><dt><span class="sect1"><a href="ch01s02.html">Events and Callbacks</a></span></dt><dt><span class="sect1"><a href="ch01s03.html">Stopping Safely</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch01s03.html#well-behaved">Writing well-behaved callbacks</a></span></dt><dt><span class="sect2"><a href="ch01s03.html#UTRACE_STOP">Using <code class="constant">UTRACE_STOP</code></a></span></dt></dl></dd><dt><span class="sect1"><a href="ch01s04.html">Tear-down Races</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch01s04.html#SIGKILL">Primacy of <code class="constant">SIGKILL</code></a></span></dt><dt><span class="sect2"><a href="ch01s04.html#reap">Final callbacks</a></span></dt><dt><span class="sect2"><a href="ch01s04.html#refcount">Engine and task pointers</a></span></dt><dt><span class="sect2"><a href="ch01s04.html#reap-after-death">
Serialization of <code class="constant">DEATH</code> and <code class="constant">REAP</code>
</a></span></dt><dt><span class="sect2"><a href="ch01s04.html#interlock">Interlock with final callbacks</a></span></dt><dt><span class="sect2"><a href="ch01s04.html#barrier">Using <code class="function">utrace_barrier</code></a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch02.html">2. utrace core API</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="re01.html"><span>enum utrace_resume_action</span></a></span><span class="refpurpose"> —
engine's choice of action for a traced task
</span></dt><dt><span class="refentrytitle"><a href="re02.html"><span>utrace_resume_action</span></a></span><span class="refpurpose"> —
<span class="structname">enum</span> utrace_resume_action from callback action
</span></dt><dt><span class="refentrytitle"><a href="re03.html"><span>enum utrace_signal_action</span></a></span><span class="refpurpose"> —
disposition of signal
</span></dt><dt><span class="refentrytitle"><a href="re04.html"><span>utrace_signal_action</span></a></span><span class="refpurpose"> —
<span class="structname">enum</span> utrace_signal_action from callback action
</span></dt><dt><span class="refentrytitle"><a href="re05.html"><span>enum utrace_syscall_action</span></a></span><span class="refpurpose"> —
disposition of system call attempt
</span></dt><dt><span class="refentrytitle"><a href="re06.html"><span>utrace_syscall_action</span></a></span><span class="refpurpose"> —
<span class="structname">enum</span> utrace_syscall_action from callback action
</span></dt><dt><span class="refentrytitle"><a href="re07.html"><span>struct utrace_engine</span></a></span><span class="refpurpose"> —
per-engine structure
</span></dt><dt><span class="refentrytitle"><a href="re08.html"><span>utrace_engine_get</span></a></span><span class="refpurpose"> —
acquire a reference on a <span class="structname">struct utrace_engine</span>
</span></dt><dt><span class="refentrytitle"><a href="re09.html"><span>utrace_engine_put</span></a></span><span class="refpurpose"> —
release a reference on a <span class="structname">struct utrace_engine</span>
</span></dt><dt><span class="refentrytitle"><a href="re10.html"><span>struct utrace_engine_ops</span></a></span><span class="refpurpose"> —
tracing engine callbacks
</span></dt><dt><span class="refentrytitle"><a href="re11.html"><span>struct utrace_examiner</span></a></span><span class="refpurpose"> —
private state for using <code class="function">utrace_prepare_examine</code>
</span></dt><dt><span class="refentrytitle"><a href="re12.html"><span>utrace_control_pid</span></a></span><span class="refpurpose"> —
control a thread being traced by a tracing engine
</span></dt><dt><span class="refentrytitle"><a href="re13.html"><span>utrace_set_events_pid</span></a></span><span class="refpurpose"> —
choose which event reports a tracing engine gets
</span></dt><dt><span class="refentrytitle"><a href="re14.html"><span>utrace_barrier_pid</span></a></span><span class="refpurpose"> —
synchronize with simultaneous tracing callbacks
</span></dt><dt><span class="refentrytitle"><a href="re15.html"><span>utrace_attach_task</span></a></span><span class="refpurpose"> —
attach new engine, or look up an attached engine
</span></dt><dt><span class="refentrytitle"><a href="re16.html"><span>utrace_attach_pid</span></a></span><span class="refpurpose"> —
attach new engine, or look up an attached engine
</span></dt><dt><span class="refentrytitle"><a href="re17.html"><span>utrace_set_events</span></a></span><span class="refpurpose"> —
choose which event reports a tracing engine gets
</span></dt><dt><span class="refentrytitle"><a href="re18.html"><span>utrace_control</span></a></span><span class="refpurpose"> —
control a thread being traced by a tracing engine
</span></dt><dt><span class="refentrytitle"><a href="re19.html"><span>utrace_barrier</span></a></span><span class="refpurpose"> —
synchronize with simultaneous tracing callbacks
</span></dt><dt><span class="refentrytitle"><a href="re20.html"><span>utrace_prepare_examine</span></a></span><span class="refpurpose"> —
prepare to examine thread state
</span></dt><dt><span class="refentrytitle"><a href="re21.html"><span>utrace_finish_examine</span></a></span><span class="refpurpose"> —
complete an examination of thread state
</span></dt></dl></dd><dt><span class="chapter"><a href="ch03.html">3. Machine State</a></span></dt><dd><dl><dt><span class="sect1"><a href="ch03.html#regset"><span class="structname">struct user_regset</span></a></span></dt><dt><span class="sect1"><a href="ch03s02.html"><code class="filename">System Call Information</code></a></span></dt><dt><span class="sect1"><a href="ch03s03.html"><code class="filename">System Call Tracing</code></a></span></dt></dl></dd><dt><span class="chapter"><a href="ch04.html">4. Kernel Internals</a></span></dt><dd><dl><dt><span class="sect1"><a href="ch04.html#tracehook">Core Calls In</a></span></dt><dt><span class="sect1"><a href="ch04s02.html">Architecture Calls Out</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s02.html#arch-ptrace"><code class="filename"><asm/ptrace.h></code></a></span></dt><dt><span class="sect2"><a href="ch04s02.html#arch-syscall"><code class="filename"><asm/syscall.h></code></a></span></dt><dt><span class="sect2"><a href="ch04s02.html#arch-tracehook"><code class="filename"><linux/tracehook.h></code></a></span></dt></dl></dd></dl></dd></dl></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. utrace concepts</td></tr></table></div></body></html>
