1.\" $NetBSD: bioctl.8,v 1.25 2019/05/08 06:10:30 wiz Exp $ 2.\" $OpenBSD: bioctl.8,v 1.43 2007/03/20 06:12:11 jmc Exp $ 3.\" 4.\" Copyright (c) 2007, 2008 Juan Romero Pardines 5.\" Copyright (c) 2004, 2005 Marco Peereboom 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND 17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR 20.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.Dd May 7, 2019 29.Dt BIOCTL 8 30.Os 31.Sh NAME 32.Nm bioctl 33.Nd RAID management interface 34.Sh SYNOPSIS 35.Nm bioctl 36.Ar device 37.Ar command 38.Op Ar arg Op ... 39.Sh DESCRIPTION 40RAID device drivers which support management functionality can 41register their services with the 42.Xr bio 4 43driver. 44.Nm bioctl 45then can be used to manage the RAID controller's properties. 46.Sh COMMANDS 47The following commands are supported: 48.Bl -tag -width XXstrategyXXnameXX 49.It Ic show Op Ar disks | volumes 50Without any argument by default 51.Nm 52will show information about all volumes and the logical disks used 53on them. 54If 55.Ar disks 56is specified, only information about physical disks will be shown. 57If 58.Ar volumes 59is specified, only information about the volumes will be shown. 60.It Ic alarm Op Ar disable | enable | silence | test 61Control the RAID card's alarm functionality, if supported. 62By default if no argument is specified, its current state will be 63shown. 64Optionally the 65.Ar disable , 66.Ar enable , 67.Ar silence , 68or 69.Ar test 70arguments may be specified to enable, disable, silence, or test 71the RAID card's alarm. 72.It Ic blink Ar start channel:target.lun | stop channel:target.lun 73Instruct the device at 74.Ar channel:target.lun 75to start or cease blinking, if there's 76.Xr ses 4 77support in the enclosure. 78.It Ic hotspare Ar add channel:target.lun | remove channel:target.lun 79Create or remove a hot-spare drive at location 80.Ar channel:target.lun . 81.It Ic passthru Ar add DISKID channel:target.lun | remove Ar channel:target.lun 82Create or remove a 83.Ar pass-through 84device. 85The 86.Ar DISKID 87argument specifies the disk that will be used for the new device, and 88it will be created at the location 89.Ar channel:target.lun . 90.Em NOTE : 91Removing a pass-through device that has a mounted filesystem will 92lead to undefined behaviour. 93.It Ic check Ar start VOLID | stop VOLID 94Start or stop consistency volume check in the volume with index 95.Ar VOLID . 96.Em NOTE : 97Not many RAID controllers support this feature. 98.It Ic create volume Ar VOLID DISKIDs Oo Ar SIZE Oc Ar STRIPE RAID_LEVEL channel:target.lun 99Create a volume at index 100.Ar VOLID . 101The 102.Ar DISKIDs 103argument will specify the first and last disk, i.e.: 104.Em 0-3 105will use the disks 0, 1, 2, and 3. 106The 107.Ar SIZE 108argument is optional and may be specified if not all available disk 109space is wanted (also dependent of the 110.Ar RAID_LEVEL ) . 111The volume will have a stripe size defined in the 112.Ar STRIPE 113argument and it will be located at 114.Ar channel:target.lun . 115.It Ic remove volume Ar VOLID channel:target.lun 116Remove a volume at index 117.Ar VOLID 118and located at 119.Ar channel:target.lun . 120.Em NOTE : 121Removing a RAID volume that has a mounted filesystem will lead to 122undefined behaviour. 123.El 124.Sh EXAMPLES 125The following command, executed from the command line, shows the 126status of the volumes and its logical disks on the RAID controller: 127.Bd -literal 128$ bioctl arcmsr0 show 129Volume Status Size Device/Label RAID Level Stripe 130================================================================= 131 0 Building 468G sd0 ARC-1210-VOL#00 RAID 6 128KB 0% done 132 0:0 Online 234G 0:0.0 noencl <WDC WD2500YS-01SHB1 20.06C06> 133 0:1 Online 234G 0:1.0 noencl <WDC WD2500YS-01SHB1 20.06C06> 134 0:2 Online 234G 0:2.0 noencl <WDC WD2500YS-01SHB1 20.06C06> 135 0:3 Online 234G 0:3.0 noencl <WDC WD2500YS-01SHB1 20.06C06> 136.Ed 137.Pp 138To create a RAID 5 volume on the SCSI 0:15.0 location on the disks 1390, 1, 2, and 3, with stripe size of 64Kb on the first volume ID, 140using all available free space on the disks: 141.Pp 142.Dl $ bioctl arcmsr0 create volume 0 0-3 64 5 0:15.0 143.Pp 144To remove the volume 0 previously created at the SCSI 0:15.0 location: 145.Pp 146.Dl $ bioctl arcmsr0 remove volume 0 0:15.0 147.Sh SEE ALSO 148.Xr arcmsr 4 , 149.Xr ataraid 4 , 150.Xr bio 4 , 151.Xr cac 4 , 152.Xr ciss 4 , 153.Xr mfi 4 , 154.Xr mfii 4 , 155.Xr mpii 4 , 156.Xr mpt 4 157.Sh HISTORY 158The 159.Nm 160command appeared in 161.Ox 3.8 , 162it first appeared in 163.Nx 4.0 164and was rewritten for 165.Nx 5.0 . 166.Sh AUTHORS 167The 168.Nm 169interface was written by 170.An Marco Peereboom Aq Mt marco@openbsd.org 171and was rewritten with multiple features by 172.An Juan Romero Pardines Aq Mt xtraeme@NetBSD.org . 173
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.3