NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE | EXAMPLES | ATTRIBUTES | SEE ALSO
The poolcfg command provides configuration operations on pools and sets. These operations are performed upon an existing configuration and take the form of modifications to the specified configuration file. The special discover command does not require an existing configuration. Actual activation of the resulting configuration is achieved by way of the pooladm(1M) command.
Pools configuration files are structured files that must have been constructed using poolcfg itself or libpool(3LIB) directly.
The configurations which are created by this tool may be used by pooladm to instantiate the configuration upon a target host.
The following options are supported:
Specify command as an editing command. See USAGE.
Take the commands from command_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 to poolcfg -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.
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.
Change the name of an entity on the system to its new name.
( proptype name = value [ ; proptype name = value ]* )
where the last definition in the sequence for a given proptype, name pair is the one that holds. For property deletion, use ~ proptype name.
( resourcetype name [ ; resourcetype name ]* )
where the last specification in the sequence for a resource is the one that holds. There is no deletion syntax for resource lists.
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 in formats(5).
Scientific notation is not supported.
The following command creates an initial configuration file for this host. By not supplying a file name, /etc/pooladm.conf is assumed.
$ poolcfg -c discover |
The following command creates an initial configuration file for this host and writes it to /home/admin/new_config:
$ poolcfg -c discover /home/admin/new_config |
The following poolcfg script creates a pool named Accounting, and a processor set, small-1. The processor set is created first, then the pool is created and associated with the set.
create pset small-1 ( uint pset.min = 1 ; uint pset.max = 4) create pool Accounting associate pool Accounting ( pset small-1 ) |
The following command reports on pool_0 to standard output in human readable form:
# poolcfg -c 'info pool pool_0' /etc/pooladm.conf |
The following command destroys pool_0 and associations, but not the formerly associated resources:
# poolcfg -c 'destroy pool pool_0' /etc/pooladm.conf |
The following command displays the current configuration:
$ poolcfg -c 'info' /etc/pooladm.conf system muskoka 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 |
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Availability |
SUNWpool |
Interface Stability Invocation Output |
Evolving Unstable |
pooladm(1M), poolbind(1M), libpool(3LIB), attributes(5), formats(5)
System Administration Guide: Resource Management and Network Services
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE | EXAMPLES | ATTRIBUTES | SEE ALSO