perfstat_cpu_rset 子例程

在线编辑

用途

检索资源集 (rset) 的处理器使用统计信息

库

Perfstat 库libperfstat.a

语法

#include <libperfstat.h>
int perfstat_cpu_rset (name, userbuff, sizeof_userbuff, desired_number)
perfstat_id_wpar_t * name;
perfstat_cpu_t * userbuff;
size_t sizeof_userbuff;
int desired_number;

描述

perfstat_cpu_rset子程序返回属于指定资源集（rset）的处理器的使用统计信息。

要获取资源集中的处理器的统计信息，请指定 WPAR的名称或标识，或者指定 WPAR 名称的 rset 句柄。 如果指定了 WPAR 的名称或标识，那么将采用关联的 rset。 userbuff参数必须已分配，而desired_number参数必须是 rset 中的处理器数量。 在WPAR 中调用该子程序时，name参数必须指定为 NULL。

参数

项 描述
名称 定义 WPAR 名称或 WPAR 标识。 如果子程序是从WPAR 调用的，则name参数的值为空。
用户缓冲区 指向要填充perfstat_wpar_total_t结构的内存区域。
大小用户缓冲区 指定perfstat_wpar_total_t结构的大小。
期望数 (desired_number) 指定要复制到userbuff 的perfstat_wpar_total_t结构的个数。 此参数的值必须设置为 1。

返回值

成功完成后，将返回已填充结构的数量。

如果不成功，则返回值为-1并设置errno全局变量。

错误代码

如果以下情况之一为真，则perfstat_cpu_rset子例程不成功：

项 描述
EINVAL 其中一个参数无效
EFAULT 内存不足

文件

libperfstat.h文件定义了标准宏、数据类型和子程序。