Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
NetBSD/sbin/bioctl/bioctl.8

173 lines
5.6 KiB
Groff
Raw Normal View History

Sort SEE ALSO.
2019-05-08 09:10:30 +03:00
.\" $NetBSD: bioctl.8,v 1.25 2019/05/08 06:10:30 wiz Exp $
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
.\" $OpenBSD: bioctl.8,v 1.43 2007/03/20 06:12:11 jmc Exp $
.\"
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.\" Copyright (c) 2007, 2008 Juan Romero Pardines
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
.\" Copyright (c) 2004, 2005 Marco Peereboom
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR
.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
bioctl(8): Xr ataraid(4), mpii(4) && mfii(4);
2019-05-08 06:29:59 +03:00
.Dd May 7, 2019
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
.Dt BIOCTL 8
.Os
.Sh NAME
.Nm bioctl
.Nd RAID management interface
.Sh SYNOPSIS
.Nm bioctl
.Ar device
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.Ar command
.Op Ar arg Op ...
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
.Sh DESCRIPTION
RAID device drivers which support management functionality can
register their services with the
.Xr bio 4
driver.
.Nm bioctl
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
then can be used to manage the RAID controller's properties.
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.Sh COMMANDS
The following commands are supported:
.Bl -tag -width XXstrategyXXnameXX
.It Ic show Op Ar disks | volumes
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
Without any argument by default
.Nm
will show information about all volumes and the logical disks used
on them.
If
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.Ar disks
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
is specified, only information about physical disks will be shown.
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
If
.Ar volumes
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
is specified, only information about the volumes will be shown.
.It Ic alarm Op Ar 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
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.Ar disable ,
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
.Ar enable ,
.Ar silence ,
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
or
.Ar test
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
arguments may be specified to enable, disable, silence, or test
the RAID card's alarm.
Improve usage() and manpage commands/args.
2008-03-03 19:10:48 +03:00
.It Ic blink Ar start channel:target.lun | stop channel:target.lun
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
Instruct the device at
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.Ar channel:target.lun
to start or cease blinking, if there's
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
.Xr ses 4
support in the enclosure.
Improve usage() and manpage commands/args.
2008-03-03 19:10:48 +03:00
.It Ic hotspare Ar add channel:target.lun | remove channel:target.lun
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
Create or remove a hot-spare drive at location
.Ar channel:target.lun .
Improve usage() and manpage commands/args.
2008-03-03 19:10:48 +03:00
.It Ic passthru Ar add DISKID channel:target.lun | remove Ar channel:target.lun
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
Create or remove a
.Ar pass-through
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
device.
The
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.Ar DISKID
argument specifies the disk that will be used for the new device, and
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
it will be created at the location
.Ar channel:target.lun .
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.Em NOTE :
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
Removing a pass-through device that has a mounted filesystem will
lead to undefined behaviour.
Improve usage() and manpage commands/args.
2008-03-03 19:10:48 +03:00
.It Ic check Ar start VOLID | stop VOLID
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
Start or stop consistency volume check in the volume with index
.Ar VOLID .
.Em NOTE :
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
Not many RAID controllers support this feature.
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.It Ic create volume Ar VOLID DISKIDs Oo Ar SIZE Oc Ar STRIPE RAID_LEVEL channel:target.lun
Create a volume at index
.Ar VOLID .
The
.Ar DISKIDs
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
argument will specify the first and last disk, i.e.:
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.Em 0-3
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
will use the disks 0, 1, 2, and 3.
The
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.Ar SIZE
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
argument is optional and may be specified if not all available disk
space is wanted (also dependent of the
.Ar RAID_LEVEL ) .
The volume will have a stripe size defined in the
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.Ar STRIPE
argument and it will be located at
.Ar channel:target.lun .
.It Ic remove volume Ar VOLID channel:target.lun
Remove a volume at index
.Ar VOLID
and located at
.Ar channel:target.lun .
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
.Em NOTE :
Removing a RAID volume that has a mounted filesystem will lead to
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
undefined behaviour.
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
.El
.Sh EXAMPLES
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
The following command, executed from the command line, shows the
status of the volumes and its logical disks on the RAID controller:
Fix Dd argument (use full month names). Use more markup. Comment out references to safte(4) and softraid(4), which don't exist in NetBSD. Remove trailing whitespace. Use macros instead of characters for HTML output (replace ">", "<" with \*[Gt], \*[Lt]). Sort sections.
2007-09-09 20:13:19 +04:00
.Bd -literal
fix example (from anon ymous)
2008-03-03 22:11:45 +03:00
$ bioctl arcmsr0 show
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
Volume Status Size Device/Label RAID Level Stripe
=================================================================
0 Building 468G sd0 ARC-1210-VOL#00 RAID 6 128KB 0% done
Remove workaround for ancient HTML generation code.
2017-07-04 00:28:48 +03:00
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>
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
.Ed
Add two examples to create and remove a RAID volume in a supported controller... such as arcmsr(4) for now.
2008-02-02 06:21:47 +03:00
.Pp
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
To create a RAID 5 volume on the SCSI 0:15.0 location on the disks
Add serial comma.
2011-04-26 02:09:29 +04:00
0, 1, 2, and 3, with stripe size of 64Kb on the first volume ID,
Various improvements (mdoc, wording, punctuation).
2008-03-16 14:07:23 +03:00
using all available free space on the disks:
Add two examples to create and remove a RAID volume in a supported controller... such as arcmsr(4) for now.
2008-02-02 06:21:47 +03:00
.Pp
Improve usage() and manpage commands/args.
2008-03-03 19:10:48 +03:00
.Dl $ bioctl arcmsr0 create volume 0 0-3 64 5 0:15.0
Add two examples to create and remove a RAID volume in a supported controller... such as arcmsr(4) for now.
2008-02-02 06:21:47 +03:00
.Pp
Improve usage() and manpage commands/args.
2008-03-03 19:10:48 +03:00
To remove the volume 0 previously created at the SCSI 0:15.0 location:
Add two examples to create and remove a RAID volume in a supported controller... such as arcmsr(4) for now.
2008-02-02 06:21:47 +03:00
.Pp
Improve usage() and manpage commands/args.
2008-03-03 19:10:48 +03:00
.Dl $ bioctl arcmsr0 remove volume 0 0:15.0
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
.Sh SEE ALSO
Mention arcmsr(4) in SEE ALSO.
2007-12-05 15:29:55 +03:00
.Xr arcmsr 4 ,
Sort SEE ALSO.
2019-05-08 09:10:30 +03:00
.Xr ataraid 4 ,
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
.Xr bio 4 ,
Xref cac(4).
2008-03-16 13:01:32 +03:00
.Xr cac 4 ,
Add ciss(4) to drivers supporting bio(4) and bioctl(8).
2008-05-26 00:09:55 +04:00
.Xr ciss 4 ,
Add comma in enumeration.
2014-09-30 12:20:29 +04:00
.Xr mfi 4 ,
bioctl(8): Xr ataraid(4), mpii(4) && mfii(4);
2019-05-08 06:29:59 +03:00
.Xr mfii 4 ,
.Xr mpii 4 ,
Add mpt reference, as support for this device was added recently
2014-09-30 12:14:48 +04:00
.Xr mpt 4
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
.Sh HISTORY
The
.Nm
Note which version it appeared in before the rewrite. Bump date.
2016-09-11 04:03:15 +03:00
command appeared in
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
.Ox 3.8 ,
Note which version it appeared in before the rewrite. Bump date.
2016-09-11 04:03:15 +03:00
it first appeared in
.Nx 4.0
and was rewritten for
New bioctl(8) first appeared on 5.0 not 4.1.
2008-01-11 20:11:42 +03:00
.Nx 5.0 .
Add bio(4) and associated bioctl(8) from OpenBSD, a driver control block device controllers, and more specifically raid controllers. Add a new sensor type, ENVSYS_DRIVE, to report drive status. From OpenBSD. Add bio and sysmon support to mfi(4). This allow userland to query status for drives and logical volumes attached to a mfi(4) controller. While there fix some debug printfs in mfi so they compile. Add bio(4) to amd64 and i386 GENERIC.
2007-05-01 21:18:52 +04:00
.Sh AUTHORS
The
.Nm
interface was written by
Use Mt for email addresses.
2013-07-21 01:39:55 +04:00
.An Marco Peereboom Aq Mt marco@openbsd.org
Rewrite bioctl(8) and add support for the following features: - Ability to add/remove hot-spare disks (previously only 'add' was accepted). - Ability to add/remove pass-through disks. - Ability to create/remove RAID volumes with optional size, stripe, level, member disks and others. - Ability to start/stop consistency checks in a RAID volume. - Ability to show only information about physical disks, volumes or both. Rather than using multiple flags, the utility has been modified to use the same mode than dkctl(8) (and maybe others), i.e: $ ./bioctl usage: bioctl device command [arg [...]] Available commands: show [disks] | [volumes] alarm [enable] | [disable] | [silence] | [test] blink start | stop [channel:target[.lun]] hotspare add | remove channel:target.lun passthru add DISKID | remove channel:target.lun check start | stop VOLID create volume VOLID DISKIDs [SIZE] STRIPE RAID_LEVEL channel:target.lun remove volume VOLID channel:target.lun $ I'll add support for other features soon.
2008-01-03 02:45:06 +03:00
and was rewritten with multiple features by
Use Mt for email addresses.
2013-07-21 01:39:55 +04:00
.An Juan Romero Pardines Aq Mt xtraeme@NetBSD.org .