wlm_delete_class 子例程

用途

删除类。

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

语法

#include <sys/wlm.h>

int wlm_delete_class ( wlmargs)

struct wlm_args *wlmargs;

描述

wlm_delete_class 子例程删除现有超类或子类。 如果超类仍定义了除缺省值和共享之外的子类,那么无法删除该超类。

  • 如果在 康迪尔 字段中传递了有效配置的名称,那么子例程将更新目标配置的工作负载管理器 (WLM) 属性文件,从而除去对要删除的类的所有引用。
  • 如果在 康迪尔 字段中传递了空字符串 ("\0") ,那么将仅从核心 WLM 数据结构中删除该类。 未更新 WLM 属性文件。 这通常用于删除也仅在核心内 WLM 数据结构中创建的类。 否则,类删除是临时的,并且在使用类文件中存在该类的配置来更新或重新启动 WLM 时,将再次创建该类。

调用者必须具有删除超类的 root 用户权限,并且必须具有超类上的管理员权限才能删除超类的子类。

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

参数

描述
Wlmargs 指定 结构 wlm_args 数据结构的地址,该数据结构包含有关要删除的类的信息。

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

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

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

如果名称为空字符串,那么不会更新任何描述文件。 将从内核 WLM 数据结构中移除该类。

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

对于此调用,所有其他字段都可以保持未初始化状态。

返回值

成功完成后, wlm_delete_class 子例程将返回值 0。 如果 wlm_delete_class 子例程不成功,那么返回 non-0 值。

错误代码

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