これらのオプションは、コレクタによって生成される実験を制御します。
記録される実験の名前として experiment-name を使用します。experiment-name 文字列は文字列「.er」で終わる必要があり、そうでない場合、collect ユーティリティーはエラーメッセージを出力して終了します。
–o オプションを指定しない場合、実験名を「stem.n.er」(stem は文字列、n は数値) の形式で指定します。–g オプションでグループ名を指定した場合、stem を「.erg」接尾辞なしのグループ名に設定します。グループ名を指定していない場合、stem を文字列「test」に設定します。
collect コマンドを、MPI ジョブの実行に使用されるコマンドの 1 つ、たとえば mpirun から起動し、–M MPI-version オプションおよび –o オプションを指定しない場合、そのプロセスの MPI ランクを定義するために使用された環境変数から、名前に使用されている n の値を使用します。それ以外の場合、現在使用されている最も大きい整数値に 1 を加えた値を n に設定します。
名前が「stem.n.er」の形式で指定されておらず、与えられた名前がすでに使用されている場合、エラーメッセージが表示され、実験は実行されません。名前が「stem.n.er」の形式で、与えられた名前がすでに使用されている場合、現在使用されているもっとも大きい数値より 1 大きい n の値に対応する名前で、実験が記録されます。名前が変更された場合、警告が表示されます。
directory-name というディレクトリに実験を格納します。このオプションは個別の実験にのみ適用され、実験グループには適用されません。ディレクトリが存在しない場合、collect ユーティリティーはエラーメッセージを出力して終了します。-g オプションでグループが指定されている場合、グループファイルも directory-name へ書き込まれます。
データ収集をできるだけ軽くするには、データをローカルファイルに記録し、–d オプションを使用してデータ格納ディレクトリを指定するのが最適です。ただし、クラスタ上の MPI 実験では、すべてのプロセスから、記録されたすべてのデータが親の実験に書き込まれるため、親の実験がどのプロセスからでも同じパスに存在する必要があります。
待機時間の長いファイルシステムに書き込まれる実験は特に問題が発生しやすく、標本データが収集される場合 (デフォルトの –S on オプション) には特に、非常に低速になることがあります。待ち時間の長い接続を経由して記録を行う必要がある場合には、標本データを無効にしてください。
実験を group-name という実験グループに含めます。group-name の末尾が .erg でない場合、collect ユーティリティーはエラーメッセージを出力して終了します。グループが存在する場合は、そのグループに実験が追加されます。group-name が絶対パスでない場合、-d でディレクトリを指定されていれば、実験グループがディレクトリ directory-name に、それ以外の場合は現在のディレクトリに格納されます。
ターゲットプロセスで使用されるロードオブジェクトを、記録済み実験にアーカイブまたはコピーするかどうかを管理します。option に使用できる値は次のとおりです。
on – ロードオブジェクト (ターゲット、およびターゲットが使用するすべての共有オブジェクト) を実験にコピーします。また、ロードオブジェクトに存在しないスタブまたは DWARF デバッグ情報を含むすべての .anc ファイルと .o ファイルをコピーします。これはデフォルト値です。
src – -A on の場合と同様のロードオブジェクトのコピーに加えて、見つかったすべてのソースファイルと .anc ファイルを実験にコピーします。
used[src] – -A on の場合と同様のロードオブジェクトのコピーに加えて、記録されたデータで参照されていて、見つかったすべてのソースファイルと .anc ファイルを実験にコピーします。
off – ロードオブジェクトを実験にコピーすることもアーカイブすることもしません。
実験を別のマシンにコピーするか、または実験を別のマシンから読み取る予定の場合は、-A on を指定します。実験で使用するディスク容量は増えますが、ほかのマシンで実験を読み取ることができます。
-A on でも、ソースファイルまたはオブジェクトファイル (.o) は実験にコピーされません。これらのファイルが、実験の検査に使用するマシンからアクセス可能であることを確認する必要があります。実験が記録されたあとで、ファイルを変更したり、再構築しないでください。
収集時に実験をアーカイブすると、特に多数の派生プロセスが含まれている実験では、非常にコストが高くなる場合があります。このような実験では、-A off を使用してデータを収集してから、実行の終了後に –A フラグを付けて er_archive を実行することをお勧めします。
–A のデフォルト設定は on です。
collect 自体のすべての出力を指定された file のあとに付加しますが、生成されたターゲット、(–P オプションで呼び出された) dbx、(–c 引数で呼び出された) カウントデータの記録にかかわるプロセスのいずれの出力もリダイレクトしません。file が /dev/null に設定されている場合は、あらゆるエラーメッセージを含む collect のすべての出力が抑制されます。