输出选项

这些选项控制收集器生成实验的各个方面。

-o experiment_name

使用 experiment_name 作为要记录的实验的名称。experiment_name 字符串必须以字符串 ".er" 结尾；否则 collect 实用程序会列显一条错误消息并退出。

如果不指定 -o 选项，则为实验提供一个格式为 stem.n.er 的名称，其中 stem 是字符串，n 是数字。如果使用 -g 选项指定了组名称，则将 stem 设置为不带 .erg 后缀的组名称。如果未指定组名称，则将 stem 设置为字符串 test。

如果您要从用于运行 MPI 作业的命令之一（例如 mpirun，但不带 -M MPI-version 选项和 -o 选项）调用 collect 命令，则采用用于定义该进程的 MPI 等级的环境变量的名称中使用的值 n。否则，将 n 设置为比当前使用的最大整数还要大的值。

如果没有使用 stem.n.er 格式指定名称，而正在使用给定名称，将显示一条错误消息且实验不会运行。如果名称采用 stem.n.er 格式且正在使用提供的名称，将在与比当前使用的最大值 n 还要大的值对应的名称下记录实验。如果名称已更改，则会显示一条警告。

-d directory-name

将实验置于 directory-name 目录中。此选项仅适用于个别实验，而不适用于实验组。如果该目录不存在，则 collect 实用程序会列显一则错误消息并退出。如果使用 -g 选项指定了某个组，则该组文件也将写入 directory-name 中。

对于最轻量的数据收集，最好使用 -d 选项指定存放数据的目录，以便将数据记录到本地文件。但是，对于群集上的 MPI 实验，创始实验必须在相同的路径下可用，以便所有进程将所有数据记录到创始实验中。

写入长延迟文件系统的实验问题尤为突出，可能进行非常缓慢，特别是在收集样本数据时（缺省采用 -S on 选项）。如果必须通过长延迟连接来进行记录，请禁用样本数据。

-g group-name

使实验成为实验组 group-name 的一部分。如果 group-name 不以 .erg 结尾，则 collect 实用程序会列显一条错误消息并退出。如果该组存在，则会将实验添加到该组中。如果 group-name 不是绝对路径并且使用 -d 指定了一个目录，则实验组将被置于 directory-name 目录中，否则，将被置于当前目录中。

-A option

控制是否应将目标进程所使用的装入对象归档或复制到已记录的实验中。option 的允许值包括：

• off－不将装入对象归档到实验中。

• on－将装入对象归档到实验中。

• copy－将装入对象（目标以及它使用的任何共享对象）复制并归档到实验中。

如果您希望将实验从记录的位置复制到另一台计算机，或者从另一台计算机读取实验，请指定 - A copy。使用该选项不会将任何源文件或目标 (.o) 文件复制到实验中。确保可从在其上检查实验的计算机访问这些文件且这些文件未发生更改。

-L size

将所记录的分析数据量限制在 size 兆字节。该限制适用于基于时钟的分析数据量、硬件计数器溢出分析数据量和同步等待跟踪数据量之和，但不适用于样本点。该限制只是近似值，可以被超出。

当达到该限制时，不再记录分析数据，但实验会一直保持打开状态，直到目标进程终止。如果启用了定期抽样，则会继续写入样本点。

例如，要将限制确定为约 2 GB，请指定 -L 2000。指定的大小必须大于零。

缺省情况下，记录的数据量不存在限制。

-O file

将 collect 本身的所有输出附加到名称 file，但是不重定向所产生的目标的输出。如果该文件设置为 /dev/null，则禁止 collect 的所有输出（包括任何错误消息）。