Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
poold [-l level]
poold provides automated resource partitioning facilities. poold can be enabled or disabled using the Solaris Service Management Facility, smf(7). poold requires the Resource Pools facility to be active in order to operate.
The dynamic resource pools service's fault management resource identifier (FMRI) is:
svc:/system/pools/dynamic
The resource pools service's FMRI is:
svc:/system/pools
poold's configuration details are held in a libpool(3LIB) configuration and you can access all customizable behavior from this configuration.
poold periodically examines the load on the system and decides whether intervention is required to maintain optimal system performance with respect to resource consumption. poold also responds to externally initiated (with respect to poold) changes of either resource configuration or objectives.
If intervention is required, poold attempts to reallocate the available resources to ensure that performance objectives are satisfied. If it is not possible for poold to meet performance objectives with the available resources, then a message is written to the log. poold allocates scarce resources according to the objectives configured by the administrator. The system administrator must determine which resource pools are most deserving of scarce resource and indicate this through the importance of resource pools and objectives.
The following options are supported: -l level
Specify the verbosity level for logging information. Specify level as ALERT, CRIT, ERR, WARNING, NOTICE, INFO, and DEBUG. If level is not supplied, then the default logging level is INFO. ALERT
A condition that should be corrected immediately, such as a corrupted system database.
Critical conditions, such as hard device errors.
Errors.
Warning messages.
Conditions that are not error conditions, but that may require special handling.
Informational messages.
Messages that contain information normally of use only when debugging a program.
When invoked manually, with the -l option, all log output is directed to standard error.
Example 1 Modifying the Default Logging Level
The following command modifies the default logging level to ERR:
# /usr/lib/pool/poold -l ERR
Example 2 Enabling Dynamic Resource Pools
The following command enables dynamic resource pools:
# /usr/sbin/svcadm enable svc:/system/pools/dynamic
See attributes(7) for descriptions of the following attributes:
| ATTRIBUTE TYPE ATTRIBUTE VALUE |
| Interface Stability See below. |
The invocation is Evolving. The output is Unstable.
libpool (3LIB), pool_set_status (3POOL), attributes (7), smf (7), pooladm (8), poolbind (8), poolcfg (8), poolstat (8), svcadm (8)