perfstat_memory_total 子例程

用途

检索全局内存使用情况统计信息。

Perfstat 库 (libperfstat.a)

语法

#include <libperfstat.h>

int perfstat_memory_total (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t *name;
perfstat_memory_total_t *userbuff;
size_t sizeof_struct;
int desired_number;

描述

perfstat_memory_total 子例程以 perfstat_memory_total_t 结构返回全局内存使用情况统计信息。

要获取整个系统的全局统计信息,必须将 name 参数设置为 NULL ,必须分配 userbuff 参数,并且必须将 desired_number 参数设置为 1。

此子例程仅返回 工作负载分区 (WPAR) 内的全局处理器统计信息。

参数

表 1. 参数
描述
名称

必须设置为 NULL。

用户缓冲区 指向要使用 perfstat_memory_total_t 结构填充的内存区域。
大小结构 指定 perfstat_memory_total_t 结构的大小: sizeof(perfstat_memory_total_t)
期望数 (desired_number) 必须设置为 1。

返回值

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

错误代码

如果满足以下条件,那么 perfstat_memory_total 子例程将失败:

表 2。 错误代码
描述
EINVAL 其中一个参数无效。

文件

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