DESCRIPTION dmraid discovers block and software RAID
devices (eg, ATARAID) by using multiple different metadata
format handlers which support various for- mats (eg,
Highpoint 37x series). It offers activating RAID sets made
up by 2 or more discovered RAID devices, display properties
of devices and sets (see option -l for supported metadata
formats). Block device access to activated RAID sets occurs
via device-mapper nodes /dev/map- per/RaidSetName.
RaidSetName starts with the format name (see -l option)
which can be used to access all RAID sets of a specific
format easily with certain options (eg, -a below).

OPTIONS -a, --activate {y|n} [RAID set...] Activates or
deactivates all or particular software RAID set. In case
metadata format handlers are chosen with -f , only RAID sets
with such format(s) can be activated or deactivated. Use-
ful if devices have multiple metadata signatures. When
activat- ing RAID sets, -p disables the activation of
partitions on them, and -Z will make dmraid tell the kernel
to remove the partitions from the disks underlying the set,
ie if sda is part of the set, remove sda1, sda2, etc. This
prevents applications from directly accessiong the disks
bypassing dmraid. RAID set names given on command line dont
need to be fully specified (eg, "dmraid -ay sil"
would activate all discovered Silicon Image Medley RAID
sets).

{-b|--block_devices} [device-path...] List all or
particular discovered block devices with their prop- erties
(size, serial number). Add -c to display block device names
only and -cc for CSV column output of block device proper-
ties. See description of -c below for FIELD identifiers.

[-d|--debug]... Enable debugging output. Opion can be
given multiple times increasing the debug output level.

[-f|--format FORMAT[,FORMAT...]] Use metadata format
handler(s) to discover RAID devices. See -l for a list of
supported format handler names. This is useful to select
particular formats in case multiple metadata signatures are
found on a device. A comma seperated list of format names
can be specified which may not contain white space.

{-h|--help} Display help text.

{-i|--ignorelocking} Dont take out any locks. Useful in
early boot where no read/write access to /var is
available.

{-l|--list_formats} List all available metadata format
handlers with their names and descriptions. Supported RAID
levels are listed in parenthesis:

{-n|--native_log} [device-path...] Display metadata in
native, vendor-specific format. In case a metadata format
handler is chosen with -f only RAID devices with such format
will be displayed in native format. If device- path(s)
is/are given on the command line, native metadata output is
restricted to those listed.

[{-P|--partchar} CHAR] Use CHAR as the separator between
the device name and the parti- tion number.

{-R| --rebuild} RAID-set [device-path] Rebuild raid
array after a drive has failed and a new drive is added. For
Intel chipset based systems, there are two methods in which
a new drive is added to the system.

1. Using OROM to identify a new drive During system
reboot, enter OROM and mark the new drive as the rebuild
drive. After booting to the OS, use the dmraid command to
rebuild.

Example: dmraid -R raid_set

2. Using dmraid to identify a new drive Boot to the OS
and use the dmraid command with the new drive as the second
parameter.

Example: dmraid -R raid_set /dev/sdc

3. Using hot spare drive Mark a drive as hot spare using
the "dmraid -f isw -S" com- mand. Then use the
dmraid command to start the rebuild.

Example: dmraid -R raid_set

{-x|--remove} [RAID-set] Delete one or all existing
software RAID devices from the meta- data.

-f FORMAT-handler {-C|--create} --type raidlevel
[--size=setsize --strip stripsize] --disk device-path,
device-path [,device-path] Delete one or all existing
Configure a software RAID device and store the configuration
data in a group of hard drive devices consisting of this
array. This command requires the following options:

-f FORMAT-handler metadata format (see "dmraid
-l") --type digit[digit...] specify the raid level of
the software RAID set. 0: raid0 1: raid1 5: raid5 01: raid01
(isw raid10) --size: [digits[k|K|m|M|g|G][b|B]] specify the
size of the RAID set.The number is an integer followed by
[kKmMgG] and/or [bB]. b: byte (default) B: block (512 bytes)
K or K: on the base of 1024 m or M: on the base of 1024*1024
g or G: on the base of 1024*1024*1024 If this option is
missing, it s set to the default value pre- configured by
the vendor. Note that different vendors may apply different
constraints on the granularity of the size or the min- imal
value. --strip: [digits[k|K|m|M|g|G][b|B]] specify the strip
size of a RAID1, RAID5, and RAID10 RAID set (as above)
--disk: device-path[{,| }device-path...] specify the array
of the hard drives, e.g. /dev/sda.

-f FORMAT-handler -S -M device-path -S -M
device-path

This command adds hot spare support for one or more RAID
sets.

1. When used with a format handler, which supports hot
spare sets (e.g. isw), a hot spare is marked to be used when
rebuild- ing any RAID set of that format. 2. When used when
specifying a RAID set, the drive is added to that RAID set
and will be used only to rebuild that set. Note: If the
specified name does not match an existing RAID-set, a set
with the new name will be cre- ated.

{-r|--raid_devices} [device-path...] List all discovered
RAID devices with format, RAID level, sec- tors used and
data offset into the device. In case a metadata format
handler is chosen with -f , only RAID devices with such
format can be discovered. Useful if devices have multiple
meta- data signatures. If -D is added to -r the RAID
metadata gets dumped into a subdirectory named
dmraid.format_name (eg. for- mat_name = isw) in files named
devicename.dat. The byte offset where the metadata is
located on the device is written into files named
devicename.offset and the size of the device in sec- tors
into files named devicename.size.

If -E is added to -r the RAID metadata on the devices
gets con- ditionally erased. Useful to erase old metadata
after new one of different type has been stored on a device
in order to avoid discovering both. If you enter -E option
-D will be enforced in order to have a fallback in case the
wrong metadata got erased. Manual copying back onto the
device is needed to recover from erasing the wrong metadata
using the dumped files device- name_formatname.dat and
devicename_formatname.offset. Eg, to restore all *.dat files
in the working directory to the respec- tive devices:

If device-path(s) is/are given on the command line, the
above actions are restricted to those listed. Add -c to
display RAID device names only and -cc for CSV column output
of RAID device properties. See description of -c above for
FIELD identifiers.

--separator SEPARATOR Use SEPARATOR as a delimiter for
all options taking or display- ing lists.

-s... [a|i] [RAID-set...] Display properties of RAID
sets. Multiple RAID set names can be given on the command
line which dont need to be fully specified (eg, "dmraid
-s hpt" would display all discovered Highpoint RAID
sets). Enter -s twice to display RAID subsets too. Add -c to
display names of RAID sets only, -cc for CSV column output
of RAID set properties and -ccc for inclusion of block
devices in the listing. Doesn t imply -s -s to show RAID
subsets (implied for group sets, e.g. isw). Add -g to
include information about group RAID sets (as with Intel
Software RAID) in the listing. See description of -c above
for FIELD identifiers. Note: Size is given in sectors (not
bytes).

[-v|--verbose]... Enable verbose runtime information
output. Opion can be given multiple times increasing the
verbosity level.