资源池 API 函数

本节列出了所有的资源池函数。每个函数都带有指向相应手册页的链接和有关该函数用途的简短说明。根据函数执行操作还是查询，函数分为两组：

• 用于对资源池和关联元素执行操作的函数

• 用于查询资源池和关联元素的函数

用于交换集的 libpool 的导入接口与本文档中定义的接口相同。

用于对资源池和关联元素执行操作的函数

本节中列出的接口用于执行与池和关联元素相关的操作。

pool_associate(3POOL)

将资源与指定的池关联起来。

pool_component_to_elem(3POOL)

将指定的组件转换为池元素类型。

pool_conf_alloc(3POOL)

创建池配置。

pool_conf_close(3POOL)

关闭指定的池配置并释放关联资源。

pool_conf_commit(3POOL)

提交对指定池配置所做的更改以进行永久存储。

pool_conf_export(3POOL)

将给定的配置保存到指定位置。

pool_conf_free(3POOL)

释放池配置。

pool_conf_open(3POOL)

在指定的位置创建池配置。

pool_conf_remove(3POOL)

删除对配置的永久存储。

pool_conf_rollback(3POOL)

将配置状态恢复到池配置的永久存储中保留的状态。

pool_conf_to_elem(3POOL)

将指定的池配置转换为池元素类型。

pool_conf_update(3POOL)

更新内核状态的库快照。

pool_create(3POOL)

使用缺省属性和每种类型的缺省资源创建新的池。

pool_destroy(3POOL)

破坏指定的池。关联的资源不会被修改。

pool_dissociate(3POOL)

删除给定资源与池之间的关联。

pool_put_property(3POOL)

将有关元素的命名属性设置为指定的值。

pool_resource_create(3POOL)

使用所提供配置的指定名称和类型创建新的资源。

pool_resource_destroy(3POOL)

从配置文件中删除指定的资源。

pool_resource_to_elem(3POOL)

将指定的池资源转换为池元素类型。

pool_resource_transfer(3POOL)

将基本单位从源资源传输到目标资源。

pool_resource_xtransfer(3POOL)

将指定组件从源资源传输到目标资源。

pool_rm_property(3POOL)

从元素中删除命名的属性。

pool_set_binding(3POOL)

将指定的进程绑定到与正在运行的系统中的池关联的资源。

pool_set_status(3POOL)

修改池功能的当前状态。

pool_to_elem(3POOL)

将指定的池转换为池元素类型。

pool_value_alloc(3POOL)

分配并返回池属性值的不透明容器。

pool_value_free(3POOL)

释放分配的属性值。

pool_value_set_bool(3POOL)

设置 boolean 类型的属性值。

pool_value_set_double(3POOL)

设置 double 类型的属性值。

pool_value_set_int64(3POOL)

设置 int64 类型的属性值。

pool_value_set_name(3POOL)

为池属性设置 name=value 对。

pool_value_set_string(3POOL)

复制已传递的字符串。

pool_value_set_uint64(3POOL)

设置 uint64 类型的属性值。

用于查询资源池和关联元素的函数

本节中列出的接口用于执行与池和关联元素相关的查询。

pool_component_info(3POOL)

返回描述给定组件的字符串。

pool_conf_info(3POOL)

返回描述整个配置的字符串。

pool_conf_location(3POOL)

返回为指定配置的 pool_conf_open() 提供的位置字符串。

pool_conf_status(3POOL)

返回池配置的有效性状态。

pool_conf_validate(3POOL)

检查给定配置内容的有效性。

pool_dynamic_location(3POOL)

返回池框架用于存储动态配置的位置。

pool_error(3POOL)

返回通过调用资源池配置库函数记录的最终故障的错误值。

pool_get_binding(3POOL)

返回正在运行的系统中的池名称，该池包含与指定进程绑定的资源集。

pool_get_owning_resource(3POOL)

返回当前包含指定组件的资源。

pool_get_pool(3POOL)

返回具有所提供配置中的指定名称的池。

pool_get_property(3POOL)

检索元素中的已命名属性的值。

pool_get_resource(3POOL)

返回具有所提供配置中的给定名称和类型的资源。

pool_get_resource_binding(3POOL)

返回正在运行的系统中的池名称，该池包含与给定进程绑定的资源集。

pool_get_status(3POOL)

检索池功能的当前状态。

pool_info(3POOL)

返回指定池的说明。

pool_query_components(3POOL)

检索与指定的属性列表匹配的所有资源组件。

pool_query_pool_resources(3POOL)

返回当前与池关联的以 NULL 结尾的资源数组。

pool_query_pools(3POOL)

返回与指定的属性列表匹配的池列表。

pool_query_resource_components(3POOL)

返回构成指定资源的以 NULL 结尾的组件数组。

pool_query_resources(3POOL)

返回与指定的属性列表匹配的资源列表。

pool_resource_info(3POOL)

返回指定资源的说明。

pool_resource_type_list(3POOL)

枚举此平台上的池框架支持的资源类型。

pool_static_location(3POOL)

返回池框架用于存储缺省池框架实例化配置的位置。

pool_strerror(3POOL)

返回每个有效池错误代码的说明。

pool_value_get_bool(3POOL)

获取 boolean 类型的属性值。

pool_value_get_double(3POOL)

获取 double 类型的属性值。

pool_value_get_int64(3POOL)

获取 int64 类型的属性值。

pool_value_get_name(3POOL)

返回为指定池属性指定的名称。

pool_value_get_string(3POOL)

获取 string 类型的属性值。

pool_value_get_type(3POOL)

返回指定的池值包含的数据类型。

pool_value_get_uint64(3POOL)

获取 uint64 类型的属性值。

pool_version(3POOL)

获取池库的版本号。

pool_walk_components(3POOL)

调用对资源中包含的所有组件的回调。

pool_walk_pools(3POOL)

调用在配置中定义的所有池的回调。

pool_walk_properties(3POOL)

调用对为给定元素定义的所有属性的回调。

pool_walk_resources(3POOL)

调用对与池关联的所有资源的回调。