Previous
Processor Set Properties
- pset.comment (writable string)
User description of resource.
- pset.default (read-only boolean)
Identifies the default processor set.
- pset.escapable (writable boolean)
Represents whether PSET_NOESCAPE is set for this pset. See the pset_setattr(2) man page.
- pset.load (read-only unsigned integer)
The load for this processor set. The lowest value is 0. The value increases in a linear fashion with the load on the set, as measured by the number of jobs in the system run queue.
- pset.max (writable unsigned integer)
Maximum number of CPUs that are permitted in this processor set.
- pset.min (writable unsigned integer)
Minimum number of CPUs that are permitted in this processor set.
- pset.name (writable string)
User name for the resource.
- pset.size (read-only unsigned integer)
Current number of CPUs in this processor set.
- pset.sys_id (read-only integer)
System-assigned processor set ID.
- pset.type (read-only string)
Names the resource type. Value for all processor sets is pset.
- pset.units (read-only string)
Identifies the meaning of size-related properties. The value for all processor sets is population.
- cpu.comment (writable string)
User description of CPU
Using libpool to Manipulate Pool Configurations
The libpool(3LIB) pool configuration library defines the interface for reading and writing pools configuration files. The library also defines the interface for committing an existing configuration to becoming the running operating system configuration. The <pool.h> header provides type and function declarations for all library services.
The resource pools facility brings together process-bindable resources into a common abstraction that is called a pool. Processor sets and other entities can be configured, grouped, and labelled in a persistent fashion. Workload components can be associated with a subset of a system's total resources. The libpool(3LIB) library provides a C language API for accessing the resource pools facility. The pooladm(1M), poolbind(1M), and poolcfg(1M) make the resource pools facility available through command invocations from a shell.
Manipulate psets
The following list contains the functions associated with creating or destroying psets and manipulating psets.
processor_bind(2) | Bind an LWP (lightweight process) or set of LWPs to a specified processor. |
pset_assign(2) | Assign a processor to a processor set. |
pset_bind(2) | Bind one or more LWPs (lightweight processes) to a processor set. |
pset_create(2) | Create an empty processor set that contains no processors. |
pset_destroy(2) | Destroy a processor set and release the associated constituent processors and processes. |
pset_setattr(2), pset_getattr(2) | Set or get processor set attributes. |
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:
Functions for Operating on Resource Pools and Associated Elements
Functions for Querying Resource Pools and Associated Elements
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. |