Oracle® Solaris Studio 12.4:性能分析器

退出打印视图

更新时间: 2015 年 1 月
 
 

输出选项

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

使用 -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 归档实验中的装入对象

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

  • on-将装入对象(目标以及其使用的任何共享对象)复制到实验中。也会复制任何 .anc 文件和 .o 文件,这些文件的 Stabs 或 DWARF 调试信息不在装入对象中。这是缺省值。

  • src-除了像 -A on 中一样复制装入对象,还将可找到的所有源文件和 .anc 文件复制到实验中。

  • used[src]-除了像 -A on 中一样复制装入对象,还将记录的数据中引用的和可找到的所有源文件和 .anc 文件复制到实验中。

  • off-不将装入对象归档复制或归档到实验中。

如果希望将实验复制到另一台计算机,或者从另一台计算机读取实验,请指定 -A on。实验将占用更多磁盘空间,但允许在其他计算机上读取实验。

-A on 不会将任何源文件或对象 (.o) 文件复制到实验中。必须确保可从用于检查实验的计算机访问这些文件。在记录实验后,不应更改或重新生成这些文件。

在收集时归档实验(尤其是包含许多子孙进程的实验)可能代价很高。对于此类实验,较好的策略是使用 -A off 收集数据,运行终止后使用 –A 标志运行 er_archive

–A 的缺省设置为打开。

使用 -O file 将命令输出保存到文件

collect 本身的所有输出附加到指定的 file,但不会重定向以下各项的的输出:产生的目标、dbx(使用 –P 选项调用)或记录计数数据中涉及的进程(使用 –c 参数调用)。如果 file 设置为 /dev/null,则禁止 collect 的所有输出(包括任何错误消息)。