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 information 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 supported.
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[.blm Pp 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
OpenBSD3.8,
it was rewritten for
NetBSD5.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>
.