diff options
Diffstat (limited to 'static/freebsd/man4/dtrace_pid.4 3.html')
| -rw-r--r-- | static/freebsd/man4/dtrace_pid.4 3.html | 142 |
1 files changed, 0 insertions, 142 deletions
diff --git a/static/freebsd/man4/dtrace_pid.4 3.html b/static/freebsd/man4/dtrace_pid.4 3.html deleted file mode 100644 index 1940d840..00000000 --- a/static/freebsd/man4/dtrace_pid.4 3.html +++ /dev/null @@ -1,142 +0,0 @@ -<table class="head"> - <tr> - <td class="head-ltitle">DTRACE_PID(4)</td> - <td class="head-vol">Device Drivers Manual</td> - <td class="head-rtitle">DTRACE_PID(4)</td> - </tr> -</table> -<div class="manual-text"> -<section class="Sh"> -<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1> -<p class="Pp"><code class="Nm">dtrace_pid</code> — <span class="Nd">a - DTrace provider for dynamic userspace tracing based on function boundary - instrumentation</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> -<table class="Nm"> - <tr> - <td><code class="Nm">pid<var class="Ar">PID</var><code class="Cm">:</code><var class="Ar">module</var><code class="Cm">:</code><var class="Ar">function</var><code class="Cm">:entry</code></code></td> - <td></td> - </tr> -</table> -<br/> -<table class="Nm"> - <tr> - <td><code class="Nm">pid<var class="Ar">PID</var><code class="Cm">:</code><var class="Ar">module</var><code class="Cm">:</code><var class="Ar">function</var><code class="Cm">:</code><span class="No">[</span><var class="Ar">offset</var><span class="No">]</span></code></td> - <td></td> - </tr> -</table> -<br/> -<table class="Nm"> - <tr> - <td><code class="Nm">pid<var class="Ar">PID</var><code class="Cm">:</code><var class="Ar">module</var><code class="Cm">:</code><var class="Ar">function</var><code class="Cm">:return</code></code></td> - <td></td> - </tr> -</table> -</section> -<section class="Sh"> -<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> -<p class="Pp">The <code class="Nm">pid</code> provider implements userspace - dynamic tracing by instrumenting the entry and return of functions in - userspace programs. Refer to <a class="Xr">dtrace_fbt(4)</a> for more - details about function boundary instrumentation.</p> -<p class="Pp">The <code class="Nm">pid</code> provider provides the following - probes:</p> -<dl class="Bl-inset"> - <dt><code class="Nm">pid</code><var class="Ar">PID</var><code class="Cm">:</code><var class="Ar">module</var><code class="Cm">:</code><var class="Ar">function</var><code class="Cm">:entry</code></dt> - <dd>instruments the entry of the <var class="Ar">function</var>.</dd> - <dt><code class="Nm">pid</code><var class="Ar">PID</var><code class="Cm">:</code><var class="Ar">module</var><code class="Cm">:</code><var class="Ar">function</var><code class="Cm">:</code>[<var class="Ar">offset</var>]</dt> - <dd>instruments the instruction within the <var class="Ar">function</var> - located at <var class="Ar">offset</var> bytes (expressed as a hexadecimal - integer).</dd> - <dt><code class="Nm">pid</code><var class="Ar">PID</var><code class="Cm">:</code><var class="Ar">module</var><code class="Cm">:</code><var class="Ar">function</var><code class="Cm">:return</code></dt> - <dd>instruments the return from the <var class="Ar">function</var>.</dd> -</dl> -<section class="Ss"> -<h2 class="Ss" id="Probe_Arguments"><a class="permalink" href="#Probe_Arguments">Probe - Arguments</a></h2> -<p class="Pp">The arguments of the entry probe - (<code class="Nm">pid</code><var class="Ar">PID</var><code class="Cm">:</code><var class="Ar">module</var><code class="Cm">:</code><var class="Ar">function</var><code class="Cm">:entry</code>) - are the arguments of the traced function call.</p> -<table class="Bl-column Bd-indent"> - <tr id="Entry"> - <td><a class="permalink" href="#Entry"><b class="Sy">Entry Probe - Argument</b></a></td> - <td><a class="permalink" href="#Definition"><b class="Sy" id="Definition">Definition</b></a></td> - </tr> - <tr> - <td><var class="Ft">uint64_t</var> <var class="Fa">arg0</var></td> - <td>Function's first argument</td> - </tr> - <tr> - <td><var class="Ft">uint64_t</var> <var class="Fa">arg1</var></td> - <td>Function's second argument</td> - </tr> - <tr> - <td><var class="Ft">uint64_t</var> <var class="Fa">arg2</var></td> - <td>Function's third argument</td> - </tr> - <tr> - <td><var class="Fa">...</var></td> - <td>...</td> - </tr> -</table> -<p class="Pp">The offset probes - (<code class="Nm">pid</code><var class="Ar">PID</var><code class="Cm">:</code><var class="Ar">module</var><code class="Cm">:</code><var class="Ar">function</var><code class="Cm">:</code>[<var class="Ar">offset</var>]) - do not define any arguments. Use <var class="Va">uregs[]</var> to inspect - the registers.</p> -<p class="Pp">The arguments of the return probe - (<code class="Nm">pid</code><var class="Ar">PID</var><code class="Cm">:</code><var class="Ar">module</var><code class="Cm">:</code><var class="Ar">function</var><code class="Cm">:return</code>) - are the program counter and the function's return value.</p> -<table class="Bl-column Bd-indent"> - <tr id="Return"> - <td><a class="permalink" href="#Return"><b class="Sy">Return Probe - Argument</b></a></td> - <td><a class="permalink" href="#Definition~2"><b class="Sy" id="Definition~2">Definition</b></a></td> - </tr> - <tr> - <td><var class="Ft">uint64_t</var> <var class="Fa">arg0</var></td> - <td>Program counter</td> - </tr> - <tr> - <td><var class="Ft">uint64_t</var> <var class="Fa">arg1</var></td> - <td>Function's return value</td> - </tr> -</table> -<p class="Pp">Note that all probe arguments within the - <code class="Nm">pid</code> provider are of type - <var class="Ft">uint64_t</var>.</p> -</section> -</section> -<section class="Sh"> -<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE - ALSO</a></h1> -<p class="Pp"><a class="Xr">dtrace(1)</a>, <a class="Xr">dtrace_fbt(4)</a>, - <a class="Xr">dtrace_kinst(4)</a>, <a class="Xr">elf(5)</a>, - <a class="Xr">d(7)</a>, <a class="Xr">tracing(7)</a></p> -<p class="Pp"><cite class="Rs"><span class="RsA">Brendan Gregg</span> and - <span class="RsA">Jim Mauro</span>, <i class="RsB">DTrace: Dynamic Tracing - in Oracle Solaris, Mac OS X and FreeBSD</i>, <i class="RsI">Prentice - Hall</i>, - <a class="RsU" href="https://www.brendangregg.com/dtracebook/">https://www.brendangregg.com/dtracebook/</a>, - <span class="RsD">2011</span>.</cite></p> -<p class="Pp"><cite class="Rs"><i class="RsB">The illumos Dynamic Tracing - Guide</i>, - <a class="RsU" href="https://illumos.org/books/dtrace/chp-pid.html">https://illumos.org/books/dtrace/chp-pid.html</a>, - <span class="RsD">2008</span>, <span class="RsO">Chapter pid - Provider</span>.</cite></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1> -<p class="Pp">This manual page was written by <span class="An">Mateusz - Piotrowski</span> - <<a class="Mt" href="mailto:0mp@FreeBSD.org">0mp@FreeBSD.org</a>>.</p> -</section> -</div> -<table class="foot"> - <tr> - <td class="foot-date">November 6, 2025</td> - <td class="foot-os">FreeBSD 15.0</td> - </tr> -</table> |