metaclear(1M) System Administration Commands metaclear(1M)NAMEmetaclear - 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 com‐
ponent. 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
subcomponent in an error state.
-h Displays usage message.
-p Deletes (purges) all soft partitions from the
specified metadevice or component.
-r Recursively deletes specified metadevices and
hot spare pools, but does not delete metade‐
vices 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 func‐
tion 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 compo‐
nents containing 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 submirror 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 metadevice.
# 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 attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWmdu │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOmdmonitord(1M), metadb(1M), metadetach(1M), metahs(1M), metainit(1M),
metaoffline(1M), metaonline(1M), metaparam(1M), metarecover(1M),
metarename(1M), metareplace(1M), metaroot(1M), metaset(1M), metas‐
sist(1M), metastat(1M), metasync(1M), metattach(1M), md.tab(4),
md.cf(4), mddb.cf(4), md.tab(4), attributes(5), md(7D)
Solaris Volume Manager Administration Guide
SunOS 5.10 8 Aug 2003 metaclear(1M)