wlm_change_class 子例程

用途

更改一个类的一些属性。

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

语法

#include <sys/wlm.h>

int wlm_change_class ( wlmargs)

struct wlm_args *wlmargs;

描述

wlm_change_class 子例程更改现有超类或子类的属性。 除了它的名称之外,类的任何属性都可以通过调用 wlm_change_class进行修改。

  • 如果在 康迪尔 字段中传递了有效配置的名称,那么子例程将更新目标配置的工作负载管理器 (WLM) 属性文件。
  • 如果在 康迪尔 字段中传递了空字符串 ("\0") ,那么这些更改将仅应用于核心 WLM 数据。 未更新 WLM 属性文件。

类型为 struct class_definition的结构是 结构 wlm_args的一部分,通常已使用对 wlm_init_class_definition的调用进行初始化。 完成此操作后,请初始化此结构的必填字段 (例如要修改的类的名称) 以及与您要修改的类属性相对应的字段。 有关各种类属性的可能值及其默认值的说明,请参阅文件参考中的wlm.h说明。

调用程序必须具有 root 用户权限才能更改超类的属性,并且必须具有超类上的管理员权限才能更改超类的子类的属性。

注: 请勿在 wlm_args 结构的 康迪尔 字段中指定一个集合。 wlm_change_class 子例程无法应用于一组基于时间的配置。

参数

描述
Wlmargs 指定 结构 wlm_args 数据结构的地址,此数据结构包含要修改的类的 class_definition 结构。

需要提供 wlm_args 结构和嵌入式子结构的下列字段:

描述
弗尔斯标志 需要使用 WLM_VERSION。 进行初始化
康迪尔 指定该目标类所属的 WLM 配置的名称。 它必须是 /etc/wlm 的有效子目录的名称或空字符串 (以 "\0" 开头)。

如果名称是有效的子目录,那么将修改给定配置中的相关类描述文件。

如果名称为空字符串,那么不会更新任何描述文件。 修改后的类属性将以类似于调用 Wlm_load的方式传递到内核。

名称 指定要修改的超类的名称或子类的名称。 如果这是子类名称,那么其格式必须为 super_name.sub_name。 没有此字段的缺省值。

如果用户不希望更改当前值,那么所有其他字段都可以保留在 wlm_init_class_definition 设置的初始值上。

返回值

成功完成后, wlm_change_class 子例程将返回值 0。 如果 wlm_change_class 子例程不成功,那么将返回非零值。

错误代码

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