lsraid



LSRAID(8)                     Linus md Utilities                     LSRAID(8)




NAME

       lsraid - List and query Linux md devices.


SYNOPSIS

           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



DESCRIPTION

       lsraid is a program for querying Linux md devices.  It can describe the
       composite device and the block devices that belong to it.  It can also
       provide a description of the md device suitable for including in the
       /etc/raidtab configuration file.

       lsraid also has the ability to operate on online and offline devices.
       It can read an online device via the kernel interface and provide
       information about it.  When a device is offline, lsraid can look at any
       of the block devices that are a part of the md device and read the per-
       sistent md superblock for information.


OPTIONS

       -A  Selects array-based operation.  lsraid will query the given devices
           and output a short listing of the referenced md devices.

       -a <device>
           Adds md device <device> to the list of devices to query.  If the
           device is online, lsraid will discover all of the block devices
           that belong to it via the kernel interface.  Otherwise lsraid will
           only be able to verify that the device exists.

       -D  Selects disk-based operation.  lsraid will query the given devices
           and then output a description of all the member disks requested.

       -d <device>
           Adds block device <device> to the list of devices to query.  lsraid
           will read the md superblock off of <device> and use it to discover
           the assocated md device and block devices.

       -f  Displays only failed block devices in array-based mode (-A).

       -g  Displays only good block devices in array-based mode (-A).

       -h, --help
           Displays a short usage message, then exits.

       -l  Displays a long dump of block device superblocks in disk-based mode
           (-D).  This output is verbatim from the on-disk md superblock, and
           reflects the state on the specific disk, not the state the md
           device currently considers authorative.

       -p  Scans all block devices in /proc/partitions for RAID arrays.  This
           can be slow in the presence of network block devices and the like.
           This option is mutually exclusive with the -a and -d options.

       -R  Selects raidtab operation.  lsraid will query all the devices spec-
           ified and output a description of the referenced md devices in a
           format suitable for placing in a raidtab(5) file.

       -s  Displays only spare block devices in array-based mode (-A).


NOTES

       lsraid cannot discover the block devices that make up an offline md
       device.  Providing one of the member devices with the -d option allows
       lsraid to discover the rest of the information about the offline md
       device.

       Disk-based operation only displays the block devices specified on the
       command line.  Specify the md device on the command line to see infor-
       mation about all of the member disks.  If the md device is offline,
       specify both the md device and one of the member disks.

       lsraid does not do any special handling of md devices composed of other
       md devices (eg RAID 1+0).  The member devices are merely treated as
       block devices while in the context of the parent device.  This is only
       an issue for raidtab-based operation.  The raidtab(5) output will be
       printed in the order the md devices are queried.  This means that a
       command creating a raidtab(5) for a RAID 1+0 device should list the
       member devices first on the command line.


EXAMPLES

       lsraid -A -a /dev/md0
           Display a short listing of the md0 device.

       lsraid -A -d /dev/sda1
           Display a short listing of the array that sda1 belongs to.

       lsraid -A -f -a /dev/md0
           Display the failed devices belonging to the md0 device.

       lsraid -D -l -a /dev/md0
           Display a long dump of the on-disk md superblock of every disk in
           md0.

       lsraid -D -a /dev/md0 -d /dev/sda1
           Display a short discription of the disks in md0 as well as a short
           description of the disk sda1.  sda1 will only be described once if
           it belongs to md0.

       lsraid -R -a /dev/md0 -a /dev/md1 -a /dev/md2
           Display a description of the arrays in an output format suitable
           for using in raidtab(5) files.  Note that if md0 and md1 are raid0
           arrays and md2 is a raid1 created from md0 and md1, this command
           will output the information in the correct order.

       lsraid -R -p
           Scan all block devices in /proc/partitions and display all discov-
           ered md devices in a format suitable for using in raidtab(5) files.


BUGS

       Probably.


SEE ALSO

       mkraid(8), raidtab(5), raidstart(8), raidstop(8)


VERSION

       lsraid version 0.7.0 (26 March 2002)


HISTORY

       Version 0.7.0
           Added scanning of active block device partitions.

       Version 0.4.0
           Initial documented version.  Functionally complete.


AUTHOR

       Joel Becker    <joel.becker@oracle.com>


COPYRIGHT

       Copyright  Oracle Corporation, Joel Becker.  All rights reserved.

       This program is free software; see the file COPYING in the source dis-
       tribution for the terms under which it can be redistributed and/or mod-
       ified.



3rd Berkeley Distribution         2002-03-26                         LSRAID(8)

Man(1) output converted with man2html