xref: /netbsd-src/share/man/man4/ataraid.4 (revision 81a7022f8eb3d6bd14f1746da01d88067b8fbc50)
1.\"	$NetBSD: ataraid.4,v 1.15 2013/08/06 17:33:29 snj Exp $
2.\"
3.\" Copyright (c) 2005 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Allen K. Briggs.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE.
29.\"
30.Dd September 16, 2008
31.Dt ATARAID 4
32.Os
33.Sh NAME
34.Nm ataraid
35.Nd software BIOS RAID
36.Sh SYNOPSIS
37.Cd "pseudo-device ataraid"
38.Cd "ld* at ataraid? vendtype ? unit ?"
39.Sh DESCRIPTION
40The
41.Nm
42driver provides support for BIOS-based software RAID controllers.
43These are devices which have some simple support for several basic
44RAID levels (often RAID 0 and RAID 1), but which require software
45support to actually perform the RAID function.
46The BIOS support is largely just to create and recognize the array
47so that it may be a boot device.
48.Pp
49The driver currently supports RAID formats from:
50.Bl -bullet -offset indent -compact
51.It
52Adaptec HostRAID (found in Intel 6300ESB)
53.It
54Intel MatrixRAID
55.It
56JMicron RAID
57.It
58nVidia MediaShield
59.It
60Promise FastTrak
61.It
62Via V-RAID (found in many VIA-based motherboards)
63.El
64.Pp
65Status of the logical disk, as well as the disks associated with it,
66can be viewed through the
67.Xr bioctl 8
68utility.
69.Sh SEE ALSO
70.Xr ld 4 ,
71.Xr bioctl 8
72.Sh HISTORY
73The
74.Nm
75driver first appeared in
76.Nx 2.0 .
77.Sh AUTHORS
78The
79.Nm
80driver was originally adapted from
81.Fx
82by
83.An Jason Thorpe
84.Aq thorpej@NetBSD.org .
85.Sh BUGS
86Not all features of the software RAID are currently recognized or
87supported.
88For example, the Adaptec support doesn't recognize when a RAID 1
89should be in a
90.Dq building
91state, and it does not do the right thing.
92.Pp
93At least part of the reason for this is that the publicly-available
94information on these formats is quite limited.
95