test

Oracle Solaris Studio 12.2：性能分析器

实验控制选项

这些选项控制如何收集实验数据。

-F option

控制是否应当记录子孙进程的数据。option 的允许值包括：

缺省情况下设置 -F on 选项，这样收集器将跟踪通过调用函数 fork(2)、fork1(2)、fork(3F)、vfork(2) 和 exec(2) 及其变体而创建的进程。对 vfork 的调用已在内部被替换为对 fork1 的调用。

对于 MPI 实验，缺省情况下还跟踪子孙进程。

如果指定 -F all 选项，收集器将跟踪所有子孙进程，其中包括那些通过调用 system(3C)、system(3F)、sh(3F)、posix_spawn(3p)、posix_spawnp(3p) 和 popen(3C) 以及类似函数而创建的子孙进程以及与其相关的子孙进程。

如果指定 -F '= regexp ' 选项，收集器将跟踪所有子孙进程。当子孙进程的名称或子实验的名称与指定的正则表达式匹配时，收集器将创建子实验。有关正则表达式的信息，请参见 regexp(5) 手册页。

当您在子孙进程上收集数据时，收集器会针对创始实验中的每个子孙进程打开一个新实验。这些新实验是通过向实验后缀添加一个下划线、一个字母和一个数字来命名的，如下所示：

例如，如果初始进程的实验名称是 test.1.er，则由它的第三个派生创建的子进程的实验是 test.1.er/_f3.er。如果该子进程针对新映像执行 exec 操作，则相应的实验名称为 test.1.er/_f3_x1.er。如果该子进程使用 popen 调用创建另一个进程，则实验名称为 test.1.er/_f3_x1_c1.er。

读取创始实验时，分析器和 er_print 实用程序将自动读取子孙进程的实验，并在数据显示中显示子孙进程。

要从命令行中选择要显示的数据，请明确指定 er_print 或 analyzer 的路径名。所指定的路径必须包含创始实验的名称以及创始目录中后续实验的名称。

例如，要查看 test.1.er 实验的第三个派生的数据，需要指定以下内容：

er_print test.1.er/_f3.er

analyzer test.1.er/_f3.er

或者，可以使用感兴趣的后续实验的显式名称来准备实验组文件。

要在分析器中检查子孙进程，请装入创始实验并从“视图”菜单中选择“过滤数据”。此时将显示一个实验列表，其中只有创始实验处于选中状态。取消选中初始实验并选中感兴趣的后续实验。

注 –

如果正在跟踪子孙进程时创始进程退出，将继续从仍然在运行的子孙进程中收集数据。创始实验目录会相应地继续变大。

您还可以收集脚本上的数据并跟踪脚本的子孙进程。有关更多信息，请参见从脚本收集数据。

-j option

当目标程序是 JVM 时，启用 Java 分析。option 的允许值包括：

如果要收集 .class 文件或 .jar 文件中的数据，则不需要 -j 选项，但前提是 java 可执行文件的路径在 JDK_HOME 环境变量或 JAVA_PATH 环境变量中。随后可以在 collect 命令行上将目标 program 指定为具有或不具有扩展名的 .class 文件或 .jar 文件。

如果无法在 JDK_HOME 或 JAVA_PATH 环境变量中定义 java 可执行文件的路径，或者要禁用对 Java HotSpot 虚拟机所编译的方法的识别，则可以使用 -j 选项。如果使用此选项，在 collect 命令行上指定的 program 必须为版本不低于 JDK 6 Update 18 的 Java 虚拟机。collect 命令验证 program 是否为 JVM 且是 ELF 可执行文件，如果不是，collect 命令将列显一条错误消息。

如果要使用 64 位 JVM 收集数据，则不得对 32 位 JVM 的 java 命令使用 -d64 选项。否则，将收集不到任何数据。而是，必须在 collect 命令的 program 参数中或者在 JDK_HOME 或 JAVA_PATH 环境变量中指定 64 位 JVM 的路径。

-J java_argument

指定要传递到用于分析的 JVM 的其他参数。如果您指定了 -J 选项但未指定 Java 分析，则会生成一个错误并且不运行实验。如果 java_argument 包含多个参数，则必须使用括号将其括起来。它必须包括一组由空格或制表符分隔的令牌。每个令牌作为单独的参数传递给 JVM。JVM 的大多数参数必须以 "-" 字符开头。

-l signal

当名为 signal 的信号传递到进程时，记录样本包。

可以通过全信号名、不带开始的几个字母 SIG 的信号名或信号编号来指定信号。请不要使用程序所使用的信号或会终止执行的信号。建议的信号为 SIGUSR1 和 SIGUSR2。即使指定时钟分析，也可以使用 SIGPROF。可通过 kill 命令将信号传递到进程。

如果同时使用 -l 和 -y 选项，则必须针对每个选项使用不同的信号。

如果您使用该选项而程序具有其自己的信号处理程序，则应当确保使用 -l 指定的信号会传递到收集器的信号处理程序，而不是被截获或忽略。

有关信号的更多信息，请参见 signal(3HEAD) 手册页。

-t duration

指定数据收集的时间范围。

可以将 duration 指定为单个数字（可以选择添加 m 或 s 后缀）以指示实验在该时间（单位为分钟或秒）终止。缺省情况下，持续时间以秒为单位。也可以将 duration 指定为用连字符分隔的两个这样的数字，这会导致数据收集暂停，直到经过第一个时间之后才开始收集数据。当到达第二个时间时，数据收集终止。如果第二个数字为零，则在初次暂停之后收集数据，直到该程序运行结束。即使该实验已经终止，也允许目标进程运行至结束。

-x

在从 exec 系统调用退出时使目标进程停止，以便允许调试器附加到目标进程。如果将 dbx 附加到目标进程，请使用 dbx 命令 ignore PROF 和 ignore EMT 来确保收集信号传递到 collect 命令。

-y signal[ ,r]

控制对包含名为 signal 的信号的数据的记录。无论何时将信号传递到进程，它都在暂停状态（在此期间不记录任何数据）和记录状态（在此期间记录数据）之间切换。无论切换状态如何，都将始终记录样本点。

可以通过全信号名、不带开始的几个字母 SIG 的信号名或信号编号来指定信号。请不要使用程序所使用的信号或会终止执行的信号。建议的信号为 SIGUSR1 和 SIGUSR2。即使指定时钟分析，也可以使用 SIGPROF。可通过 kill 命令将信号传递到进程。

如果同时使用 -l 和 -y 选项，则必须针对每个选项使用不同的信号。

使用 -y 选项时，如果已提供可选的 r 参数，则收集器将在记录状态下启动，否则将在暂停状态下启动。如果未使用 -y 选项，则收集器将在记录状态下启动。

如果您使用该选项而程序具有其自己的信号处理程序，则应当确保使用 -y 指定的信号会传递到收集器的信号处理程序，而不是被截获或忽略。

有关信号的更多信息，请参见 signal(3HEAD) 手册页。