wlm_change_class 子例程
用途
更改一个类的一些属性。
库
工作负载管理器库 (libwlm.a)
语法
描述
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 头文件的描述。