wlm_delete_class 子例程
用途
删除类。
库
工作负载管理器库 (libwlm.a)
语法
描述
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 头文件的描述。