| Skip Navigation Links | |
| Exit Print View | |
 | man pages section 1M: System Administration Commands Oracle Solaris 11 Information Library |
| Skip Navigation Links | |
| Exit Print View | |
| man pages section 1M: System Administration Commands Oracle Solaris 11 Information Library |
- create and modify resource pool configuration files
/usr/sbin/poolcfg-ccommand [-d | [filename]]
/usr/sbin/poolcfg-fcommand_file [-d | [filename]]
/usr/sbin/poolcfg-h
Thepoolcfg utility provides configuration operations on pools and sets. These operationsare performed upon an existing configuration and take the form of modificationsto the specified configuration file. If you use the-d option, themodifications occur to the kernel state. Actual activation of the resulting configuration isachieved by way of thepooladm(1M) utility.
Pools configuration files are structured files that must have been constructed usingpoolcfg itself orlibpool(3LIB) directly.
An invocation ofpoolcfg with the pool dynamic location and write permissionwill hang if the dynamic location has already been opened for writing.
The configurations which are created by this utility can be used bypooladm to instantiate the configuration upon a target host.
The following options are supported:
Specifycommand as an editing command. SeeUSAGE.
Operate directly on the kernel state. Nofilename is allowed.
Take the commands fromcommand_file.command_file consists of editing commands, one per line.
Display extended information about the syntax of editing commands.
A script consists of editing commands, one per line, of the following:
Display configuration (or specified portion) in human readable form to standard output. If no entity is specified, system information is displayed. Therefore,poolcfg-c'info' afile is an equivalent invocation topoolcfg-c'info system name' afile.
Make an entity of the specified type and name.
Remove the specified entity.
Change the listed properties on the named entity.
Connect one or more resources to a pool, or replace one or more existing connections.
Transfer one or more discrete components to a resource .
Transfer a resource quantity fromsrc totgt.
Transfer a resource quantity totgt fromsrc.
Create a system entity, with one pool entity and resources to match current system configuration. All discovered resources of each resource type are recorded in the file, with the single pool referring to the default resource for each resource type.
This command is a NO-OP whenpoolcfg operates directly on the kernel. See the-d option.
You should avoid use of this command. The preferred method for creating a configuration is to export the dynamic configuration usingpooladm(1M) with the-s option.
Change the name of an entity on the system to its new name.
The property list is specified by:
( proptype name = value [ ; proptype name = value ]* )
where the last definition in the sequence for a given proptype, namepair is the one that holds. For property deletion, use~ proptype name.
A resource list is specified by:
( resourcetype name [ ; resourcetype name ]* )
where the last specification in the sequence for a resource is theone that holds. There is no deletion syntax for resource lists.
A component list is specified by:
( componenttype name [ ; componenttype name ]* )
where the last specification in the sequence for a component is theone that holds. There is no deletion syntax for component lists.
Machine level entity
Named collection of resource associations
Processor set resource
Takes one of two values true or false.
A 64–bit signed integer value.
A 64–bit unsigned integer value.
Strings are delimited by quotes ("), and support the character escape sequences defined informats(5).
Scientific notation is not supported.
Example 1 Writing a poolcfg Script
The followingpoolcfg script creates a pool namedAccounting, and a processorset,small-1. The processor set is created first, then the pool iscreated and associated with the set.
create pset small-1 ( uint pset.min = 1 ; uint pset.max = 4)create pool Accountingassociate pool Accounting ( pset small-1 )
Example 2 Reporting onpool_0
The following command reports onpool_0 to standard output in human readableform:
# poolcfg -c 'info pool pool_0' /etc/pooladm.conf
Example 3 Destroying pool_0 and Its Associations
The following command destroyspool_0 and associations, but not the formerly associatedresources:
# poolcfg -c 'destroy pool pool_0' /etc/pooladm.conf
Example 4 Displaying the Current Configuration
The following command displays the current configuration:
$ poolcfg -c 'info' /etc/pooladm.confsystem example_system int system.version 1 boolean system.bind-default true string system.comment Discovered by libpool pool pool_default boolean pool.default true boolean pool.active true int pool.importance 5 string pool.comment string.pool.scheduler FSS pset pset_default pset pset_default int pset.sys_id -1 string pset.units population boolean pset.default true uint pset.max 4294967295 uint pset.min 1 string pset.comment boolean pset.escapable false uint pset.load 0 uint pset.size 2 cpu int cpu.sys_id 0 string cpu.comment cpu int cpu.sys_id 2 string cpu.comment
Example 5 Moving cpu with ID 2 to Processor Set pset1 in the Kernel
The following command movescpu with ID2 to processor setpset1in the kernel:
# poolcfg -dc 'transfer to pset pset1 ( cpu 2 )'
Example 6 Moving 2 cpus from Processor Set pset1 to Processor Set pset2 in the Kernel
The following command moves 2cpus from processor setpset1 to processorsetpset2 in the kernel:
# poolcfg -dc 'transfer 2 from pset pset1 to pset2'
Seeattributes(5) for descriptions of the following attributes:
|
The invocation is Committed. The output is Uncommitted.
pooladm(1M),poolbind(1M),libpool(3LIB),attributes(5),formats(5)
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices |   |