pooladm(1M)

NAME

     pooladm - activate and deactivate the resource pools  facil-
     ity

SYNOPSIS

     /usr/sbin/pooladm [-n] [-c [filename] |  -x]

DESCRIPTION

     The pooladm command provides  administrative  operations  on
     pools  and  sets.  pooladm  reads the specified filename and
     attempts to activate the pool configuration contained in it.

     Before updating the  current  pool  run-time  configuration,
     pooladm validates the configuration for correctness.

     Without options, pooladm  prints  out  the  current  running
     pools configuration.

OPTIONS

     The following options are supported:

     -c    Instantiate the configuration at the  given  location.
           If  a  filename  is  not  specified,  it  defaults  to
           /etc/pooladm.conf.

     -n    Validate the configuration without  actually  updating
           the current active files.

     -x    Remove the currently active pool  configuration.  Des-
           troy  all  defined  resources, and return all formerly
           partitioned components to their default resources.

OPERANDS

     The following operands are supported:

     filename
           Use the configuration contained within this file.

EXAMPLES

     Example 1: Instantiating a Configuration

     The following command instantiates  the  configuration  con-
     tained at /home/admin/newconfig:

     example# /usr/sbin/pooladm -c /home/admin/newconfig

     Example 2: Validating the Configuration Without  Instantiat-
     ing It

     The following command attempts to instantiate the configura-
     tion  contained  at  /home/admin/newconfig.  It displays any
     error conditions that it encounters, but does  not  actually
     modify the active configuration.

     example# /usr/sbin/pooladm -n -c /home/admin/newconfig

     Example 3: Removing the Current Configuration

     The following command removes the  current  pool  configura-
     tion:

     example# /usr/sbin/pooladm -x

FILES

     /etc/pooladm.conf

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
   |        ATTRIBUTE TYPE       |        ATTRIBUTE VALUE      |
   | ____________________________|_____________________________|_
   |  Availability               |  SUNWpool                   |
   | ____________________________|_____________________________|_
   |  Interface Stability        |                             |
   |                             |                             |
   |        Invocation           |       Evolving              |
   |                             |                             |
   |        Output               |        Unstable             |
   |_____________________________|_____________________________|

SEE ALSO

     poolcfg(1M), poolbind(1M), libpool(3LIB), attributes(5),

     System Administration Guide: Resource Management and Network
     Services

NOTES

     Resource bindings that are not presented in the  form  of  a
     binding  to a partitionable resource, such as the scheduling
     class, are not necessarily  be  modified  in  a  pooladm  -x
     operation.