RSET 接口

RSET 接口报告与 RSET 相关的处理器度量。

以下所有AIX® 6.1RSET 接口都使用perfstat_subsystem[_total]_rset 命名规则，并使用共同的签名：

项	描述信息
perfstat_cpu_total_rset	检索 RSET 中处理器的处理器摘要度量
perfstat_cpu_rset	检索 RSET 中处理器的每个处理器度量

先前的perfstat_memory_page_wpar Interface 所使用的特征符如下所示:

int perfstat_cpu_rset(perfstat_wpar_id_t *name,

                       perfstat_cpu_t * userbuff,

                       int sizeof_struct,

                       int desired_number);


int perfstat_cpu_total_rset(perfstat_wpar_id_t *name,

                       perfstat_cpu_total_t * userbuff,

                       int sizeof_struct,

                       int desired_number);

所有接口的参数用法如下所示:

项	描述信息
*perfstat_id_wpar_t 名称**	指定需要统计信息的第一个组件 (例如， cpu0) 的 RSET 标识和名称。包含说明符的结构，可以是 RSETHANDLE ， WPARID 或 WPARNAME ，用于指定 wpar 标识， wpar 名称或 rsethandle 的并集以及用于指定第一个组件的名称的 char * 字段。要从子系统的第一个组件开始，请将 name 参数的 char * 字段设置为 "" (空字符串)。您还可以使用 libperfstat.h 文件中定义的宏 FIRST_CPU。
*perfstat_cpu [_total] _t userbuff**	指向内存区域的指针，该内存区域有足够的空间用于返回的结构。
整数大小结构	应该设置为 sizeof (perfstat_cpu [_total] _t)。
整数期望数 (int desired_number)	要在 userbuff 中返回的类型为 perfstat_cpu [_total] _t 的结构数。

复制和返回的无错误结构数使用返回值 1。如果出现错误，返回值为-1。字段名称设置为 NULL 或下一个可用结构的名称。

此方案的例外情况是，当 name = NULL ， userbuff = NULL 和 desired_number=0时，将返回可用的结构总数。

要检索给定类型的所有结构，请先询问其编号，分配足够的内存以一次性保存所有结构，然后调用相应的 API 以在一次调用中检索所有结构。否则，分配固定结构集并重复调用 API 以获取下一个此类结构数，每次传递上一个调用返回的名称。启动名称设置为 "" 或 FIRST_CPU 的进程，并重复该进程，直到返回的名称等于 "" 为止。

以下部分提供了使用每个接口返回的数据类型和代码的示例。