diff options
Diffstat (limited to 'static/freebsd/man4/dtrace_priv.4 4.html')
| -rw-r--r-- | static/freebsd/man4/dtrace_priv.4 4.html | 80 |
1 files changed, 80 insertions, 0 deletions
diff --git a/static/freebsd/man4/dtrace_priv.4 4.html b/static/freebsd/man4/dtrace_priv.4 4.html new file mode 100644 index 00000000..6c06cb3a --- /dev/null +++ b/static/freebsd/man4/dtrace_priv.4 4.html @@ -0,0 +1,80 @@ +<table class="head"> + <tr> + <td class="head-ltitle">DTRACE_PRIV(4)</td> + <td class="head-vol">Device Drivers Manual</td> + <td class="head-rtitle">DTRACE_PRIV(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_priv</code> — <span class="Nd">a + DTrace provider for the kernel privilege checking API</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">priv<code class="Cm">:kernel:priv_check:priv-ok</code></code></td> + <td></td> + </tr> +</table> +<br/> +<table class="Nm"> + <tr> + <td><code class="Nm">priv<code class="Cm">:kernel:priv_check:priv-err</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">priv</code> provider allows for tracing the + <a class="Xr">priv(9)</a> API.</p> +<p class="Pp">The + <code class="Nm">priv</code><code class="Cm">:kernel:priv_check:priv-ok</code> + probe fires upon a successful kernel privilege check.</p> +<p class="Pp">The + <code class="Nm">priv</code><code class="Cm">:kernel:priv_check:priv-err</code> + probe fires upon a failed kernel privilege check.</p> +<p class="Pp">The only argument to the <code class="Nm">priv</code> probes, + <var class="Fa">args[0]</var>, is the requested privilege number + <var class="Ft">int priv</var>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1> +<section class="Ss"> +<h2 class="Ss" id="Example_1:_Tracing_Kernel_Privilege_Check_Failures"><a class="permalink" href="#Example_1:_Tracing_Kernel_Privilege_Check_Failures">Example + 1: Tracing Kernel Privilege Check Failures</a></h2> +<p class="Pp">The following script captures an array of counters, one for each + stack trace leading to a failed kernel privilege check:</p> +<div class="Bd Pp Bd-indent Li"> +<pre>priv:::priv-err +{ + @traces[stack()] = count(); +}</pre> +</div> +</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">tracing(7)</a>, + <a class="Xr">priv(9)</a>, <a class="Xr">SDT(9)</a></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1> +<p class="Pp">The <code class="Nm">priv</code> provider was written by + <span class="An">Robert N. M. Watson</span> + <<a class="Mt" href="mailto:rwatson@FreeBSD.org">rwatson@FreeBSD.org</a>>.</p> +<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 12, 2025</td> + <td class="foot-os">FreeBSD 15.0</td> + </tr> +</table> |