[src/trunk]: src/share/man/man4/man4.amiga Add man page for em4k. While here ...

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

details:   https://anonhg.NetBSD.org/src/rev/f800d0a5b062
branches:  trunk
changeset: 784497:f800d0a5b062
user:      rkujawa <rkujawa%NetBSD.org@localhost>
date:      Tue Jan 29 21:31:18 2013 +0000

description:
Add man page for em4k. While here update empb.

diffstat:

 share/man/man4/man4.amiga/Makefile |   4 +-
 share/man/man4/man4.amiga/em4k.4   |  85 ++++++++++++++++++++++++++++++++++++++
 share/man/man4/man4.amiga/empb.4   |  18 ++++----
 3 files changed, 96 insertions(+), 11 deletions(-)

diffs (156 lines):

diff -r e8c4d18252c4 -r f800d0a5b062 share/man/man4/man4.amiga/Makefile
--- a/share/man/man4/man4.amiga/Makefile        Tue Jan 29 21:29:40 2013 +0000
+++ b/share/man/man4/man4.amiga/Makefile        Tue Jan 29 21:31:18 2013 +0000
@@ -1,8 +1,8 @@
 #      from: @(#)Makefile      8.2 (Berkeley) 2/16/94
-#      $NetBSD: Makefile,v 1.27 2012/11/26 00:36:01 rkujawa Exp $
+#      $NetBSD: Makefile,v 1.28 2013/01/29 21:31:18 rkujawa Exp $
 
 MAN=   a1k2cp.4 afsc.4 ahsc.4 amidisplaycc.4 atzsc.4 autoconf.4 console.4 \
-       bah.4 bppcsc.4 clockport.4 cv3dpb.4 ed.4 efa.4 empb.4 es.4 fdc.4 grf.4 \
+       bah.4 bppcsc.4 clockport.4 cv3dpb.4 ed.4 efa.4 em4k.4 empb.4 es.4 fdc.4 grf.4 \
        grfcl.4 grfcv.4 grfcv3d.4 grfet.4 grfrh.4 grfrt.4 grful.4 \
        gtsc.4 intro.4 ite.4 mem.4 mfcs.4 mgnsc.4 mppb.4 p5membar.4 p5pb.4 \
        qn.4 ser.4 wesc.4 xsurf.4 z3rambd.4 zssc.4
diff -r e8c4d18252c4 -r f800d0a5b062 share/man/man4/man4.amiga/em4k.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/man4.amiga/em4k.4  Tue Jan 29 21:31:18 2013 +0000
@@ -0,0 +1,85 @@
+.\" $NetBSD: em4k.4,v 1.1 2013/01/29 21:31:18 rkujawa Exp $
+.\"
+.\" Copyright (c) 2013 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Radoslaw Kujawa.
+.\"
+.\" 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 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 29 January, 2013
+.Dt EM4K 4 amiga
+.Os
+.Sh NAME
+.Nm em4k
+.Nd ELBOX Mediator 4000 PCI bridge driver
+.Sh SYNOPSIS
+.Cd "em4k0 at zbus0"
+.Cd "emmem0 at zbus0"
+.Cd "pci* at empb0"
+.Cd "options PCI_NETBSD_CONFIGURE"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the PCI bus present on Mediator 4000 bridge and associated
+PCI/Zorro daughterboards.
+.Sh HARDWARE
+The
+.Nm
+driver supports the following hardware:
+.Bl -tag -offset indent
+.It ELBOX Mediator PCI 4000D
+.It ELBOX Mediator PCI 4000Di
+.It ELBOX Mediator PCI 4000T 
+.It ELBOX Mediator PCI 3000D 
+.It ELBOX Mediator PCI 3000T 
+.El
+MK-II editions are also supported.
+.Sh SEE ALSO
+.Xr empb 4 ,
+.Xr mppb 4 ,
+.Xr p5pb 4 ,
+.Xr pci 4
+.Sh HISTORY
+The
+.Nm
+device first appeared in
+.Nx 7.0 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver was written by
+.An Radoslaw Kujawa Aq radoslaw.kujawa%gmail.com@localhost .
+It was developed using information obtained through reverse engineering
+by
+.An Frank Wille
+and
+.An Radoslaw Kujawa .
+The authors have no access to official
+documentation (which is only available under NDA).
+.Sh BUGS
+DMA to host memory is not supported.
+It is unclear if the hardware supports DMA to host memory at all.
+It is possible to implement DMA through bounce buffers in graphics card memory,
+but this needs further research.
diff -r e8c4d18252c4 -r f800d0a5b062 share/man/man4/man4.amiga/empb.4
--- a/share/man/man4/man4.amiga/empb.4  Tue Jan 29 21:29:40 2013 +0000
+++ b/share/man/man4/man4.amiga/empb.4  Tue Jan 29 21:31:18 2013 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: empb.4,v 1.8 2013/01/28 15:41:17 rkujawa Exp $
+.\" $NetBSD: empb.4,v 1.9 2013/01/29 21:31:19 rkujawa Exp $
 .\"
 .\" Copyright (c) 2012 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd July 3, 2012
+.Dd 29 Jaunary, 2012
 .Dt EMPB 4 amiga
 .Os
 .Sh NAME
@@ -49,11 +49,11 @@
 .Nm
 driver supports the following hardware:
 .Bl -tag -offset indent
-.It ELBOX Mediator 1200
-.It ELBOX Mediator 1200 LT2
-.It ELBOX Mediator 1200 LT4
-.It ELBOX Mediator 1200 SX
-.It ELBOX Mediator 1200 TX
+.It ELBOX Mediator PCI 1200
+.It ELBOX Mediator PCI 1200 LT2
+.It ELBOX Mediator PCI 1200 LT4
+.It ELBOX Mediator PCI 1200 SX
+.It ELBOX Mediator PCI 1200 TX
 .El
 .Sh DIAGNOSTICS
 .Bl -diag
@@ -74,6 +74,7 @@
 To enable memory space set the WINDOW jumper to 4MB or 8MB.
 .El
 .Sh SEE ALSO
+.Xr em4k 4 ,
 .Xr mppb 4 ,
 .Xr p5pb 4 ,
 .Xr pci 4
@@ -96,8 +97,7 @@
 The authors have no access to official
 documentation (which is only available under NDA).
 .Sh CAVEATS
-Mediator 4000 and ZIV models are not supported, but support could easily be
-added if the developers had access to this hardware.
+Mediator ZIV might work but is untested.
 .Sh BUGS
 DMA to host memory is not supported.
 This is a hardware limitation.