.\" Automatically generated by Pod::Man v1.3, Pod::Parser v1.13.\".\" Standard preamble:.\" ========================================================================.de Sh \" Subsection heading.br.if t .Sp.ne 5.PP\fB\\$1\fR.PP...de Sp \" Vertical space (when we can't use .PP).if t .sp .5v.if n .sp...de Vb \" Begin verbatim text.ft CW.nf.ne \\$1...de Ve \" End verbatim text.ft R.fi...\" Set up some character translations and predefined strings.  \*(-- will.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left.\" double quote, and \*(R" will give a right double quote.  | will give a.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'.\" expand to `' in nroff, nothing in troff, for use with C<>..tr \(*W-|\(bv\*(Tr.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'.ie n \{\.    ds -- \(*W-.    ds PI pi.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch.    ds L" "".    ds R" "".    ds C` "".    ds C' ""'br\}.el\{\.    ds -- \|\(em\|.    ds PI \(*p.    ds L" ``.    ds R" '''br\}.\".\" If the F register is turned on, we'll generate index entries on stderr for.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index.\" entries marked with X<> in POD.  Of course, you'll have to process the.\" output yourself in some meaningful fashion..if \nF \{\.    de IX.    tm Index:\\$1\t\\n%\t"\\$2"...    nr % 0.    rr F.\}.\".\" For nroff, turn off justification.  Always turn off hyphenation; it makes.\" way too many mistakes in technical documents..hy 0.if n .na.\".\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2)..\" Fear.  Run.  Save yourself.  No user-serviceable parts..    \" fudge factors for nroff and troff.if n \{\.    ds #H 0.    ds #V .8m.    ds #F .3m.    ds #[ \f1.    ds #] \fP.\}.if t \{\.    ds #H ((1u-(\\\\n(.fu%2u))*.13m).    ds #V .6m.    ds #F 0.    ds #[ \&.    ds #] \&.\}.    \" simple accents for nroff and troff.if n \{\.    ds ' \&.    ds ` \&.    ds ^ \&.    ds , \&.    ds ~ ~.    ds /.\}.if t \{\.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u".    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'.\}.    \" troff and (daisy-wheel) nroff accents.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'.ds 8 \h'\*(#H'\(*b\h'-\*(#H'.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#].ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#].ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#].ds ae a\h'-(\w'a'u*4/10)'e.ds Ae A\h'-(\w'A'u*4/10)'E.    \" corrections for vroff.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'.    \" for low resolution devices (crt and lpr).if \n(.H>23 .if \n(.V>19 \\{\.    ds : e.    ds 8 ss.    ds o a.    ds d- d\h'-1'\(ga.    ds D- D\h'-1'\(hy.    ds th \o'bp'.    ds Th \o'LP'.    ds ae ae.    ds Ae AE.\}.rm #[ #] #H #V #F C.\" ========================================================================.\".IX Title "LSRAID 8".TH LSRAID 8 "2002-03-26" "0.7.0" "Linus md Utilities".UC.SH "NAME"lsraid \- List and query Linux md devices..SH "SYNOPSIS".IX Header "SYNOPSIS".Vb 8\&    lsraid -A [-g|-s|-f] {-a <device> | -d <device>} ...\&    lsraid -A -p\&    lsraid -D [-l] {-a <device> | -d <device>} ...\&    lsraid -D -p\&    lsraid -R {-a <device> | -d <device>} ...\&    lsraid -R -p\&    lsraid -h\&    lsraid -V.Ve.SH "DESCRIPTION".IX Header "DESCRIPTION"\&\fBlsraid\fR is a program for querying Linux md devices.  It can describethe composite device and the block devices that belong to it.  It canalso provide a description of the md device suitable for including inthe /etc/raidtab configuration file..PP\&\fBlsraid\fR also has the ability to operate on online and offline devices.It can read an online device via the kernel interface and provideinformation about it.  When a device is offline, \fBlsraid\fR can look atany of the block devices that are a part of the md device and read thepersistent md superblock for information..SH "OPTIONS".IX Header "OPTIONS".IP "\fB\-A\fR" 4.IX Item "-A"Selects array-based operation.  \fBlsraid\fR will query the given devicesand output a short listing of the referenced md devices..IP "\fB\-a <device>\fR" 4.IX Item "-a <device>"Adds md device <device> to the list of devices to query.  If thedevice is online, \fBlsraid\fR will discover all of the block devices thatbelong to it via the kernel interface.  Otherwise \fBlsraid\fR will onlybe able to verify that the device exists..IP "\fB\-D\fR" 4.IX Item "-D"Selects disk-based operation.  \fBlsraid\fR will query the given devicesand then output a description of all the member disks requested..IP "\fB\-d <device>\fR" 4.IX Item "-d <device>"Adds block device <device> to the list of devices to query.\&\fBlsraid\fR will read the md superblock off of <device> and useit to discover the assocated md device and block devices..IP "\fB\-f\fR" 4.IX Item "-f"Displays only failed block devices in array-based mode (\fB\-A\fR)..IP "\fB\-g\fR" 4.IX Item "-g"Displays only good block devices in array-based mode (\fB\-A\fR)..IP "\fB\-h, \-\-help\fR" 4.IX Item "-h, --help"Displays a short usage message, then exits..IP "\fB\-l\fR" 4.IX Item "-l"Displays a long dump of block device superblocks in disk-based mode(\fB\-D\fR).  This output is verbatim from the on-disk md superblock, andreflects the state on the specific disk, not the state the md devicecurrently considers authorative..IP "\fB\-p\fR" 4.IX Item "-p"Scans all block devices in /proc/partitions for \s-1RAID\s0 arrays.  This canbe slow in the presence of network block devices and the like.  Thisoption is mutually exclusive with the \fB\-a\fR and \fB\-d\fR options..IP "\fB\-R\fR" 4.IX Item "-R"Selects raidtab operation.  \fBlsraid\fR will query all the devicesspecified and output a description of the referenced md devices ina format suitable for placing in a \fIraidtab\fR\|(5) file..IP "\fB\-s\fR" 4.IX Item "-s"Displays only spare block devices in array-based mode (\fB\-A\fR)..SH "NOTES".IX Header "NOTES"\&\fBlsraid\fR cannot discover the block devices that make up an offlinemd device.  Providing one of the member devices with the \fB\-d\fR optionallows \fBlsraid\fR to discover the rest of the information about theoffline md device.  .PPDisk-based operation only displays the block devices specified on thecommand line.  Specify the md device on the command line to seeinformation about all of the member disks.  If the md device is offline,specify both the md device and one of the member disks..PP\&\fBlsraid\fR does not do any special handling of md devices composed ofother md devices (eg \s-1RAID\s0 1+0).  The member devices are merely treatedas block devices while in the context of the parent device.  This isonly an issue for raidtab-based operation.  The \fIraidtab\fR\|(5) outputwill be printed in the order the md devices are queried.  This meansthat a command creating a \fIraidtab\fR\|(5) for a \s-1RAID\s0 1+0 device shouldlist the member devices first on the command line..SH "EXAMPLES".IX Header "EXAMPLES".IP "lsraid \-A \-a /dev/md0" 4.IX Item "lsraid -A -a /dev/md0"Display a short listing of the md0 device..IP "lsraid \-A \-d /dev/sda1" 4.IX Item "lsraid -A -d /dev/sda1"Display a short listing of the array that sda1 belongs to..IP "lsraid \-A \-f \-a /dev/md0" 4.IX Item "lsraid -A -f -a /dev/md0"Display the failed devices belonging to the md0 device..IP "lsraid \-D \-l \-a /dev/md0" 4.IX Item "lsraid -D -l -a /dev/md0"Display a long dump of the on-disk md superblock of every disk in md0..IP "lsraid \-D \-a /dev/md0 \-d /dev/sda1" 4.IX Item "lsraid -D -a /dev/md0 -d /dev/sda1"Display a short discription of the disks in md0 as well as a shortdescription of the disk sda1.  sda1 will only be described once if itbelongs to md0..IP "lsraid \-R \-a /dev/md0 \-a /dev/md1 \-a /dev/md2" 4.IX Item "lsraid -R -a /dev/md0 -a /dev/md1 -a /dev/md2"Display a description of the arrays in an output format suitable forusing in \fIraidtab\fR\|(5) files.  Note that if md0 and md1 are raid0 arraysand md2 is a raid1 created from md0 and md1, this command will outputthe information in the correct order..IP "lsraid \-R \-p" 4.IX Item "lsraid -R -p"Scan all block devices in /proc/partitions and display all discoveredmd devices in a format suitable for using in \fIraidtab\fR\|(5) files..SH "BUGS".IX Header "BUGS"Probably..SH "SEE ALSO".IX Header "SEE ALSO"\&\fImkraid\fR\|(8), \fIraidtab\fR\|(5), \fIraidstart\fR\|(8), \fIraidstop\fR\|(8).SH "VERSION".IX Header "VERSION"lsraid version 0.7.0 (26 March 2002).SH "HISTORY".IX Header "HISTORY".IP "Version 0.7.0" 4.IX Item "Version 0.7.0"Added scanning of active block device partitions..IP "Version 0.4.0" 4.IX Item "Version 0.4.0"Initial documented version.  Functionally complete..SH "AUTHOR".IX Header "AUTHOR"Joel Becker	<joel.becker\&@oracle.com>.SH "COPYRIGHT".IX Header "COPYRIGHT"Copyright