动态函数和模块 (Sun Studio 12：性能分析器)

Sun Studio 12：性能分析器

动态函数和模块

如果 C 或 C++ 程序向程序的数据空间动态编译函数，而且您希望在性能分析器中查看动态函数或模块的数据，那么，您必须向收集器提供信息。该信息由对收集器 API 函数的调用传递。API 函数的定义如下所示。

void collector_func_load(char *name, char *alias,
    char *sourcename, void *vaddr, int size, int lntsize,
    Lineno *lntable);
void collector_func_unload(void *vaddr);

您不必将这些 API 函数用于由 Java HotSpot^TM 虚拟机编译的 Java 方法，该虚拟机使用的是另一个接口。Java 接口提供已编译到收集器的方法的名称。您可以查看 Java 编译方法的函数数据和带注释的反汇编列表，但不能查看带注释的源代码列表。

对 API 函数的描述如下所示。

`collector_func_load()`

将有关动态编译的函数的信息传递到收集器，以便在实验中进行记录。下表对参数列表进行了描述。

表 3–1 collector_func_load() 的参数列表


参数	定义
`name`	性能工具所使用的动态编译函数的名称。该名称不必是函数的实际名称。虽然该名称不应包含嵌入的空格或引号字符，但无须遵循通常的函数命名约定。
`alias`	用于描述函数的任意字符串。它可以是 `NULL`。它不经过任何方式的解释，可以包含嵌入的空格。它显示在分析器的“摘要”选项卡中。它可用于指示函数的内容或动态构造函数的原因。
`sourcename`	构造函数时所在源文件的路径。它可以是 `NULL`。该源文件用于带注释的源代码列表。
`vaddr`	函数的装入地址。
`size`	以字节为单位的函数大小。
`lntsize`	对行号表中条目数量的计数。如果未提供行号信息，则计数应为零。
`lntable`	包含 `lntsize` 条目的表，其中每个条目都是一对整数。第一个整数是偏移量，第二个整数是行号。在一个条目的偏移量和下一个条目中所给出的偏移量之间的所有指令都归属于在第一个条目中提供的行号。偏移量必须按数字升序列出，但行号的顺序可以是任意的。如果 `lntable` 为 `NULL`，则没有可用的函数源代码列表，不过反汇编列表是可用的。

`collector_func_unload()`

通知收集器位于地址 vaddr 的动态函数已卸载。