metaclear(1M)

NAME

     metaclear - delete active metadevices and hot spare pools

SYNOPSIS

     /usr/sbin/metaclear -h

     /usr/sbin/metaclear [-s setname] -a [-f]

     /usr/sbin/metaclear component

     /usr/sbin/metaclear    [-s setname]    [-f]    metadevice...
     hot_spare_pool...

     /usr/sbin/metaclear  [-s setname]  -r   [-f]   metadevice...
     hot_spare_pool...

     /usr/sbin/metaclear [-s setname] -p component

     /usr/sbin/metaclear [-s setname] -p metadevice

DESCRIPTION

     The metaclear command deletes the  specified  metadevice  or
     hot_spare_pool.,  or  purges  all  soft  partitions from the
     designated component. Once a metadevice or hot spare pool is
     deleted,  it must be re-created using metainit before it can
     be used again.

     Any metadevice currently in use (open) cannot be deleted.

OPTIONS

     Root privileges  are  required  for  all  of  the  following
     options except -h.

     -a    Deletes all metadevices and configured hot spare pools
           in the set named by -s, or the local set by default.

     -f    Deletes (forcibly) a metadevice that contains  a  sub-
           component in an error state.

     -h    Displays usage message.

     -p    Deletes (purges) all soft partitions from  the  speci-
           fied metadevice or component.

     -r    Recursively  deletes  specified  metadevices  and  hot
           spare  pools, but does not delete metadevices on which
           others depend.

     -s setname
           Specifies the name of the diskset on  which  metaclear
           will  work.  Using the -s option causes the command to
           perform  its  administrative   function   within   the
           specified  diskset.  Without  this option, the command
           performs its function on local metadevices and/or  hot
           spare pools.

OPERANDS

     metadevice ...
           Specifies the  name(s)  of  the  metadevice(s)  to  be
           deleted.

     component
           Specifies the c*d*t*s* name(s) of the components  con-
           taining soft partitions to be deleted.

     hot_spare_pool ...
           Specifies the name(s) of the hot  spare  pools  to  be
           deleted  in  the form hspnnn, where nnn is a number in
           the range 000-999.

EXAMPLES

     Example 1: Deleting Various Devices

     The following example deletes a metadevice named d10.

     # metaclear /dev/md/dsk/d10

     The following example deletes all local metadevices and  hot
     spare pools on the system.

     # metaclear -a

     The following example deletes a mirror, d20, with an submir-
     ror in an error state.

     # metaclear -f d20

     The following example deletes a hot spare pool, hsp001.

     # metaclear hsp001

     The following example deletes a soft partition, d23.

     # metaclear d23

     The following example purges  all  soft  partitions  on  the
     slice  c2t3d5s2  if  those  partitions are not being used by
     other metadevices or are not open.

     # metaclear -p c2t3d5s2

     The following example purges soft partitions from a metadev-
     ice.

     # metaclear -p d2
     d3: Soft Partition is cleared
     d4: Soft Partition is cleared
     d5: Soft Partition is cleared

EXIT STATUS

     The following exit values are returned:

          0     Successful completion.

          >0    An error occurred.

ATTRIBUTES

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWmdu                     |
    |_____________________________|_____________________________|

SEE ALSO

     metadb(1M),   metadetach(1M),   metahs(1M),    metainit(1M),
     metaoffline(1M),        metaonline(1M),       metaparam(1M),
     metarecover(1M), metareplace(1M), metaroot(1M), metaset(1M),
     metastat(1M),    metasync(1M),   metattach(1M),   md.tab(4),
     md.cf(4), mddb.cf(4), attributes(5)

     Solaris Volume Manager Administration Guide