wlm.h 文件

用途

定义由 工作负载管理器 (WLM) 应用程序编程接口 (API) 子例程使用的常量，数据结构和函数原型。

描述

wlm.h 文件定义 wlm_args， wlm_assign， wlm_info， wlm_bio_class_info_t和 wlm_bio_dev_info_t以及 wlm_proc_info 结构。 这些结构由 libwlm.a 库中的 WLM API 函数使用。

wlm_args 结构

当使用 API 函数来创建，修改或删除类时， wlm_args 结构用于将类信息传递至 WLM。 wlm_args 结构中包含以下字段:

弗尔斯标志

指定 4 个高阶位，这些位包含 API 用于维护二进制兼容性的版本号 (如果数据结构曾经修改过)。 整数的其余部分用于在需要时将标志传递到子例程。

应该使用版本号 WLM_VERSION 与目标子例程需要的任何标志之间的逻辑 或 操作来初始化该字段。 所有 API 调用的一个公共标志是 WLM_MUTE，该标志用于禁止将错误消息从 WLM 库输出到 STDERR。

康迪尔

指定以 null 结束的字符串。 必须使用目标子例程所应用的 WLM 配置的名称来初始化此字段 (如果适用，具体取决于特定配置)。

或者，可以将此字段设置为空字符串 (\0)。 空字符串指示只将类添加或修改应用于 WLM 内核数据，而不应用于类描述文件。

class

此字段是类型为 struct class_definition 的结构，它包含与目标子例程所需要的超类或子类有关的所有信息。 可以通过调用 wlm_init_class_definition 子例程来初始化此结构中的字段，以便您只需要初始化您希望修改的字段。

wlm_init_class_definition 子例程中的主结构是类描述 struct class_descr，它具有以下字段:

恢复

指定类型为 struct wlm_bounds 的数组，其中包含每个资源类型和每个总限制的以下字段:

国际联谊会 /international opri-association

指定分类到类中的线程发出的 I/O 请求的优先级。 此优先级用于确定设备级别的 I/O 缓冲区的优先级。 有效 I/O 优先级范围从 0 到 15。

min

指定最小值，该值介于 0 (缺省值) 与 100 (未使用的总限制) 之间。

共享

指定共享号，它是 1 到 65535 之间的值。 该值 -1 （默认）表示给定资源不受该类别的WLM管理（不适用于总量限制）。

世界

包含 softmax (针对所有资源，但总限制) 和 unit (仅针对总限制) 字段的并集:

软最大值

指定软最大限制，即 0 到 100 之间的值 (缺省值)。 该值必须大于或者等于 最小 字段的值。

商品

这是一个字符串 (3 3 个字符) ，用于指定应用于总限制的硬最大值的单位。 要让单元保持未定义状态，请将 softmax 字段设置为 WLM_UNIT_UNDEF。 对于 WLM_RES_TOTALCONNECT 和 WLM_RES_TOTALCPU，缺省单位为 "s" (秒) ，而其他值为 "m" (分钟) ， "h" (小时) ， "d" (天) 和 "w" (周)。 对于 WLM_RES_TOTALDISKIO，缺省单位为 "KB" (千字节) ，其他值为 "MB" (兆字节) ， "GB" (千兆字节) ， "TB" (太字节) ， "PB" (PB) ， "EB" (EB) (EB)。 其他总计限制不具有单位。 对于 WLM_RES_TOTALVMEM 和 WLM_RES_PROCVMEM，将单位设置为 "MB" ， "GB" 和 "TB"。

哈德马克斯

对于所有资源，但总限制。 指定硬最大限制，即 0 到 100 之间的值 (缺省值)。 该值必须大于或等于 最小 和 软最大值 字段中的每个值。 对于总限制，此参数指定它们的值，可能与 单位 字段一起使用。 如果用户未指定单位值，那么会使用缺省单位值。 但是，用户可以指定除缺省值以外的单位值。 缺省值 (未指定总计限制) 为 WLM_HARDMAX_UNDEF。

资源类型定义为 WLM_RES_CPU ， WLM_RES_MEM， WLM_RES_BIO，总限制定义为 WLM_RES_TOTALCPU (进程的总 CPU 时间) ， WLM_RES_TOTALDISKIO (进程的总磁盘 IO 数) ， WLM_RES_TOTALCONNECT (总连接时间) ， WLM_RES_TOTALPROC (总进程数) ， WLM_RES_TOTALTHRD (总线程数) ， WLM_RES_TOTALLOGIN (总登录会话数) ， WLM_RES_TOTALVMEM (类的总虚拟内存使用情况) 和 WLM_RES_PROCVMEM (进程的总虚拟内存使用情况)。 每个值都表示元素数组中的下标，对应于资源类型或总限制。

层

指定类的层号，它是 0 (缺省值) 到 9 之间的值

继承 (inheritance)

指定新进程的分类方式。 值 0 (缺省值) 指示在调用 执行 子例程时，应使用类分配规则对新进程进行分类。 值为 1 表示该进程从其父进程继承类分配。

localshm

指示当属于另一个类的进程访问此类中的内存段时，该类中的内存段是否保持本地 1 (值 1) ，或者它们是否转至共享类 (值 0 ，缺省值)。

分配用户标识符

指定被允许将进程手动分配给类的用户的用户标识。 该值必须是有效的用户标识。

如果未指定此属性，那么缺省值为未授权用户 (WLM_NOGUID)。

分配组ID

指定允许将进程手动分配给该类的用户的组标识。 该值必须是有效的组标识。 该值必须是有效的组标识。 未指定此属性时，缺省值为未授权任何组 (WLM_NOGUID)。

如果 assign_uid 和 assign_gid 字段都是缺省值，那么只有 root 用户才能将进程分配给类。

管理员用户ID

指定被允许管理超类的子类的用户的用户标识 (此属性仅对超类有效)

管理员组ID

指定被允许管理超类的子类的用户的组标识 (此属性仅对超类有效)

如果 admin_uid 和 admin_gid 字段都保留为它们的缺省值 (WLM_NOGUID) ，那么只有 root 用户才能管理此超类的子类。

名称

指定类的以 null 结束的完整名称。 对于超类，该值的格式必须为 super_name ，对于子类，该值的格式必须为 super_name.sub_name 。 超类名称和子类名称各限制为 16 个字符。 此字段没有缺省值。

除了类描述字段之外， class_definition 结构还会添加两个字段:

Rset_name

指定一个以 null 结束的字符串，其中包含类被限制为的资源集 (分区) 的名称 (如果适用)。 缺省值是该类可以访问系统上的所有资源。

Descr_field

指定一个以 null 结束的字符串，其中包含类的描述文本。 此字段是可选的，并且没有缺省值。

delshm

指定如果由于虚拟内存限制而终止了引用该段的最后一个进程，那么是否删除共享内存段。 有效值为 "yes" 和 "no" (缺省值)。

弗门武夫

指定在达到虚拟内存限制时是终止故障进程 (值为 "proc" ，缺省值) 还是终止类中的所有进程 (值为 "class")。

wlm_assign 结构

wlm_assign 结构用于使用 wlm_assign 子例程手动将进程或进程组指定给指定的超类或子类。 wlm_assign 结构中包含以下字段:

wlm_info 结构

wlm_bio_class_info_t 和 wlm_bio_dev_info_t 结构

可以使用两个结构来通过 wlm_get_bio_stats 子例程获取 I/O 统计信息，具体取决于应用程序是需要按类统计信息还是需要按设备统计信息。

wlm_proc_info 结构

wlm_proc_info 结构用于抽取 工作负载管理器 有关使用 wlm_get_procinfo 子例程的进程的信息。 仅当启用了总进程限制时， 总连接时间， 时间， 总 cputime和 托洛迪斯基奥 字段才有意义。 wlm_proc_info 结构中包含以下字段:

版本 (version)

此字段应该使用 WLM_VERSION进行初始化。

wlmflags

指定进程的某些 工作负载管理器 属性，例如具有 rset SWLMRSET 的进程，或者作为派生 SWLMTAGINHERITFORK 或 exec SWLMTAGINHERITEXEC上的标记继承。

totalConnectTime

指定表示登录会话已处于活动状态的时间量 (以秒为单位) 的 64 位数字。

总 vmem

指定进程使用的虚拟内存总量 (以 MB 为单位)。

时间

指定 64 位数字，该数字表示已请求终止进程的时间 (从 1970 年开始以秒计)。

总 cputime

指定用于表示进程的 CPU 耗用量 (以微秒为单位) 的 64 位数字。

totalDiskIO

指定用于表示进程已运行的 IO 量 (以 512 字节块为单位) 的 64 位数字。

类名

指定对进程进行分类的超类或子类的完整名称。

标记 (tag)

指定与进程关联的字符串 (如果有) (请参阅 wlm_set_tag 子例程)。

错误代码