perfstat_netinterface_total 子例程

用途

检索全局网络接口使用情况统计信息。

Perfstat 库 (libperfstat.a)

语法

#include <libperfstat.h>
int perfstat_netinterface_total (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t *name;
perfstat_netinterface_total_t *userbuff;
size_t sizeof_struct;
int desired_number;

描述

perfstat_netinterface_total 子例程返回 perfstat_netinterface_total_t 结构中的全局网络接口使用情况统计信息。

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

perfstat_netinterface_total 子例程从 ODM 数据库检索信息。 此信息将自动高速缓存到假定在装入后冻结的字典中。 每当机器配置发生更改时,都必须调用 perfstat_reset 子例程来清空字典。

此子例程在 工作负载分区 (WPAR) 中不受支持。 它不知道 WPAR

参数

描述
名称

必须设置为 NULL。

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

返回值

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

错误代码

如果下列其中一个为 true ,那么 perfstat_netinterface_total 子例程将失败:

描述
EINVAL 其中一个参数无效。
Efault 内存不足。

文件

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