dtrace_priv(4)

dtrace_priv4

A dtrace provider for the kernel privilege checking api

Usage

priv:kernel:priv_check:priv-ok

priv:kernel:priv_check:priv-err

Overview

The priv provider allows for tracing the priv(9) API.

The priv:kernel:priv_check:priv-ok probe fires upon a successful kernel privilege check.

The priv:kernel:priv_check:priv-err probe fires upon a failed kernel privilege check.

The only argument to the priv probes, args[0], is the requested privilege number int priv.

Examples

Example 1: Tracing Kernel Privilege Check Failures

The following script captures an array of counters, one for each stack trace leading to a failed kernel privilege check:

priv:::priv-err
{
	@traces[stack()] = count();
}

Releases

Unchanged in 4 releases since FreeBSD 14.4-RELEASE.

  1. 14.4–16.0

Authors

The priv provider was written by Robert N. M. Watson ⟨[email protected]⟩.

This manual page was written by Mateusz Piotrowski ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.