perfstat_cpu_total_wpar 子例程

在线编辑

用途

检索 工作负载分区 (WPAR) 处理器使用统计信息

库

Perfstat 库 (libperfstat.a)

语法

#include <libperfstat.h>

int perfstat_cpu_total_wpar ( name, userbuff, sizeof_userbuff, desired_number )
perfstat_id_wpar_t *name;
perfstat_cpu_total_wpar_t *userbuff;
size_t sizeof_userbuff;
int desired_number;

描述

perfstat_cpu_total_wpar 子例程返回 perfstat_cpu_total_wpar_t 结构中的 工作负载分区 (WPAR) 处理器使用统计信息。

要从全局环境获取任何特定 WPAR 的统计信息，必须在 name 参数中指定 WPAR 标识或 WPAR 名称。 必须分配 userbuff 参数，并且必须将 desired_number 参数设置为 1 的值。 在 WPAR中调用此子例程时，必须将 name 参数设置为 NULL。

参数

项 描述
NAME 指定 WPAR 标识或 WPAR 名称。 如果从 WPAR调用子例程，那么为 NULL。
用户缓冲区 指向要使用 perfstat_cpu_total_wpar_t 结构填充的内存区域。
sizeof_userbuff 指定 perfstat_cpu_total_wpar_t 结构的大小。
desired_number 指定要返回的结构数。 此参数的值必须设置为 1 的值。

返回值

成功完成后，将返回已填充的结构数。 如果不成功，则返回值为-1，并设置errno全局变量。

错误代码

如果下列其中一项为 true ，那么 perfstat_cpu_total_wpar 子例程将失败:

项 描述
EINVAL 其中一个参数无效。
Efault 内存不足。
ENOMEM 字符串的缺省长度太短。

文件

libperfstat.h 文件定义标准宏，数据类型和子例程。