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.4 DTrace (Dynamic Tracing) Guideを参照してください。
サポートしているオプションは、次のとおりです。
すべてのロックイベントを監視します。このオプションは –CH と同等です。
競合イベントを監視します。
保持イベントを監視します。
指定された秒数が経過すると終了します。
出力カテゴリごとに、指定された数のエントリのみを表示します。
呼び出し元関数だけでなく、スタックトレースを記録します。
plockstat でデータを収集するプロセス ID を指定します。
トレースが開始したことを示すメッセージを出力します。
DTrace の実行時オプションまたは D コンパイラオプションを有効化または変更します。オプションのリストは、Oracle Solaris 11.4 DTrace (Dynamic Tracing) Guideに記載されています。ブール型のオプションを有効にするときは、その名前を指定します。値を持つオプションを設定するには、オプションの名前と値を等号 (=) で分離します。
データの収集に使用される Dtrace コマンドを出力します。この出力はあとで dtrace(8) コマンドで直接使用できます。
次のオペランドがサポートされています。
command に引数として渡す文字列。
呼び出すユーティリティの名前。
正の整数値。
監視するプロセスのプロセス識別子。
秒数 (正の整数) で指定される期間。
plockstat の出力では、データの列の上に次のヘッダーが表示されます。
イベントが発生した回数。
イベントの平均期間 (ナノ秒単位)。
可能な場合にシンボルで表示される、ロックのアドレス。
可能な場合にシンボルで表示される、呼び出し元のアドレス。
次の終了ステータスが返されます。
正常終了。
エラーが発生しました。
属性についての詳細は、マニュアルページの attributes(7) を参照してください。
|
コマンド行の構文は「確実」です。人間が読める形式の出力は「不確実」です。
mutex_init(3C)、pthread_mutex_lock(3C)、pthread_rwlock_rdlock(3C)、pthread_rwlock_unlock(3C)、pthread_rwlock_wrlock(3C)、rwlock(3C)、fasttrap(4D)、attributes(7)、dtrace(8)、lockstat(8)