-spec clear() -> ok.

等效于 clear(node())。

-spec clear(Node) -> ok when Node :: node().

从运行时系统中清除内部锁统计信息。

这将清除运行时系统中的数据，但不清除服务器中的数据。所有静态锁的计数器都将归零，所有当前活动的动态锁都将归零，并且所有保存的现在已销毁的锁都将被删除。它还会重置持续时间计时器。

-spec collect() -> ok.

等效于 collect(node())。

-spec collect(Node) -> ok when Node :: node().

从运行时系统收集锁统计信息。

如果服务器尚未启动，则此函数会启动服务器。然后，它会用锁统计信息填充服务器。如果服务器在收集之前保存了任何锁统计数据，则该数据将丢失。

-spec conflicts() -> ok.

等效于 conflicts([])。

-spec conflicts(Options) -> ok when Options :: [option()].

打印内部锁及其统计信息的列表。

有关选项说明，请参阅 lcnt:inspect/2。

-spec information() -> ok.

打印 lcnt 服务器状态以及有关收集的锁统计信息的通用信息。

-spec inspect(Lock) -> ok
                 when
                     Lock :: Name | {Name, Id | [Id]},
                     Name :: atom() | pid() | port(),
                     Id :: atom() | integer() | pid() | port().

等效于 inspect(Lock, [])。

-spec inspect(Lock, Options) -> ok
                 when
                     Lock :: Name | {Name, Id | [Id]},
                     Name :: atom() | pid() | port(),
                     Id :: atom() | integer() | pid() | port(),
                     Options :: [option()].

打印特定锁的内部锁计数器列表。

端口和进程的锁 Name 和 Id 可以通过使用 lcnt:swap_pid_keys/0 互换使用，这也是为什么 pid/0 和 port/0 选项可以在 Name 和 Id 空间中使用的原因。 pid 和端口都是具有剥离创建的特殊标识符，可以使用 lcnt:pid/2,3 和 lcnt:port/1,2 重新创建。

选项说明

• {combine, boolean()} - 合并来自锁类不同实例的统计信息。
  默认值：true

• {locations, boolean()} - 按源文件和行号打印统计信息。
  默认值：false

• {max_locks, MaxLocks} - 打印的最大锁数量，如果为 none 则无限制。
  默认值：20

• {print, PrintOptions} - 打印选项

  • name - 命名的锁或命名的锁集合（类）。与在 VM 中初始化锁时使用的名称相同。

  • id - 锁集合的内部 ID，并非总是唯一。这可能是 ets 表的表名 (db_tab)、端口的端口 ID、分配器的整数标识符等。

  • type - 锁的类型：rw_mutex、mutex、spinlock、rw_spinlock 或 proclock。

  • entry - 与 {locations, true} 结合使用时，此选项会打印锁操作的源文件和行号入口点，以及每个入口点的统计信息。

  • tries - 获取此锁的次数。

  • colls - 当线程尝试获取此锁时发生的冲突次数。这指的是 trylock 返回 EBUSY、在持有读锁的 rw_lock 上进行写尝试、在持有写锁的 rw_lock 上进行读尝试，以及线程尝试锁定已锁定的锁。（内部状态会监视这种情况。）

  • ratio - 冲突次数与尝试（获取）次数之比，以百分比表示。

  • time - 此锁的累积等待时间。这可能大于实际的挂钟时间，它是为所有线程累积的。Trylock 冲突不会累积时间。

  • duration - 累积等待时间占挂钟时间的百分比。此百分比可能高于 100%，因为累积时间来自所有线程。

  默认值：[name,id,tries,colls,ratio,time,duration]

• {reverse, boolean()} - 反转排序顺序。
  默认值：false

• {sort, Sort} - 列排序顺序。
  默认值：time

• {thresholds, Thresholds} - 过滤阈值。任何高于阈值的值都会通过。
  默认值：[{tries, 0}, {colls, 0}, {time, 0}]

-spec load(Filename) -> ok when Filename :: file:filename().

将先前保存的数据还原到服务器。

-spec locations() -> ok.

等效于 locations([])。

-spec locations(Options) -> ok when Options :: [option()].

按源代码位置打印内部锁计数器列表。

有关选项说明，请参阅 lcnt:inspect/2。

-spec save(Filename) -> ok when Filename :: file:filename().

将收集的数据保存到文件。

-spec start() -> {ok, Pid} | {error, {already_started, Pid}} when Pid :: pid().

启动锁分析器服务器。

服务器仅充当用户的媒介，并执行由 lcnt:collect/1 收集的数据的过滤和打印。

-spec stop() -> ok.

停止锁分析器服务器。

-spec swap_pid_keys() -> ok.

交换端口和进程的 Name 和 Id 空间的位置。