Thu Jan 19 00:30:31 2012 UTC ()
Update the p5pb(4) page to reflect the recent changes in this driver.


(rkujawa)
diff -r1.6 -r1.7 src/share/man/man4/man4.amiga/p5pb.4
cvs diff -r1.6 -r1.7 src/share/man/man4/man4.amiga/p5pb.4 (expand / switch to unified diff)

--- src/share/man/man4/man4.amiga/p5pb.4 2012/01/11 10:15:36 1.6
+++ src/share/man/man4/man4.amiga/p5pb.4 2012/01/19 00:30:31 1.7
@@ -1,113 +1,95 @@ @@ -1,113 +1,95 @@
1.\" $NetBSD: p5pb.4,v 1.6 2012/01/11 10:15:36 wiz Exp $ 1.\" $NetBSD: p5pb.4,v 1.7 2012/01/19 00:30:31 rkujawa Exp $
2.\" 2.\"
3.\" Copyright (c) 2011 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2011, 2012 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Radoslaw Kujawa. 7.\" by Radoslaw Kujawa.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\" notice, this list of conditions and the following disclaimer in the 15.\" notice, this list of conditions and the following disclaimer in the
16.\" documentation and/or other materials provided with the distribution. 16.\" documentation and/or other materials provided with the distribution.
17.\" 17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE. 28.\" POSSIBILITY OF SUCH DAMAGE.
29.\" 29.\"
30.Dd January 10, 2012 30.Dd January 19, 2012
31.Dt P5PB 4 amiga 31.Dt P5PB 4 amiga
32.Os 32.Os
33.Sh NAME 33.Sh NAME
34.Nm p5pb 34.Nm p5pb
35.Nd Phase5 PCI bridge driver 35.Nd Phase5 PCI bridge driver
36.Sh SYNOPSIS 36.Sh SYNOPSIS
37.Cd "p5pb0 at p5bus0" 37.Cd "p5pb0 at p5bus0"
38.Cd "pci* at p5pb?" 38.Cd "pci* at p5pb?"
39.Cd "genfb* at pci?" 39.Cd "genfb* at pci?"
40.Cd "options P5PB_OLD_FIRMWARE" 
41.Cd "options P5PB_GENFB" 
42.Cd "options P5PB_DEBUG" 40.Cd "options P5PB_DEBUG"
43.Sh DESCRIPTION 41.Sh DESCRIPTION
44The 42The
45.Nm 43.Nm
46driver provides support for the PCI bus present on various devices equipped with 44driver provides support for the PCI bus present on various devices equipped with
47the Phase5 PCI bridge. 45the Phase5 PCI bridge.
48.Pp 46.Pp
49Processor boards running firmware revision older than 44.69 need a kernel 
50configured with the 
51.Dv P5PB_OLD_FIRMWARE 
52option. 
53.Pp 
54The 47The
55.Nm 48.Nm
56driver provides necessary support for CyberVisionPPC and BlizzardVisionPPC, 49driver provides necessary support for CyberVisionPPC and BlizzardVisionPPC,
57allowing attachment of 50allowing attachment of
58.Xr genfb 4 51.Xr genfb 4
59driver. 52driver.
60Owners of these cards should enable the 
61.Dv P5PB_GENFB 
62option. 
63.Pp 53.Pp
64Additional, excessive debugging output is enabled by the 54Additional, excessive debugging output is enabled by the
65.Dv P5PB_DEBUG 55.Dv P5PB_DEBUG
66option. 56option.
67.Sh HARDWARE 57.Sh HARDWARE
68The 58The
69.Nm 59.Nm
70driver supports the following hardware: 60driver supports the following hardware:
71.Bl -tag -offset indent 61.Bl -tag -offset indent
72.It Phase5 BlizzardVisionPPC graphics card. 62.It Phase5 BlizzardVisionPPC graphics card
73.It Phase5 CyberVisionPPC graphics card. 63.It Phase5 CyberVisionPPC graphics card
74.It DCE Computer G-REX 1200 (experimental, first slot only). 64.It DCE Computer G-REX 1200 (experimental, first slot only)
75.It DCE Computer G-REX 4000 (experimental, first slot only). 65.It DCE Computer G-REX 4000 (experimental, first slot only)
76.El 66.El
77.Sh SEE ALSO 67.Sh SEE ALSO
78.Xr genfb 4 , 68.Xr genfb 4 ,
79.\" .Xr pm2fb 4 69.\" .Xr pm2fb 4
80.\" .Xr cv3dpb 4 , 70.Xr cv3dpb 4 ,
81.Xr p5membar 4 , 71.Xr p5membar 4 ,
82.Xr pci 4 72.Xr pci 4
83.Sh HISTORY 73.Sh HISTORY
84The 74The
85.Nm 75.Nm
86device first appeared in 76device first appeared in
87.Nx 6.0 . 77.Nx 6.0 .
88.Sh AUTHORS 78.Sh AUTHORS
89.An -nosplit 79.An -nosplit
90The 80The
91.Nm 81.Nm
92driver was written by 82driver was written by
93.An Radoslaw Kujawa Aq radoslaw.kujawa@gmail.com . 83.An Radoslaw Kujawa Aq radoslaw.kujawa@gmail.com .
94.Sh CAVEATS 84.Sh CAVEATS
95The 85The
96.Nx 86.Nx
97developers don't have access to G-REX hardware or documentation. 87developers don't have access to G-REX hardware or documentation.
98Support for this device is based on best wishes. 88Support for this device is based on best wishes.
99.Pp 89.Pp
100Support for 90Support for
101.Xr genfb 4 91.Xr genfb 4
102framebuffer on CVPPC/BVPPC needs more testing. 92framebuffer on CVPPC/BVPPC needs more testing.
103.Sh BUGS 93.Sh BUGS
104The current version of this driver depends on PCI bus setup and 
105enumeration done by the firmware. 
106.Pp 
107DMA to host memory is not supported. 94DMA to host memory is not supported.
108This is a driver limitation. 95This is a driver limitation.
109.Pp 
110The 
111.Dv P5PB_OLD_FIRMWARE 
112option should only be enabled if PCI hardware is present. 
113Otherwise a kernel panic might occur due to bus error.