wlm_set 子例程

在线编辑

用途

设置或查询工作负载管理器 (WLM) 状态。

库

工作负载管理器库 (libwlm.a)

语法

#include <sys/wlm.h>

int wlm_set ( flags)
int  *flags;

描述

wlm_set 子例程用于设置，更改或查询 WLM 的运行方式。 WLM 的状态可以是:

项 描述
OFF 不对进程进行分类，监视或调节资源利用率。
开启 处于 被动 方式 对进程进行分类并监视其资源使用情况，但不进行监管。
开启 处于 活动 方式 指定 WLM 对进程进行分类，监视和调节资源使用情况的正常操作方式。

参数

项 描述
标志 指定以类似于传递给其他 API 例程的 Wlmargs 结构的 弗尔斯标志 字段的方式解释的整数的地址。 标志 所指向的整数应该使用 WLM_VERSION进行初始化。 此外，还可以将以下一个或多个值组织到 WLM_VERSION:
WLM_TEST_ON
查询 WLM 的状态而不更改它。
WLM_OFF
关闭 WLM。
WLM_ACTIVE
以 活动 方式打开 WLM 或从任何方式转换为 活动 方式。
WLM_CPU_ONLY
在 活动 方式下仅针对 CPU 资源开启 WLM ，或者从任何方式转换到此方式。 这与 WLM_ACTIVE相同，但仅对 CPU 资源进行监管。 其他资源 (内存，磁盘 IO 以及启用时的总限制) 仍会被占用。
WLM_PASSIVE
以 被动 方式打开 WLM 或从任何方式转换为 被动 方式。
WLM_BIND_RSETS
WLM 将资源集绑定考虑在内的请求。
WLM_proctotal
启用进程对资源使用情况的总限制。
WLM_CLASSTOTAL
启用资源使用情况的类总限制。
以上标志的某些组合是不合法的:
  • WLM_OFF， WLM_ACTIVE， WLM_CPU_ONLY和 WLM_PASSIVE 是互斥的。
  • 当与 WLM_OFF一起使用时， WLM_BIND_RSETS， WLM_proctotal和 WLM_CLASSTOTAL无效。
  • 仅允许对非 root 用户使用 WLM_TEST_ON 。
  • 如果指定了 WLM_TEST_ON ，那么其他标志无效，并且不应指定。

返回值

在成功完成后， wlm_set 子例程返回值 0 ，并且在 标志 参数中返回 WLM 的当前状态。 返回的值为 WLM_OFF， WLM_ACTIVE， WLM_CPU_ONLY或 WLM_PASSIVE。 如果 WLM 处于任一方式， WLM_BIND_RSETS， WLM_proctotal和 WLM_CLASSTOTAL，那么将在适当时添加标志。

错误代码

有关 WLM API 函数返回的可能错误代码的列表，请参阅 wlm.h 头文件的描述。

相关信息

wlmcntrl 命令。

wlm.h 头文件。

Wlm_load (wlm_load 子例程) 子例程。