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
     RAID controller's properties.

COMMANDS
     The following commands are supported:

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

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

     blink start | 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 | remove channel:target.lun
                         Create or remove a hot-spare drive at location
                         channel:target.lun.

     passthru add DISKID | 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
                         channel:target.lun location.  NOTE: removing a pass-
                         through device that has a mounted filesystem will
                         lead to undefined behaviour.

     check start | stop VOLID
                         Start or stop consistency volume check in the volume
                         with index VOLID.  NOTE: not many RAID controllers
                         will 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 (dependent of the RAID_LEVEL
                         too). 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 show arcmsr0
     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>

SEE ALSO
     arcmsr(4), bio(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 4.0                     January 11, 2008                     NetBSD 4.0