metaclear (1M)

NAME

metaclear - delete active metadevices and hot spare pools

SYNOPSIS

metaclear -h
metaclear [ -s setname ] -a [ -f ]
metaclear [ -s setname ] [ -f ] metadevice... hot_spare_pool...
metaclear [ -s setname ] -r [ -f ] metadevice... hot_spare_pool...

AVAILABILITY

/usr/opt/SUNWmd/sbin

DESCRIPTION

metaclear deletes all configured metadevice(s) and hot spare pool(s), or the specified metadevice and/or hot_spare_pool. Once a metadevice or hot spare pool is deleted, it must be recreated 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.

-f: Deletes a metadevice that contains a subcomponent in an errored state.

-h: Displays usage message.

-r: Recursively deletes specified metadevices and hot spare pools.

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

metadevice ...: Specifies the name(s) of the metadevice(s) 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

This example deletes a metadevice named d10.

# metaclear /dev/md/dsk/d10

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

# metaclear -a

This example deletes a mirror, d20, with an errored submirror.

# metaclear -f d20

This example deletes a hot spare pool, hsp001.