JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Resource Management, Oracle Solaris Zones, and Oracle Solaris 10 Zones Developer's Guide     Oracle Solaris 11.1 Information Library
search filter icon
search icon

Document Information

Preface

1.  Resource Management in the Oracle Solaris Operating System

2.  Projects and Tasks

3.  Using the C Interface to Extended Accounting

4.  Using the Perl Interface to Extended Accounting

5.  Resource Controls

6.  Resource Pools

Overview of Resource Pools

Scheduling Class

Dynamic Resource Pool Constraints and Objectives

System Properties

Pools Properties

Processor Set Properties

Using libpool to Manipulate Pool Configurations

Manipulate psets

Resource Pools API Functions

Functions for Operating on Resource Pools and Associated Elements

Functions for Querying Resource Pools and Associated Elements

Resource Pool Code Examples

Ascertain the Number of CPUs in the Resource Pool

List All Resource Pools

Report Pool Statistics for a Given Pool

Set pool.comment Property and Add New Property

Programming Issues Associated With Resource Pools

zonestat Utility for Monitoring Resource Pools in Oracle Solaris Zones

7.  Design Considerations for Resource Management Applications in Oracle Solaris Zones

8.  Configuration Examples

Index

Resource Pools API Functions

This section lists all of the resource pool functions. Each function has a link to the man page and a short description of the function's purpose. The functions are divided into two groups, depending on whether the function performs an action or a query:

The imported interfaces for libpool for swap sets is identical to the ones defined in this document.

Functions for Operating on Resource Pools and Associated Elements

The interfaces listed in this section are for performing actions related to pools and the associated elements.

pool_associate(3POOL)

Associate a resource with a specified pool.

pool_component_to_elem(3POOL)

Convert specified component to the pool element type.

pool_conf_alloc(3POOL)

Create a pool configuration.

pool_conf_close(3POOL)

Close the specified pool configuration and release the associated resources.

pool_conf_commit(3POOL)

Commit changes made to the specified pool configuration to permanent storage.

pool_conf_export(3POOL)

Save the given configuration to the specified location.

pool_conf_free(3POOL)

Release a pool configuration.

pool_conf_open(3POOL)

Create a pool configuration at the specified location.

pool_conf_remove(3POOL)

Removes the permanent storage for the configuration.

pool_conf_rollback(3POOL)

Restore the configuration state to the state that is held in the pool configuration's permanent storage.

pool_conf_to_elem(3POOL)

Convert specified pool configuration to the pool element type.

pool_conf_update(3POOL)

Update the library snapshot of kernel state.

pool_create(3POOL)

Create a new pool with the default properties and with default resources for each type.

pool_destroy(3POOL)

Destroy the specified pool. The associated resources are not modified.

pool_dissociate(3POOL)

Remove the association between the given resource and pool.

pool_put_property(3POOL)

Set the named property on the element to the specified value.

pool_resource_create(3POOL)

Create a new resource with the specified name and type for the provided configuration.

pool_resource_destroy(3POOL)

Remove the specified resource from the configuration file.

pool_resource_to_elem(3POOL)

Convert specified pool resource to the pool element type.

pool_resource_transfer(3POOL)

Transfer basic units from the source resource to the target resource.

pool_resource_xtransfer(3POOL)

Transfer the specified components from the source resource to the target resource.

pool_rm_property(3POOL)

Remove the named property from the element.

pool_set_binding(3POOL)

Bind the specified processes to the resources that are associated with pool on the running system.

pool_set_status(3POOL)

Modify the current state of the pools facility.

pool_to_elem(3POOL)

Convert specified pool to the pool element type.

pool_value_alloc(3POOL)

Allocate and return an opaque container for a pool property value.

pool_value_free(3POOL)

Release an allocated property values.

pool_value_set_bool(3POOL)

Set a property value of type boolean.

pool_value_set_double(3POOL)

Set a property value of type double.

pool_value_set_int64(3POOL)

Set a property value of type int64.

pool_value_set_name(3POOL)

Set a name=value pair for a pool property.

pool_value_set_string(3POOL)

Copy the string that was passed in.

pool_value_set_uint64(3POOL)

Set a property value of type uint64.

Functions for Querying Resource Pools and Associated Elements

The interfaces listed in this section are for performing queries related to pools and the associated elements.

pool_component_info(3POOL)

Return a string that describes the given component.

pool_conf_info(3POOL)

Return a string describing the entire configuration.

pool_conf_location(3POOL)

Return the location string that was provided to pool_conf_open() for the given specified configuration.

pool_conf_status(3POOL)

Return the validity status for a pool configuration.

pool_conf_validate(3POOL)

Check the validity of the contents of the given configuration.

pool_dynamic_location(3POOL)

Return the location that was used by the pools framework to store the dynamic configuration.

pool_error(3POOL)

Return the error value of the last failure that was recorded by calling a resource pool configuration library function.

pool_get_binding(3POOL)

Return the name of the pool on the running system that contains the set of resources to which the specified process is bound.

pool_get_owning_resource(3POOL)

Return the resource that currently contains the specified component.

pool_get_pool(3POOL)

Return the pool with the specified name from the provided configuration.

pool_get_property(3POOL)

Retrieve the value of the named property from the element.

pool_get_resource(3POOL)

Return the resource with the given name and type from the provided configuration.

pool_get_resource_binding(3POOL)

Return the name of the pool on the running system that contains the set of resources to which the given process is bound.

pool_get_status(3POOL)

Retrieve the current state of the pools facility.

pool_info(3POOL)

Return a description of the specified pool.

pool_query_components(3POOL)

Retrieve all resource components that match the specified list of properties.

pool_query_pool_resources(3POOL)

Return a null-terminated array of resources currently associated with the pool.

pool_query_pools(3POOL)

Return the list of pools that match the specified list of properties.

pool_query_resource_components(3POOL)

Return a null-terminated array of the components that make up the specified resource.

pool_query_resources(3POOL)

Return the list of resources that match the specified list of properties.

pool_resource_info(3POOL)

Return a description of the specified resource.

pool_resource_type_list(3POOL)

Enumerate the resource types that are supported by the pools framework on this platform.

pool_static_location(3POOL)

Return the location that was used by the pools framework to store the default configuration for pools framework instantiation.

pool_strerror(3POOL)

Return a description of each valid pool error code.

pool_value_get_bool(3POOL)

Get a property value of type boolean.

pool_value_get_double(3POOL)

Get a property value of type double.

pool_value_get_int64(3POOL)

Get a property value of type int64.

pool_value_get_name(3POOL)

Return the name that was assigned to the specified pool property.

pool_value_get_string(3POOL)

Get a property value of type string.

pool_value_get_type(3POOL)

Return the type of the data that is contained by the specified pool value.

pool_value_get_uint64(3POOL)

Get a property value of type uint64.

pool_version(3POOL)

Get the version number of the pool library.

pool_walk_components(3POOL)

Invoke callback on all components that are contained in the resource.

pool_walk_pools(3POOL)

Invoke callback on all pools that are defined in the configuration.

pool_walk_properties(3POOL)

Invoke callback on all properties defined for the given element.

pool_walk_resources(3POOL)

Invoke callback on all resources that are associated with the pool.