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 文件定义标准宏,数据类型和子例程。