トレース・ログをダンプします。
構文
fstrace dump [-set <set_name>+] [-follow <log_name>] [-file <output_filename>] [-sleep <seconds_between_reads>] [-help] fstrace d [-se <set_name>+] [-fo <log_name>] [-fi <output_filename>] [-sl <seconds_between_reads>] [-h]
構文
fstrace dump コマンドは、標準出力ストリーム上の cmfx トレース・ログの現在の内容を表示するか、または、-file 引き数で指定された名前のファイルに書き込みます。
標準出力またはファイルへ連続して書き込むには、 -follow 引き数を使用します。デフォルトでは、ログの内容は 10 秒ごとに書き出されてから自動的に消去されます。書き込み間隔を変更するには、-sleep 引き数を使用します。
注意
このコマンドは、活動状態の cm イベント設定のみの出力を生成します。イベント設定の状態を表示または設定するには、それぞれ fstrace lsset または fstrace setset コマンドを使用します。
このコマンドからの最大読み込み可能な出力を作成するには、 afszcm.cat と呼ばれるメッセージ・カタログ・ファイルがローカルの /usr/vice/etc/C ディレクトリーに常駐していなければなりません。もし必要ならば、トレースを活動化する前に AFS バイナリー分散からファイルをディレクトリーにコピーします。
cm イベント設定が活動状態の時、定義された総カーネル・メモリー (デフォルトでは、60 KB) は、 cmfx トレース・ログのために割り振られます。概要の fstrace 参照ページで説明しているとおり、バッファーがいっぱいになると、メッセージが上書きされます(新しいメッセージが古いメッセージを上書きします)。ログのためのカーネル・メモリーの割り振りを増やすには、fstrace setlog コマンドを使用します。現在のログ・バッファーのサイズを表示するには、fstrace lslog コマンドに -long 引き数を付けて使用します。
オプション
唯一の許容値は、 cmfx です。この引き数か -set 引き数のどちらか 1 つを指定するか、デフォルトとして cmfx ログへ書き出すために両方を省略します。
出力
出力は、指定したデータおよび書き込み操作が開始された時間のヘッダーを付けて開始します。-follow 引き数が組み込まれない場合、ヘッダーは、ダンプされたログの数もレポートします。これは、 cmfx トレース・ログのみがある時から常に、 1です。ヘッダーの形式は、以下のようになります。
AFS Trace Dump - Date: starting_timestamp Found 1 logs. Contents of log cmfx:
以下の各メッセージは、以下の形式のキャッシュ・マネージャー・オペレーションを説明します。
time timestamp, pid pid:event_message
ここで、
加えて、毎 1024 秒ごとに fstrace コマンド・インタープリターは現在のクロック時刻をレコードしたメッセージを以下の形式で書き込みます。
time timestamp, pid pid: Current time: unix_time
ここで、
各ログ・メッセージに関連した実際のクロック時刻を判別するためにこのメッセージを使用します。実際の時刻の判別は、以下のようになります。
カーネル・トレース・バッファーにある任意のデータがトレースが活動開始されてから上書きされた場合、以下のメッセージが、出力の適切な位置に表示されます。
Log wrapped; data missing.
上書きの可能性を削減するには、カーネル・バッファーのバッファーを増加するために fstrace setlog コマンドを使用します。現在の定義されたバッファー・サイズを表示するには、 fstrace lslog コマンドに -long 引き数を付けて使用します。
以下のログ・ダンプの最後のメッセージは、作業が完了されたことを指示しています。
AFS Trace Dump - Completed
例
以下のコマンドは、関連した cm イベント設定のログを標準出力へダンプします。
# fstrace dump -set cm AFS Trace Dump - Date: Tue Apr 7 10:54:57 1998 Found 1 logs. time 32.965783, pid 0: Tue Apr 7 10:45:52 1998 time 32.965783, pid 33657: Close 0x5c39ed8 flags 0x20 time 32.965897, pid 33657: Gn_close vp 0x5c39ed8 flags 0x20 (returns 0x0) time 35.159854, pid 10891: Breaking callback for 5bd95e4 states 1024 (volume 0) time 35.407081, pid 10891: Breaking callback for 5c0fadc states 1024 (volume 0) . . . time 71.440456, pid 33658: Lookup adp 0x5bbdcf0 name g3oCKs \ fid (756 4fb7e:588d240.2ff978a8.6) time 71.440569, pid 33658: Returning code 2 from 19 time 71.440619, pid 33658: Gn_lookup vp 0x5bbdcf0 name g3oCKs (returns 0x2) time 71.464989, pid 38267: Gn_open vp 0x5bbd000 flags 0x0 (returns 0x0) AFS Trace Dump - Completed
以下のコマンドは、ダンプ成功の間 10 秒のデフォルト間隔を使用して、ローカル・マシン上の cm イベント設定に関連したトレース・ログをファイル cmfx.dump.file.1 へダンプします。
# fstrace dump -follow cmfx -file cmfx.dump.file.1
必要となる特権
コマンドの発行者は、ローカル・スーパーユーザー root としてログインする必要があります。
関連情報