3ware escalade, twe

3 files changed, 74 insertions, 4 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index f49261da6d0..88492197072 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.125 2000/08/28 13:52:57 jason Exp $
+#	$OpenBSD: Makefile,v 1.126 2000/09/15 18:08:00 mickey Exp $
 
 MAN=	ac97.4 adv.4 aha.4 ahb.4 ahc.4 aic.4  an.4 aria.4 ast.4 atalk.4 \
 	atapiscsi.4 audio.4 aue.4 auvia.4 awi.4 bpf.4 bridge.4 brgphy.4 \
@@ -13,7 +13,8 @@ MAN=	ac97.4 adv.4 aha.4 ahb.4 ahc.4 aic.4  an.4 aria.4 ast.4 atalk.4 \
 	puc.4 qsphy.4 raid.4 random.4 ray.4 rl.4 rln.4 rlphy.4 route.4 scsi.4 \
 	sd.4 ses.4 sf.4 sis.4 sk.4 sl.4 sm.4 spp.4 sppp.4 sqphy.4 ss.4 st.4 \
 	ste.4 sv.4 tb.4 tcic.4 tcp.4 termios.4 ti.4 tl.4 tlphy.4 tp.4 tqphy.4 \
-	tty.4 tun.4 tx.4 txphy.4 uaudio.4 ubsec.4 udp.4 ugen.4 uhci.4 uhid.4 \
+	tty.4 tun.4 twe.4 tx.4 txphy.4 \
+	uaudio.4 ubsec.4 udp.4 ugen.4 uhci.4 uhid.4 \
 	uk.4 ukphy.4 ulpt.4 umass.4 unix.4 urio.4 usb.4 vlan.4 vnd.4 vr.4 \
 	wb.4 wd.4 wdc.4 we.4 wi.4 \
 	wscons.4 wsdisplay.4 wskbd.4 wsmouse.4 wsmux.4 \
diff --git a/share/man/man4/pci.4 b/share/man/man4/pci.4
index 6c4c3d58525..2e61007771c 100644
--- a/share/man/man4/pci.4
+++ b/share/man/man4/pci.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pci.4,v 1.12 2000/07/20 21:45:20 deraadt Exp $
+.\"	$OpenBSD: pci.4,v 1.13 2000/09/15 18:08:01 mickey Exp $
 .\"	$NetBSD: pci.4,v 1.29 2000/04/01 00:32:23 tsarna Exp $
 .\"
 .\" Copyright (c) 2000 Theo de Raadt.  All rights reserved.
@@ -96,7 +96,7 @@ interfaces.
 DPT SmartCache/SmartRAID III and IV SCSI interfaces.
 .It Xr gdt 4
 ICP-Vortex GDT
-.Tn Raid
+.Tn RAID
 interface.
 .It Xr isp 4
 QLogic ISP-1020, ISP-1040, and ISP-2100
@@ -108,6 +108,10 @@ interfaces.
 Symbios Logic/NCR 53c8xx-family
 .Tn SCSI
 interfaces.
+.It Xr twe 4
+3ware Escalade
+.Tn RAID
+interfaces.
 .El
 .Pp
 .Ss Network interfaces
diff --git a/share/man/man4/twe.4 b/share/man/man4/twe.4
new file mode 100644
index 00000000000..8d99c03019f
--- /dev/null
+++ b/share/man/man4/twe.4
@@ -0,0 +1,65 @@
+.\"	$OpenBSD: twe.4,v 1.1 2000/09/15 18:08:01 mickey Exp $
+.\"
+.\" Copyright (c) 2000 Michael Shalayeff.  All rights reserved.
+.\"
+.\"
+.Dd September 15, 2000
+.Dt TWE 4
+.Os
+.Sh NAME
+.Nm twe
+.Nd
+.Tn 3ware Escalade RAID driver
+.Sh SYNOPSIS
+.Cd "twe* at pci? dev ? function ?"
+.Cd "scsibus* at twe?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for Escalade family of raid controllers,
+including the
+.Tn 3W-5x000 and
+.Tn 3W-6x000
+models.
+.Pp
+Controllers support RAID 0, RAID 1, RAID 10 and JBOD
+configurations. All the RAID set volume management is done
+through the cards BIOS.
+.Pp
+Even though the card uses IDE drives, this driver makes drives
+and/or RAID sets appear as
+.Xr sd 4 .
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr scsi 4 ,
+.Xr sd 4
+.Sh AUTHOR
+The
+.Nm
+driver was written by
+.An Michale Shalayeff Aq mickey@opensbd.org ,
+inspired by the FreeBSD driver by
+.An Mike Smith Aq msmith@freebsd.org .
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Ox 2.8 .
+.Sh BUGS
+The card's BIOS seem to conflict w/ other disk controllers with
+own BIOS if later are configured earlier than this one.
+To avoid that put the card in the lowest slot before other
+SCSI or RAID disk controllers, if possible.
+.Pp
+The card provides mechanism to receive asynchronous notifications
+about RAID set status change and so forth, unfortunately this
+information is not public.
+.Pp
+The card requires data buffers to be aligned to 512 bytes, which
+is not always provided by the
+.Ox
+kernel.
+To work around that double-buffering is used, allocating aligned
+buffer when required and copying data back and forth as needed.
+Unaligned buffers are very rare occasion, but if not handled properly
+makes the card comatose.