metaclear

 

---

 
 
 
 Maintenance Commands                                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  ]   metadev-
      ice...  hot_spare_pool...
 
      /usr/sbin/metaclear [ -s setname ]  -p  component
 
      /usr/sbin/metaclear [ -s setname ]  -p  metadevice
 
 
      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.
 
 
      Root privileges  are  required  for  all  of  the  following
      options except -h.
 
      -a    Deletes  all  metadevices  and  configured  hot  spare
            pools.
 
      -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.
 
 
      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.
 
 
      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 they are not used by other metadevices
      or open.
 
      # metaclear -p c2t3d5s2
 
 
      The following exit values are returned:
 
           0     Successful completion.
 
           >0    An error occurred.
 
 
 
      See attributes(5) for descriptions of the  following  attri-
      butes:
 
      ____________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | Availability                | SUNWmdu                     |
     |_____________________________|_____________________________|
 
 
 
      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)
 
      Solstice DiskSuite 4.2.1 Reference Manual
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8           Last change: 11 May 2001                    3
 
 
 

---