[src/trunk]: src/share/man/man4/man4.amiga Extend the mppb(4) man page.

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

details:   https://anonhg.NetBSD.org/src/rev/b72ab83ab9db
branches:  trunk
changeset: 771762:b72ab83ab9db
user:      rkujawa <rkujawa%NetBSD.org@localhost>
date:      Sat Dec 03 23:09:42 2011 +0000

description:
Extend the mppb(4) man page.

diffstat:

 share/man/man4/man4.amiga/mppb.4 |  26 +++++++++++++++++++++++---
 1 files changed, 23 insertions(+), 3 deletions(-)

diffs (51 lines):

diff -r c311d2a2c74a -r b72ab83ab9db share/man/man4/man4.amiga/mppb.4
--- a/share/man/man4/man4.amiga/mppb.4  Sat Dec 03 22:41:40 2011 +0000
+++ b/share/man/man4/man4.amiga/mppb.4  Sat Dec 03 23:09:42 2011 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: mppb.4,v 1.2 2011/09/19 19:18:19 rkujawa Exp $
+.\" $NetBSD: mppb.4,v 1.3 2011/12/03 23:09:42 rkujawa Exp $
 .\"
 .\" Copyright (c) 2011 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 September 17, 2011
+.Dd December 3, 2011
 .Dt MPPB 4 amiga
 .Os
 .Sh NAME
@@ -47,7 +47,12 @@
 driver supports the following hardware:
 .Bl -tag -width "PROMETHEUS" -offset indent
 .It Em PROMETHEUS
-Matay Prometheus.
+Matay Prometheus. Manufacturer 44359, product 1.
+.El
+.Sh DIAGNOSTICS
+.Bl -diag
+.It Unable to allocate space in parent map.
+The kernel has ran out of virtual memory space. 
 .El
 .Sh SEE ALSO
 .Xr pci 4
@@ -64,3 +69,18 @@
 .An Radoslaw Kujawa Aq radoslaw.kujawa%gmail.com@localhost .
 .Sh BUGS
 The hardware does not support DMA to host memory.
+.Pp
+The Prometheus does not support repeating of PCI transations, instead if the
+PCI card demands a retry of transaction, it returns value 0xFFFFFFFF. 
+This is currently not handled by the 
+.Nm
+driver and will confuse some PCI card drivers.
+.Pp
+The system may run out of kernel virtual memory space if Prometheus is present.
+This is due to fact that m68k-specific 
+.Xr pmap 9
+code places User Page Table base address at statically defined address 
+0x10000000, which does not leave enough kernel space to fit a 512MB board, such 
+as the Prometheus. 
+It is possible to work around this problem, by moving User Page Table base 
+to higher address.