perfstat_virtual_fcadapter 子例程

用途

检索虚拟光纤通道适配器 (NPIV) 使用情况统计信息。

库

Perfstat 库 (libperfstat.a)

语法

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

描述

perfstat_virtual_fcadapter 子例程检索一个或多个虚拟光纤通道适配器 (NPIV) 使用情况统计信息。

同样功能也可用于检索虚拟光纤通道适配器 (NPIV) 使用情况统计信息的可用集数。

要获取一组或多组虚拟 FC 适配器 (NPIV) 使用情况度量，请将 name 参数设置为要为其收集统计信息的第一个虚拟 FC 适配器的名称，并设置 desired_number 参数。 要从第一个虚拟 FC 适配器开始，请将 name 参数设置为引号 ("") 或 FIRST_VFCHOST。 userbuff 参数必须始终指向足以包含此子例程要复制的 perfstat_fcstat_t 结构数的内存区域。 返回时， name 参数设置为下一个 FC 适配器的名称或引号 ("") 复制所有结构之后。

要检索虚拟 FC 适配器使用情况度量的可用集合数，请将 name 参数和 userbuff 参数设置为空值，并将 desired_number 参数设置为零值。 返回的值是可用集的数目。

参数

返回值

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

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

错误代码

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

文件

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