perfstat_virtualdiskadapter 子例程
用途
在 Virtual I/O Server (VIOS) 中检索虚拟小型计算机系统接口 (SCSI) 或串行连接 SCSI (SAS) 适配器使用情况统计信息。
库
Perfstat 库 (libperfstat.a)
语法
#include <libperfstat.h>
int perfstat_virtualdiskadapter (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t * name;
perfstat_diskadapter_t * userbuff;
size_t sizeof_struct;int desired_number;描述
perfstat_virtualdiskadapter 子例程检索一个或多个虚拟 SCSI/SAS 适配器使用情况统计信息。
同样功能也可用于检索虚拟 SCSI/SAS 适配器 (VHOST) 统计信息的可用集数。
要获取一组或多组虚拟 SCSI 使用情况度量，请将 name 参数设置为要收集其统计信息的第一个虚拟 SCSI 适配器的名称，并设置 desired_number 参数。 要从第一个虚拟 SCSI 适配器开始，请将 name 参数设置为引号 ("") 或 FIRST_VHOST。 userbuff 参数必须始终指向足以包含此子例程要复制的 perfstat_diskadapter_t 结构数的内存区域。 返回时， name 参数将设置为下一个网络适配器的名称，并使用引号 ("") 复制所有结构之后。
要检索虚拟 SCSI 适配器使用情况度量的可用集合数，请将 name 参数和 userbuff 参数设置为空值，并将 desired_number 参数设置为零值。 返回的值是可用的 vhost 适配器数。 perfstat_virtualdiskadapter 子例程仅在 VIOS 机器中提供统计信息。
参数
| 项 | 描述 |
|---|---|
| 名称 | 包含引号 ("")， FIRST_VHOST 或指示要检索其统计信息的第一个网络适配器卷组的名称。 例如: vhost0， vhost1。 |
| 用户缓冲区 | 指向要使用一个或多个 perfstat_diskadapter_t 结构填充的内存。 |
| 大小结构 | 指定 perfstat_diskadapter_t 结构的大小。 |
| 期望数 (desired_number) | 指定要复制到 userbuff 参数的 perfstat_diskadapter_t 结构数。 |
返回值
成功完成后，将返回已填充的结构数。
如果不成功，则返回值为 -1。
错误代码
如果下列其中一项为 true ，那么 perfstat_virtualdiskadapter 子例程将失败:
| 项 | 描述 |
|---|---|
| EINVAL | 其中一个参数无效 |
| Efault | 内存不足 |
| ENOMEM | 字符串的缺省长度太短。 |
| ENOMSG | 字典不可访问。 |
文件
libperfstat.h 文件定义标准宏，数据类型和子例程。