> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man4/dtrace_lockstat.4.md). # dtrace\_lockstat.4 `dtrace_lockstat` — 用于跟踪内核锁定事件的 DTrace 提供者 ## 名称 `dtrace_lockstat` ## 概要 `Fn lockstat:::adaptive-acquire struct mtx * Fn lockstat:::adaptive-release struct mtx * Fn lockstat:::adaptive-spin struct mtx * uint64_t Fn lockstat:::adaptive-block struct mtx * uint64_t Fn lockstat:::spin-acquire struct mtx * Fn lockstat:::spin-release struct mtx * Fn lockstat:::spin-spin struct mtx * uint64_t Fn lockstat:::rw-acquire struct rwlock * int Fn lockstat:::rw-release struct rwlock * int Fn lockstat:::rw-block struct rwlock * uint64_t int int int Fn lockstat:::rw-spin struct rwlock * uint64_t Fn lockstat:::rw-upgrade struct rwlock * Fn lockstat:::rw-downgrade struct rwlock * Fn lockstat:::sx-acquire struct sx * int Fn lockstat:::sx-release struct sx * int Fn lockstat:::sx-block struct sx * uint64_t int int int Fn lockstat:::sx-spin struct sx * uint64_t Fn lockstat:::sx-upgrade struct sx * Fn lockstat:::sx-downgrade struct sx * Fn lockstat:::lockmgr-acquire struct lock * int Fn lockstat:::lockmgr-release struct lock * int Fn lockstat:::lockmgr-disown struct lock * int Fn lockstat:::lockmgr-block struct lock * uint64_t int int int Fn lockstat:::lockmgr-upgrade struct lock * Fn lockstat:::lockmgr-downgrade struct lock * Fn lockstat:::thread-spin struct mtx * uint64` ## 描述 DTrace `lockstat` 提供者允许跟踪 FreeBSD 上的锁定相关事件。 `lockstat` 提供者包含用于检查内核锁状态转换的 DTrace 探测。lockmgr(9)、[mutex(9)](/man/man9/mutex.9.md)、[rwlock(9)](/man/man9/rwlock.9.md) 和 [sx(9)](/man/man9/sx.9.md) 锁类型均有探测。[lockstat(1)](/man/man1/lockstat.1.md) 工具可用于收集和显示从 `lockstat` 提供者收集的数据。每种锁类型都有 Fn acquire 和 Fn release 探测，暴露正在操作的锁结构，以及当线程与其他线程争用锁所有权时触发的探测。 Fn lockstat:::adaptive-acquire 和 Fn lockstat:::adaptive-release 探测分别在获取和释放 `MTX_DEF` [mutex(9)](/man/man9/mutex.9.md) 时触发。唯一参数是指向描述正在获取或释放的锁的锁结构的指针。 Fn lockstat:::adaptive-spin 探测在线程自旋等待另一个线程释放 `MTX_DEF` [mutex(9)](/man/man9/mutex.9.md) 时触发。第一个参数是指向描述该锁的锁结构的指针，第二个参数是互斥锁自旋花费的时间（以纳秒为单位）。Fn lockstat:::adaptive-block 探测在线程尝试获取由另一个线程拥有的 `MTX_DEF` [mutex(9)](/man/man9/mutex.9.md) 时将自己从 CPU 上移除时触发。第一个参数是指向描述该锁的锁结构的指针，第二个参数是等待线程被阻塞的时间长度（以纳秒为单位）。Fn lockstat:::adaptive-block 和 Fn lockstat:::adaptive-spin 探测仅在成功获取锁之后触发，特别是在 Fn lockstat:::adaptive-acquire 探测触发之后。 Fn lockstat:::spin-acquire 和 Fn lockstat:::spin-release 探测分别在获取和释放 `MTX_SPIN` [mutex(9)](/man/man9/mutex.9.md) 时触发。唯一参数是指向描述正在获取或释放的锁的锁结构的指针。 Fn lockstat:::spin-spin 探测在线程自旋等待另一个线程释放 `MTX_SPIN` [mutex(9)](/man/man9/mutex.9.md) 时触发。第一个参数是指向描述该锁的锁结构的指针，第二个参数是自旋花费的时间长度（以纳秒为单位）。Fn lockstat:::spin-spin 探测仅在成功获取锁之后触发，特别是在 Fn lockstat:::spin-acquire 探测触发之后。 Fn lockstat:::rw-acquire 和 Fn lockstat:::rw-release 探测分别在获取和释放 [rwlock(9)](/man/man9/rwlock.9.md) 时触发。第一个参数是指向描述正在获取的锁的结构的指针。第二个参数在作为写入者获取或释放锁时为 `0`，作为读取者获取或释放锁时为 `1`。Fn lockstat:::sx-acquire 和 Fn lockstat:::sx-release，以及 Fn lockstat:::lockmgr-acquire 和 Fn lockstat:::lockmgr-release 探测分别在 [sx(9)](/man/man9/sx.9.md) 和 lockmgr(9) 锁的相应事件上触发。Fn lockstat:::lockmgr-disown 探测在 lockmgr(9) 排他锁被弃有时触发。在此状态下，锁仍保持排他持有，但可由不同的线程释放。释放被弃有的锁时不会触发 Fn lockstat:::lockmgr-release 探测。第一个参数是指向描述正在被弃有的锁的结构的指针。第二个参数为 `0`，用于与 Fn lockstat:::lockmgr-release 兼容。 Fn lockstat:::rw-block、Fn lockstat:::sx-block 和 Fn lockstat:::lockmgr-block 探测在线程等待获取相应类型锁时将自己从 CPU 上移除时触发。Fn lockstat:::rw-spin 和 Fn lockstat:::sx-spin 探测在线程自旋等待获取相应类型锁时触发。所有探测都采用相同的参数集。第一个参数是指向描述该锁的锁结构的指针。第二个参数是等待线程离开 CPU 或为锁自旋的时间长度（以纳秒为单位）。第三个参数在线程尝试以写入者身份获取锁时为 `0`，以读取者身份获取锁时为 `1`。第四个参数在线程等待读取者释放锁时为 `0`，等待写入者释放锁时为 `1`。第五个参数是线程首次尝试获取锁时持有该锁的读取者数量。如果第四个参数为 `1`，则此参数为 `0`。 Fn lockstat:::lockmgr-upgrade、Fn lockstat:::rw-upgrade 和 Fn lockstat:::sx-upgrade 探测在线程成功将持有的 lockmgr(9)、[rwlock(9)](/man/man9/rwlock.9.md) 或 [sx(9)](/man/man9/sx.9.md) 共享/读取者锁升级为排他/写入者锁时触发。唯一参数是指向描述正在获取的锁的结构的指针。Fn lockstat:::lockmgr-downgrade、Fn lockstat:::rw-downgrade 和 Fn lockstat:::sx-downgrade 探测在线程将持有的 lockmgr(9)、[rwlock(9)](/man/man9/rwlock.9.md) 或 [sx(9)](/man/man9/sx.9.md) 排他/写入者锁降级为共享/读取者锁时触发。 Fn lockstat:::thread-spin 探测在线程自旋线程锁时触发，线程锁是一种专用的 `MTX_SPIN` [mutex(9)](/man/man9/mutex.9.md)。第一个参数是指向描述该锁的结构的指针，第二个参数是线程自旋的时间长度（以纳秒为单位）。 ## 参见 [dtrace(1)](/man/man1/dtrace.1.md), [lockstat(1)](/man/man1/lockstat.1.md), [locking(9)](/man/man9/locking.9.md), [mutex(9)](/man/man9/mutex.9.md), [rwlock(9)](/man/man9/rwlock.9.md), [SDT(9)](https://github.com/FreeBSD-Ask/freebsd-man-sc/tree/main/man9/sdt.9.md), [sx(9)](/man/man9/sx.9.md) ## 历史 `lockstat` 提供者首次出现于 Solaris。FreeBSD 的 `lockstat` 提供者实现首次出现于 FreeBSD 9。 ## 作者 本手册页由 George V. Neville-Neil 和 Mark Johnston 编写。 ## 缺陷 尚未添加 [rmlock(9)](/man/man9/rmlock.9.md) 锁的探测。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://book.bsdcn.org/man/man4/dtrace_lockstat.4.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.