-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 空間的位置。