plockstat(1M)

名称

plockstat - 报告用户级锁定统计信息

用法概要

plockstat [-vACHV] [-n count] [-s depth] [-e secs] 
     [-x arg [=val]] command [arg]...

plockstat [-vACHV] [-n count] [-s depth] [-e secs] 
     [-x arg [=val]] -p pid

描述

plockstat 实用程序收集并显示用户级锁定统计信息。缺省情况下，plockstat 监视所有锁定争用事件、收集有关这些事件的频率和时间数据，并以频率降序显示这些数据，以便最常见的事件首先显示。

plockstat 会收集数据，直到指定的命令完成或者使用 –p 选项指定的进程完成为止。

plockstat 依赖于 DTrace 检测正在运行的进程或它调用的命令以跟踪所关注事件。这会对正在观察的进程强加一部分可度量的较小性能开销。用户必须拥有 dtrace_proc 特权且有权使用 plockstat 观察特定进程。有关 DTrace 安全功能的更多信息，请参阅Oracle Solaris 11.2 Dynamic Tracing Guide 。

选项

支持以下选项：

–A

观察所有锁定事件。该选项等效于 –CH。

–C

观察争用事件。

–H

观察保持事件。

–e secs

在指定秒数过后退出。

–n count

只为每个输出类别显示指定数量的条目。

–s depth

记录栈跟踪而不仅仅是调用函数。

–p pid

指定 plockstat 要从中收集数据的进程 ID。

–v

输出消息以指示跟踪已启动。

–x arg[=val]

启用或修改 DTrace 运行时选项或 D 编译器选项。选项列表可在Oracle Solaris 11.2 Dynamic Tracing Guide 中找到。将通过指定名称来启用布尔选项。将通过使用等号（=）分隔选项名称和值来设置包含值的选项。

–V

输出用于收集数据的 Dtrace 命令。随后，可以将输出直接与 dtrace(1M) 命令结合使用。

操作数

支持下列操作数：

arg

要作为 command 的参数传递的字符串。

command

要调用的实用程序名称。

count

正整数值。

pid

要监视的进程的进程标识符。

secs

指定为正整数的持续时间（秒数）。

显示标题

显示标题

以下标题显示在 plockstat 输出中的数据列上。

Count

事件发生的次数。

nsec

事件的平均持续时间（以纳秒计）。

Lock

锁的地址，如果可能，以符号形式显示。

Caller

调用者的地址，如果可能，以符号形式显示。

退出状态

将返回以下退出值：

0

成功完成。

>0

出现错误。

属性

有关下列属性的说明，请参见 attributes(5)：

属性类型 属性值 可用性 system/dtrace 接口稳定性 请参见下文。

命令行语法是 "Committed"（已确定）。人可阅读的输出是 Uncommitted（未确定）。

另请参见

dtrace(1M)、lockstat(1M)、mutex_init(3C)、pthread_mutex_lock(3C)、pthread_rwlock_rdlock(3C)、pthread_rwlock_wrlock(3C)、pthread_rwlock_unlock(3C)、rwlock(3C)、attributes(5)、fasttrap(7D)

Oracle Solaris 11.2 Dynamic Tracing Guide