[src/trunk]: src/share/man/man4/man4.amiga Add man page for recently introduc...

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

details:   https://anonhg.NetBSD.org/src/rev/ae5bbb48da81
branches:  trunk
changeset: 779594:ae5bbb48da81
user:      rkujawa <rkujawa%NetBSD.org@localhost>
date:      Mon Jun 04 20:16:57 2012 +0000

description:
Add man page for recently introduced empb(4).

diffstat:

 share/man/man4/man4.amiga/Makefile |   4 +-
 share/man/man4/man4.amiga/empb.4   |  84 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 86 insertions(+), 2 deletions(-)

diffs (102 lines):

diff -r 085a9cfe315d -r ae5bbb48da81 share/man/man4/man4.amiga/Makefile
--- a/share/man/man4/man4.amiga/Makefile        Mon Jun 04 20:13:47 2012 +0000
+++ b/share/man/man4/man4.amiga/Makefile        Mon Jun 04 20:16:57 2012 +0000
@@ -1,8 +1,8 @@
 #      from: @(#)Makefile      8.2 (Berkeley) 2/16/94
-#      $NetBSD: Makefile,v 1.25 2012/05/15 17:46:26 rkujawa Exp $
+#      $NetBSD: Makefile,v 1.26 2012/06/04 20:16:57 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 es.4 fdc.4 grf.4 \
+       bah.4 bppcsc.4 clockport.4 cv3dpb.4 ed.4 efa.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 zssc.4
diff -r 085a9cfe315d -r ae5bbb48da81 share/man/man4/man4.amiga/empb.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/man4.amiga/empb.4  Mon Jun 04 20:16:57 2012 +0000
@@ -0,0 +1,84 @@
+.\" $NetBSD: empb.4,v 1.1 2012/06/04 20:16:57 rkujawa Exp $
+.\"
+.\" Copyright (c) 2012 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 June 4, 2012
+.Dt EMPB 4 amiga
+.Os
+.Sh NAME
+.Nm empb
+.Nd ELBOX Mediator 1200 PCI bridge driver 
+.Sh SYNOPSIS
+.Cd "empb0 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 1200 bridge for
+Amiga 1200.
+.Sh HARDWARE
+The
+.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 
+.El
+.Sh SEE ALSO
+.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 Frank Wille and Radoslaw Kujawa. 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.
+.Sh BUGS
+DMA to host memory is not supported.
+This is a hardware limitation.
+It is possible to implement DMA through bounce buffers in graphics card memory,
+but this needs further research.
+.Pp
+PCI memory space access is buggy, this is a driver problem.