Updated: 2022/Sep/29
Please read Privacy Policy. It's for your privacy.
BIOCTL(8) 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
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] 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), ataraid(4), bio(4), cac(4), ciss(4), mfi(4), mfii(4), mpii(4),
mpt(4)
HISTORY
The bioctl command appeared in OpenBSD 3.8, it first appeared in
NetBSD 4.0 and 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 10.99 May 7, 2019 NetBSD 10.99