summaryrefslogtreecommitdiff
path: root/static/freebsd/man4/dtrace_kinst.4 3.html
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:59:05 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:59:05 -0400
commit1f19f33e45791ea59aed048796fc68672c6723a5 (patch)
tree54625fba89e91d1c2177801ec635e8528bba937f /static/freebsd/man4/dtrace_kinst.4 3.html
parentac5e55f5f2af5b92794c2aded46c6bae85b5f5ed (diff)
docs: Removed Precompiled HTML
Diffstat (limited to 'static/freebsd/man4/dtrace_kinst.4 3.html')
-rw-r--r--static/freebsd/man4/dtrace_kinst.4 3.html89
1 files changed, 0 insertions, 89 deletions
diff --git a/static/freebsd/man4/dtrace_kinst.4 3.html b/static/freebsd/man4/dtrace_kinst.4 3.html
deleted file mode 100644
index 504cb7c0..00000000
--- a/static/freebsd/man4/dtrace_kinst.4 3.html
+++ /dev/null
@@ -1,89 +0,0 @@
-<table class="head">
- <tr>
- <td class="head-ltitle">DTRACE_KINST(4)</td>
- <td class="head-vol">Device Drivers Manual</td>
- <td class="head-rtitle">DTRACE_KINST(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_kinst</code> &#x2014; <span class="Nd">a
- DTrace provider for tracing arbitrary instructions in a given kernel
- function</span></p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
-<p class="Pp">kinst::&lt;function&gt;:&lt;instruction&gt;</p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
-<p class="Pp">The DTrace <code class="Nm">kinst</code> provider allows the user
- to trace any instruction in a given kernel function. &lt;function&gt;
- corresponds to the function to be traced, and &lt;instruction&gt; is the
- offset to the specific instruction, and can be obtained from the function's
- disassembly using kgdb from the gdb package.</p>
-<p class="Pp"><code class="Nm">kinst</code> creates probes on-demand, meaning it
- searches for and parses the function's instructions each time
- <a class="Xr">dtrace(1)</a> is run, and not at module load time. This is in
- contrast to <a class="Xr">dtrace_fbt(4)</a>'s load-time parsing, since
- <code class="Nm">kinst</code> can potentially create thousands of probes for
- just a single function, instead of up to two (entry and return) in the case
- of <a class="Xr">dtrace_fbt(4)</a>. A result of this is that
- <code class="Cm">dtrace -l -P kinst</code> will not match any probes.</p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="IMPLEMENTATION_NOTES"><a class="permalink" href="#IMPLEMENTATION_NOTES">IMPLEMENTATION
- NOTES</a></h1>
-<p class="Pp">The provider is currently implemented only for amd64.</p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
-<p class="Pp">Find the offset corresponding to the third instruction in
- <code class="Fn">vm_fault</code>() and trace it, printing the contents of
- the RSI register:</p>
-<div class="Bd Pp Bd-indent Li">
-<pre># kgdb
-(kgdb) disas /r vm_fault
-Dump of assembler code for function vm_fault:
- 0xffffffff80876df0 &lt;+0&gt;: 55 push %rbp
- 0xffffffff80876df1 &lt;+1&gt;: 48 89 e5 mov %rsp,%rbp
- 0xffffffff80876df4 &lt;+4&gt;: 41 57 push %r15
-
-# dtrace -n 'kinst::vm_fault:4 {printf(&quot;%#x&quot;, regs[R_RSI]);}'
- 2 81500 vm_fault:4 0x827c56000
- 2 81500 vm_fault:4 0x827878000
- 2 81500 vm_fault:4 0x1fab9bef0000
- 2 81500 vm_fault:4 0xe16cf749000
- 0 81500 vm_fault:4 0x13587c366000
- ...</pre>
-</div>
-<p class="Pp">Trace all instructions in
- <code class="Fn">amd64_syscall</code>():</p>
-<div class="Bd Pp Bd-indent Li">
-<pre># dtrace -n 'kinst::amd64_syscall:'</pre>
-</div>
-</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></p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
-<p class="Pp">The <code class="Nm">kinst</code> provider first appeared in
- <span class="Ux">FreeBSD</span> 14.0.</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">Christos
- Margiolis</span>
- &lt;<a class="Mt" href="mailto:christos@FreeBSD.org">christos@FreeBSD.org</a>&gt;.</p>
-</section>
-</div>
-<table class="foot">
- <tr>
- <td class="foot-date">July 16, 2025</td>
- <td class="foot-os">FreeBSD 15.0</td>
- </tr>
-</table>