[src/netbsd-3]: src/share/man/man4 Pull up revision 1.1 (requested by briggs ...

[tron <tron%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/a016fc428ac7
branches:  netbsd-3
changeset: 576460:a016fc428ac7
user:      tron <tron%NetBSD.org@localhost>
date:      Sun Jul 03 11:33:50 2005 +0000

description:
Pull up revision 1.1 (requested by briggs in ticket #520):
Add an initial man page for ataraid(4).

diffstat:

 share/man/man4/ataraid.4 |  83 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 83 insertions(+), 0 deletions(-)

diffs (87 lines):

diff -r 32bf61d630be -r a016fc428ac7 share/man/man4/ataraid.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/ataraid.4  Sun Jul 03 11:33:50 2005 +0000
@@ -0,0 +1,83 @@
+.\"    $NetBSD: ataraid.4,v 1.3.2.2 2005/07/03 11:33:50 tron Exp $
+.\"
+.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Allen K. Briggs.
+.\"
+.\" 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.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. 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 FOUNDATION 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.
+.\"
+.Dd June 19, 2005
+.Dt ATARAID 4
+.Os
+.Sh NAME
+.Nm ataraid
+.Nd software BIOS RAID
+.Sh SYNOPSIS
+.Cd "pseudo-device ataraid"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for BIOS-based software RAID controllers.
+These are devices which have some simple support for several basic
+RAID levels (often RAID 0 and RAID 1), but which require software
+support to actually perform the RAID function.  The BIOS support
+is largely just to create and recognize the array so that it may
+be a boot device.
+.Pp
+The driver currently supports RAID formats from:
+.Bl -bullet -offset indent -compact
+.It
+Promise Fasttrak
+.It
+Adaptec HostRAID (found in Intel 6300ESB)
+.El
+.Sh SEE ALSO
+.Xr ld 4
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Nx 2.0 .
+.Sh AUTHORS
+The
+.Nm
+driver was originally adapted from FreeBSD by
+.An Jason Thorpe
+.Aq thorpej%NetBSD.org@localhost .
+.Sh BUGS
+Not all features of the software RAID are currently recognized or supported.
+For example, the Adaptec support doesn't recognize when a RAID 1 should be
+in a
+.Dq building
+state, and it does not do the right thing.
+.Pp
+At least part of the reason for this is that the publically-available
+information on these formats is quite limited.