bioctl(8) - NetBSD Manual Pages

BIOCTL(8)               NetBSD System Manager's Manual               BIOCTL(8)


NAME

     bioctl -- RAID management interface


SYNOPSIS

     bioctl device command [arg [...]]


DESCRIPTION

     RAID device drivers which support management functionality can register
     their services with the bio(4) driver.  bioctl then can be used to manage
     the RAID controller's properties.


COMMANDS

     The following commands are supported:

     show [disks | volumes]
                         Without any argument by default bioctl will show
                         information about all volumes and the logical disks
                         used on them.  If disks is specified, only informa-
                         tion about physical disks will be shown.  If volumes
                         is specified, only information about the volumes will
                         be shown.

     alarm [disable | enable | silence | test]
                         Control the RAID card's alarm functionality, if sup-
                         ported.  By default if no argument is specified, its
                         current state will be shown.  Optionally the disable,
                         enable, silence, or test arguments may be specified
                         to enable, disable, silence, or test the RAID card's
                         alarm.

     blink start channel:target.lun | stop channel:target.lun
                         Instruct the device at channel:target.lun to start or
                         cease blinking, if there's ses(4) support in the
                         enclosure.

     hotspare add channel:target.lun | remove channel:target.lun
                         Create or remove a hot-spare drive at location
                         channel:target.lun.

     passthru add DISKID channel:target.lun | remove channel:target.lun
                         Create or remove a pass-through device.  The DISKID
                         argument specifies the disk that will be used for the
                         new device, and it will be created at the location
                         channel:target.lun.  NOTE: Removing a pass-through
                         device that has a mounted filesystem will lead to
                         undefined behaviour.

     check start VOLID | stop VOLID
                         Start or stop consistency volume check in the volume
                         with index VOLID.  NOTE: Not many RAID controllers
                         support this feature.

     create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun
                         Create a volume at index VOLID.  The DISKIDs argument
                         will specify the first and last disk, i.e.: 0-3 will
                         use the disks 0, 1, 2, and 3.  The SIZE argument is
                         optional and may be specified if not all available
                         disk space is wanted (also dependent of the
                         RAID_LEVEL).  The volume will have a stripe size
                         defined in the STRIPE argument and it will be located
                         at channel:target.lun.

     remove volume VOLID channel:target.lun
                         Remove a volume at index VOLID and located at
                         channel:target.lun.  NOTE: Removing a RAID volume
                         that has a mounted filesystem will lead to undefined
                         behaviour.


EXAMPLES

     The following command, executed from the command line, shows the status
     of the volumes and its logical disks on the RAID controller:

     $ bioctl arcmsr0 show
     Volume Status       Size         Device/Label   RAID Level Stripe
     =================================================================
          0 Building     468G  sd0 ARC-1210-VOL#00       RAID 6  128KB  0% done
        0:0 Online       234G         0:0.0 noencl <WDC WD2500YS-01SHB1 20.06C06>
        0:1 Online       234G         0:1.0 noencl <WDC WD2500YS-01SHB1 20.06C06>
        0:2 Online       234G         0:2.0 noencl <WDC WD2500YS-01SHB1 20.06C06>
        0:3 Online       234G         0:3.0 noencl <WDC WD2500YS-01SHB1 20.06C06>

     To create a RAID 5 volume on the SCSI 0:15.0 location on the disks 0, 1,
     2, and 3, with stripe size of 64Kb on the first volume ID, using all
     available free space on the disks:

           $ bioctl arcmsr0 create volume 0 0-3 64 5 0:15.0

     To remove the volume 0 previously created at the SCSI 0:15.0 location:

           $ bioctl arcmsr0 remove volume 0 0:15.0


SEE ALSO

     arcmsr(4), bio(4), cac(4), ciss(4), mfi(4)


HISTORY

     The bioctl command first appeared in OpenBSD 3.8, it was rewritten for
     NetBSD 5.0.


AUTHORS

     The bioctl interface was written by Marco Peereboom <marco@openbsd.org>
     and was rewritten with multiple features by
     Juan Romero Pardines <xtraeme@NetBSD.org>.

NetBSD 7.1.2                    March 16, 2008                    NetBSD 7.1.2