er_archive(1)

NAME
er_archive - パフォーマンス実験用の関数およびモジュールのリストを生成

形式

    er_archive [ -qFA ] experiment.

    er_archive -V

説明

er_archive は、実験が正常に終了したとき、および、実験に対して アナライザまたは er_print コマンドが最初に起動されたときに、自動的に実行されます。 er_archive は、実験に関係する共有オブジェクトのリストを読み取り、 そこにリストされている各共有オブジェクトに対する出力ファイルを生成します。 出力ファイルには、各共有オブジェクトから関数およびモジュールへのマッピング 情報が含まれ、接尾辞に .archive を持つ名前が付けられます。 対象のプログラムが異常終了した場合、er_archive は実行されません。

データを記録したマシンとは異なるマシン上でその実験を検査したい場合は、 データを記録したマシン上で、その実験に対して er_archive を手動で 実行しなければなりません。

.archive ファイルは、実験ファイルで参照されるすべての 共有オブジェクト用に生成されます。 共有オブジェクトが見つからない場合、実験ファイルに記録 されているものと異なる時刻表示が存在する場合、または er_archive が実験ファイルが記録されたマシンと異なる マシンで実行されている場合は、.archive は警告を含みます。 警告は、er_archive が手動で (-q フラグを指定しないで) 実行されている場合は、stderr にも書き込まれます。

オプション

-q  警告を stderr に書き込まないでください。警告は .archive ファイルに反映され、analyzer または er_print 出力に表示されます。

-F  .archive ファイルの書き込みと読み出しを強要します。この引数は、
     er_archive を手動で実行し、警告を含むファイルを書き換えるのに使用することができます。

-A  すべてのロードオブジェクトの実験に対する書き込みを要求します。 この引数は、実験が記録されたマシン以外のマシンに、より容易に コピーされる実験を生成するのに使用できます。

-V  er_archive のバージョン番号の情報を出力し、終了します。

互換性

er_archive は、以前のバージョンのツールで記録された実験では実行できません。起動した場合、警告が出力されます。 実験が記録されたリリースの er_archive のバージョンを使用してください。

関連項目
collect(1)、 collector(1)、 er_print(1)、
『プログラムのパフォーマンス解析』