Document hp300 isabr(4).

4 files changed, 66 insertions, 7 deletions

diff --git a/share/man/man4/isa.4 b/share/man/man4/isa.4
index 606cefb3d65..46a58a56b8b 100644
--- a/share/man/man4/isa.4
+++ b/share/man/man4/isa.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: isa.4,v 1.47 2007/01/03 20:05:11 miod Exp $
+.\"	$OpenBSD: isa.4,v 1.48 2007/01/06 20:40:19 miod Exp $
 .\"	$NetBSD: isa.4,v 1.19 2000/03/18 16:54:37 augustss Exp $
 .\"
 .\" Copyright (c) 2000 Theo de Raadt.  All rights reserved.
@@ -31,7 +31,7 @@
 .\" (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 April 4, 2000
+.Dd January 6, 2007
 .Dt ISA 4
 .Os
 .Sh NAME
@@ -53,6 +53,9 @@
 .Cd "# cats"
 .Cd "isa0 at pcib?"
 .Pp
+.Cd "# hp300"
+.Cd "isa* at isabr?"
+.Pp
 Attachments are machine-dependent and depend on the bus topology and
 .Tn ISA
 bus interface of your system.
diff --git a/share/man/man4/man4.hp300/Makefile b/share/man/man4/man4.hp300/Makefile
index 41d8b1f3955..9d30a1e688c 100644
--- a/share/man/man4/man4.hp300/Makefile
+++ b/share/man/man4/man4.hp300/Makefile
@@ -1,8 +1,8 @@
-#	$OpenBSD: Makefile,v 1.13 2006/04/15 17:34:38 miod Exp $
+#	$OpenBSD: Makefile,v 1.14 2007/01/06 20:40:20 miod Exp $
 #	from: @(#)Makefile	5.1 (Berkeley) 6/29/90
 
 MAN=	apci.4 autoconf.4 ct.4 dca.4 dcm.4 dio.4 dnkbd.4 dvbox.4 \
-	frodo.4 gbox.4 hd.4 hyper.4 intro.4 le.4 mem.4 \
+	frodo.4 gbox.4 hd.4 hyper.4 intro.4 isabr.4 le.4 mem.4 \
 	nhpib.4 ppi.4 rbox.4 sgc.4 spc.4 topcat.4 tvrx.4
 MLINKS=	mem.4 kmem.4
 MLINKS+=nhpib.4 fhpib.4 nhpib.4 hpibbus.4
diff --git a/share/man/man4/man4.hp300/frodo.4 b/share/man/man4/man4.hp300/frodo.4
index d098f8b2b73..4490ea8ffa2 100644
--- a/share/man/man4/man4.hp300/frodo.4
+++ b/share/man/man4/man4.hp300/frodo.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: frodo.4,v 1.4 2005/09/27 22:05:33 miod Exp $
+.\"	$OpenBSD: frodo.4,v 1.5 2007/01/06 20:40:20 miod Exp $
 .\"
 .\" Copyright (c) 2003, Miodrag Vallat.
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd September 27, 2005
+.Dd January 6, 2007
 .Dt FRODO 4 hp300
 .Os
 .Sh NAME
@@ -34,6 +34,7 @@
 .Cd "frodo0 at intio?"
 .Cd "apci* at frodo?"
 .Cd "dnkbd0 at frodo?"
+.Cd "isabr0 at frodo?"
 .Sh DESCRIPTION
 The
 .Tn FRODO
@@ -45,7 +46,11 @@ It provides four
 .Xr apci 4
 serial ports, the first one being used to connect the
 Domain keyboard.
+On system with ISA slots,
+.Nm
+also provides ISA interrupt logic.
 .Sh SEE ALSO
 .Xr apci 4 ,
 .Xr dnkbd 4 ,
-.Xr intro 4
+.Xr intro 4 ,
+.Xr isabr 4
diff --git a/share/man/man4/man4.hp300/isabr.4 b/share/man/man4/man4.hp300/isabr.4
new file mode 100644
index 00000000000..547cc3eccbf
--- /dev/null
+++ b/share/man/man4/man4.hp300/isabr.4
@@ -0,0 +1,51 @@
+.\"	$OpenBSD: isabr.4,v 1.1 2007/01/06 20:40:20 miod Exp $
+.\"
+.\" Copyright (c) 2007 Miodrag Vallat.
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice, this permission notice, and the disclaimer below
+.\" appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd January 6, 2007
+.Dt ISABR 4 hp300
+.Os
+.Sh NAME
+.Nm isabr
+.Nd Frodo ISA bridge
+.Sh SYNOPSIS
+.Cd "isabr0 at frodo?"
+.Cd "isa* at isabr?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides access to the ISA slot found in model
+.Sq t
+HP 9000/4xx workstations.
+.Sh SEE ALSO
+.Xr frodo 4 ,
+.Xr intro 4 ,
+.Xr isa 4
+.Sh CAVEATS
+Interrupt numbers 0, 1, 2 and 8 are permanently makesd on hp300 systems.
+Therefore ISA devices should not configured to use them.
+.Sh BUGS
+ISA interrupts are not handled correctly.
+Some devices cause the
+.Xr frodo 4
+chip to interrupt, but without any change in its status registers;
+others will correctly interrupt, but
+.Xr frodo 4
+will not ack the interrupt, resulting in an interrupt storm.
+.Pp
+The 4-slot EISA bridge found in model
+.Sq s
+workstations is not supported yet.