perfstat_processor_pool_util 子例程
用途
计算与处理器池利用率相关的度量。
库
perfstat library (libperfstat.a)
语法
#include <libperfstat.h>
int perfstat_processor_pool_util (perfstat_rawdata_t * data ,perfstat_processor_pool_util_t * userbuff
int sizeoff_userbuff,
int desired_number);
描述
perfstat_processor_pool_util 子例程计算与传递到 perfstat_rawdata_t 数据结构的当前值和先前值的处理器池利用率相关的度量。
通过将 perfstat_rawdata_t 数据结构的 类型 字段指定为 SHARED_POOL_UTIL来计算池利用率。 SHARED_POOL_UTIL 是可在 perfstat_rawdata_t 数据结构定义中引用的宏。
参数
- 数据
- 根据当前值和先前值计算与处理器池利用率相关的度量值。
data 参数属于 perfstat_rawdata_t 数据结构类型。 curstat 和 prevstat 属性指向 perfstat_partition_total 数据结构。
- 用户 buff
- 指定要使用一个或多个 perfstat_processor_util_t 结构填充的内存区域。
- 大小用户缓冲区
- 指定 perfstat_processor_util_t 结构的大小。
- 期望数
- 指定要复制到 userbuff 参数的 perfstat_processor_util_t 结构的数目。 该值需要设置为 1。
错误代码
如果以下情况成立,那么 perfstat_processor_pool_util 子例程不成功:- EINVAL
- 如果其中一个参数无效,那么将设置该值。
- EPERM
- 如果未启用性能数据收集,那么将设置该值。
返回值
如果 data 参数设置为 NULL ,并且 userbuff 参数也设置为 NULL ,并且 sizeof_userbuff 参数设置为 0 ,那么将返回 perfstat_processor_pool_util_t 子例程的大小。
除非使用 perfstat_processor_pool_util 子例程来检索可用结构数,否则成功完成时将返回填充的结构数。 否则,返回值为-1并设置Erno全局变量。
注: perfstat_processor_pool_util 子例程要求启用性能数据收集以返回处理器池值。