Oracle® Solaris Studio 12.4:性能分析器

退出打印视图

更新时间: 2015 年 1 月
 
 

er_archive 实用程序

er_archive 命令的语法如下。

 er_archive [ -nqF ] [-s option [-m regexp ] ] experiment er_archive -V

当实验正常完成时,er_archive 将自动运行(除非在运行实验时关闭了归档功能)。它会读取实验中引用的共享对象的列表,并将实验中引用的所有共享对象复制到创建者实验中的目录 archives 中。副本以改编名称存储,所以创建者实验及其子实验可能有同名对象的不同版本。对于 Java 实验,引用的所有 .jar 文件也会复制到实验中。(er_archive 不再生成 .archive 文件。)如果目标程序异常终止,er_archive 可能无法运行;在这种情况下,应该手动运行它。

如果用户希望在与记录实验所在的计算机不同的其他计算机上检查实验,则 er_archive 必须在实验完成时已运行,或者必须对记录数据所在的计算机上的实验手动运行,才能获得所有共享对象的正确版本。

如果无法找到共享对象,或者如果其时间戳与实验中记录的不同,又或者如果 er_archive 运行所在的计算机与记录实验所在的计算机不同,则不会复制对象。如果手动运行 er_archive(不带 -q 标志),则会将警告写入 stderr。当 er_print 或分析器读取引用此类共享对象的实验时,也会生成警告。

通过在手动运行时指定 -s 参数,er_archive 也可归档源代码(包括任何必要的对象文件与所需的符号表)。通过设置环境变量 SP_ARCHIVE_ARGS,可将源代码的归档指定为在实验完成时自动执行。该环境变量可能包含 -s-m 参数,形式为成对的参数和由一个或多个空格分隔的选项。如果命令行上出现多个 -s 参数,则优先使用最后一个。如果 -s 既在命令行上传递,又由环境变量设置,则优先使用环境变量的选项。

以下几节介绍 er_archive 实用程序可以接受的选项。

–n

仅归档指定的实验,不包括其子孙。

–q

不将任何警告写入 stderr。警告将并入归档文件,并显示在性能分析器或 er_print 实用程序的输出中。

–F

强制写入或重新写入归档文件。该参数可用于手动运行 er_archive,以重新写入带有警告的文件。

–s option

指定源文件的归档。option 的允许值包括:

no

不归档任何源文件

all

归档可找到的所有源代码、对象和 .anc 文件。

used[src]

归档在实验中记录数据所针对的函数的且可找到的源代码、对象和 .anc 文件。

如果在命令行上提供了或者在环境变量中指定了多个 -s 参数,为所有参数指定的选项必须相同。如果不同,er_archive 将退出,并显示一个错误。

–m regex

仅归档由 -s 标志指定且在可执行文件或共享对象中记录的其完整路径名与指定的 regex 匹配的源代码、对象和 .anc 文件。有关更多信息,请参见 regex(5) 手册页。

可以在命令行上或环境变量中提供多个 -m 参数。如果源文件与任一参数的表达式匹配,则会归档源文件。

–V

写入 er_archive 实用程序的版本号信息,并退出。