5.2.11　xnftrace（トレースを採取する）

(1)　形式

• トレースを採取してファイルに出力する，またはトレース起動後にファイルを初期化してトレース出力先を切り替える場合

  /etc/xnftrace 〔-s  -x キーワード〕 〔-f ファイル名称〔-w ラップアラウンド長〕〕

• トレースの採取を終了する場合

  /etc/xnftrace -e〔-x キーワード〕

• トレース出力ファイルを事前割り当てする場合

  /etc/xnftrace -M ファイル名称〔-w ラップアラウンド長〕

• トレース起動後に事前割り当てしたファイルにトレース出力先を切り替える場合

  /etc/xnftrace -R ファイル名称

• トレース開始済みのリソース一覧を表示する場合

  /etc/xnftrace

ページの先頭へ

(2)　機能

次の機能があります。

• トレースを採取して，ファイルに出力します。

• トレースを出力するファイルの事前割り当てを行います。

• トレース開始済みのリソース一覧を表示します。

• トレース起動後にトレース出力ファイルの切り替えができます。

  切り替えの方法は次の2種類です。

  • -fオプション指定

    コマンド実行時に指定したファイルを初期化して，トレース出力先を切り替えます。

  • -Rオプション指定

    -Mオプションで事前に割り当てた（初期化した）ファイルにトレース出力先を切り替えます。切り替え時にファイルを初期化しないため，すぐに切り替えられます。ファイル容量が大きいときに効果があります。

ページの先頭へ

(3)　実行者

スーパユーザ

ページの先頭へ

(4)　オプション

ページの先頭へ

(5)　注意事項

採取したデータトレースは，xnfeditコマンドで編集して参照できます。ただし，xnfeditコマンドで編集する場合，トレース採取中のファイルは指定できません。必ず，-eオプション指定のxnftraceコマンドでトレース採取を停止したファイルを編集してください。

ページの先頭へ

(6)　使用例

(例1)

APIおよびソケット通信トレースを採取します。トレースファイルのファイル名はfile1とします。

/etc/xnftrace -s -x tli -f file1 .......... APIトレース採取開始， -fオプション必要
/etc/xnftrace -s -x socket       .......... ソケット通信トレース採取開始
<トレース採取>
      :
/etc/xnftrace -e -x socket       .......... ソケット通信トレース採取停止
/etc/xnftrace -e -x tli          .......... APIトレース採取停止

(例2)

トレース採取中に，トレースファイルを切り替えます。また，全トレースを一括して停止させます。

/etc/xnftrace -s -x tli -f file1  ...... ファイルfile1にAPIトレース採取開始
/etc/xnftrace -s -x socket        ...... ソケット通信トレース採取開始
/etc/xnftrace -f file2 -w 5       ...... ファイルfile2への切り替えおよびファイル容量
                                         の変更。以降,トレースはファイルfile2に出力 
<トレース採取>
      :
/etc/xnftrace -e                  ...... 全トレースを一括して停止

(例3)

トレース採取中のリソース名称，ファイル名称，およびラップアラウンド長を表示します。

入力形式：

/etc/xnftrace

出力形式：

+------------------------------------------------------+
リソース名称
+------------------------------------------------------+
*** trace file name(wraparound size) ***
トレースファイル名称(ラップアラウンド長)

出力例：

/etc/xnftrace
+----------------------------------------------------------+
tli                               socket
+----------------------------------------------------------+
*** trace file name(wraparound size) ***
/trace/file01(1)

(例4)

トレースファイルを事前に割り当てます。また，トレース開始後に事前に割り当てたファイルにトレース出力先を切り換えます。

/etc/xnftrace -M /trace/trace01 -w 100  ...... トレースファイル事前割り当て
/etc/xnftrace -M /trace/trace02 -w 100  ...... トレースファイル事前割り当て
/etc/xnftrace -s -x tli -f /tmp/trcdummy  .... トレース採取開始
                                                (ダミーファイルを割り当てておく)
/etc/xnftrace -R /trace/trace01  ............. ファイルtrace01に切り替え
          ：  (オンライン開始)
/etc/xnftrace -R /trace/trace02  ............. ファイルtrace02に切り替え
          ：  (オンライン終了)
/etc/xnftrace -e  ............................ トレース採取停止

ページの先頭へ