Sat Jun 20 18:20:51 2009 UTC ()
update a few things, mostly from yorick hardy in PR#41528.
note "options DRM_EXTERNAL".


(mrg)
diff -r1.7 -r1.8 src/share/man/man4/drm.4
cvs diff -r1.7 -r1.8 src/share/man/man4/drm.4 (expand / switch to unified diff)

--- src/share/man/man4/drm.4 2009/05/12 08:16:46 1.7
+++ src/share/man/man4/drm.4 2009/06/20 18:20:51 1.8
@@ -1,56 +1,57 @@ @@ -1,56 +1,57 @@
1.\" $NetBSD: drm.4,v 1.7 2009/05/12 08:16:46 wiz Exp $ 1.\" $NetBSD: drm.4,v 1.8 2009/06/20 18:20:51 mrg Exp $
2.\" 2.\"
3.\" Copyright (c) 2007 Thomas Klausner 3.\" Copyright (c) 2007 Thomas Klausner
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 17.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 18.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 19.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 20.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 21.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 22.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 23.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 24.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25.\" 25.\"
26.Dd May 12, 2009 26.Dd June 19, 2009
27.Dt DRM 4 27.Dt DRM 4
28.Os 28.Os
29.Sh NAME 29.Sh NAME
30.Nm drm 30.Nm drm
31.Nd Direct Rendering Manager (DRI kernel support) 31.Nd Direct Rendering Manager (DRI kernel support)
32.Sh SYNOPSIS 32.Sh SYNOPSIS
33.Cd i915drm* at vga? 33.Cd i915drm* at vga?
34.Cd mach64drm* at vga? 34.Cd mach64drm* at vga?
35.Cd mgadrm* at vga? 35.Cd mgadrm* at vga?
36.Cd r128drm* at vga? 36.Cd r128drm* at vga?
37.Cd radeondrm* at vga? 37.Cd radeondrm* at vga?
38.Cd savagedrm* at vga? 38.Cd savagedrm* at vga?
39.Cd sisdrm* at vga? 39.Cd sisdrm* at vga?
40.Cd tdfxdrm* at vga? 40.Cd tdfxdrm* at vga?
41.Cd viadrm* at vga? 41.Cd viadrm* at vga?
42.Pp 42.Pp
43.Cd options DRM_DEBUG 43.Cd options DRM_DEBUG
 44.Cd options DRM_EXTERNAL
44.Cd options DRM_NO_AGP 45.Cd options DRM_NO_AGP
45.Sh DESCRIPTION 46.Sh DESCRIPTION
46The 47The
47.Tn Direct Rendering Manager 48.Tn Direct Rendering Manager
48is part of the 49is part of the
49.Tn Direct Rendering Infrastructure 50.Tn Direct Rendering Infrastructure
50(see 51(see
51.Pa http://dri.freedesktop.org/ ) 52.Pa http://dri.freedesktop.org/ )
52for supporting video acceleration (3d acceleration, mostly). 53for supporting video acceleration (3d acceleration, mostly).
53.Pp 54.Pp
54The 55The
55.Nm 56.Nm
56drivers provide support for the following chipsets: 57drivers provide support for the following chipsets:
@@ -76,135 +77,135 @@ VIA @@ -76,135 +77,135 @@ VIA
76.El 77.El
77.Pp 78.Pp
78To make use of the driver, the kernel must include 79To make use of the driver, the kernel must include
79.Xr agp 4 80.Xr agp 4
80(for some drivers, using 81(for some drivers, using
81.Cd options DRM_NO_AGP 82.Cd options DRM_NO_AGP
82instead may be sufficient), 83instead may be sufficient),
83.Xr X 7 84.Xr X 7
84must be compiled with DRI support, Mesa DRI drivers must be installed, 85must be compiled with DRI support, Mesa DRI drivers must be installed,
85the appropriate 86the appropriate
86.Pa /dev/dri/card* 87.Pa /dev/dri/card*
87device must exist, and DRI must be enabled in the X configuration 88device must exist, and DRI must be enabled in the X configuration
88file. 89file.
 90.Xr X 7
 91provided with NetBSD and compiled from
 92.Xr pkgsrc 7
 93do so automatically where supported.
89.Pp 94.Pp
90Details for these steps: 95.Xr X 7
91.Bl -enum -offset indent 96will attempt to create the device node automatically.
92.It 97To create the device node manually:
93X must be compiled with DRI support. 
94On i386, this is usually the default. 
95.It 
96Mesa (see 
97.Pa http://www.mesa3d.org/ ) 
98should be compiled for the netbsd-dri target, patch available at 
99.Pa http://issc.uj.ac.za/~yorick/drm/mesa.patch 
100.It 
101The device node must exist: 
102.Bd -literal -offset indent 98.Bd -literal -offset indent
103mkdir -p /dev/dri 99mkdir -p /dev/dri
104mknod /dev/dri/card0 c 180 0 100mknod /dev/dri/card0 c 180 0
105chgrp wheel /dev/dri/card0 101chgrp wheel /dev/dri/card0
106chmod 0660 /dev/dri/card0 102chmod 0660 /dev/dri/card0
107.Ed 103.Ed
108.It 104.Pp
109Enable DRI in the X configuration (either 105To enable DRI in the X configuration add the following to either
110.Pa xorg.conf 106.Pa xorg.conf
 107for
 108.Xr Xorg 1
111or 109or
112.Pa XF86Config ) : 110.Pa XF86Config
113.Bd -literal 111for
 112.Xr XFree86 1
 113:
 114.Bd -literal -offset indent
114Section "Module" 115Section "Module"
115 ... 116 ...
116 Load "dri" 117 Load "dri"
117 Load "GLcore" 118 Load "dri2"
118 Load "glx" 119 Load "glx"
119EndSection 120EndSection
120\&... 121\&...
121Section "DRI" 122Section "DRI"
122 Group "wheel" 123 Group "wheel"
123 Mode 0660 124 Mode 0660
124EndSection 125EndSection
125.Ed 126.Ed
126.El 
127.Pp 127.Pp
128Debugging output can be enabled and disabled by setting the 128Debugging output can be enabled and disabled by setting the
129.Xr sysctl 8 129.Xr sysctl 8
130node 130node
131.Ar hw.dri.debug . 131.Ar hw.dri.debug .
132Additional information can be obtained from the 132Additional information can be obtained from the
133.Xr sysctl 8 133.Xr sysctl 8
134nodes 134nodes
135.Ar hw.dri , 135.Ar hw.dri ,
136.Ar hw.dri.card0 , 136.Ar hw.dri.card0 ,
137.Ar hw.dri.card1 , 137.Ar hw.dri.card1 ,
138etc. 138etc.
139.Sh SEE ALSO 139.Sh SEE ALSO
140.Xr agp 4 , 140.Xr agp 4 ,
141.Xr X 7 141.Xr X 7 ,
 142.Xr XFree86 1 ,
 143.Xr Xorg 1 ,
 144.Xr xorg.conf 5 ,
 145.Xr XF86Config 5 ,
 146.Xr /usr/X11R[67]/lib/X11/doc/README.DRI
142.Sh HISTORY 147.Sh HISTORY
143DRM was first available for Linux. 148DRM was first available for Linux.
144Subsequently Eric Anholt ported the DRM kernel modules to 149Subsequently Eric Anholt ported the DRM kernel modules to
145.Fx . 150.Fx .
146Erik Reid adapted the 151Erik Reid adapted the
147.Fx 152.Fx
148DRM kernel modules to 153DRM kernel modules to
149.Nx . 154.Nx .
150As DRM continued to develop the 155As DRM continued to develop the
151.Nx 156.Nx
152support was neglected. 157support was neglected.
153Tonnerre Lombard got the DRM modules working again, but DRM 158Tonnerre Lombard got the DRM modules working again, but DRM
154development once again left the 159development once again left the
155.Nx 160.Nx
156support behind. 161support behind.
157Finally Yorick Hardy took the 162Finally Yorick Hardy took the
158.Fx 163.Fx
159DRM source and managed to get it compiling and working again on 164DRM source and managed to get it compiling and working again on
160.Nx , 165.Nx ,
161thanks largely to the efforts of all those mentioned above. 166thanks largely to the efforts of all those mentioned above.
162Subsequently Matthias Drochner improved the DRM file hierarchy for 167Subsequently Matthias Drochner improved the DRM file hierarchy for
163.Nx 168.Nx
164and committed the DRM kernel drivers. 169and committed the DRM kernel drivers.
 170Matthew Green cleaned up this port and merged a set of newer
 171drivers, with Arto Huusko and FUKAUMI Naoki helping to get
 172the latest Mesa port upto date.
165.Pp 173.Pp
166The 174The
167.Nm 175.Nm
168drivers appeared in 176drivers appeared in
169.Nx 5.0 . 177.Nx 5.0 .
170.Sh AUTHORS 178.Sh AUTHORS
171.An -nosplit 179.An -nosplit
172.An Eric Anholt , 180.An Eric Anholt ,
173.An Terry Barnaby , 181.An Terry Barnaby ,
174.An Erdi Chen , 182.An Erdi Chen ,
175.An Michel Daenzer , 183.An Michel Daenzer ,
176.An Leif Delgass , 184.An Leif Delgass ,
177.An Frank C. Earl , 185.An Frank C. Earl ,
178.An Rickard E. Faith , 186.An Rickard E. Faith ,
179.An Jose Fonseca , 187.An Jose Fonseca ,
180.An Nicolai Haehnle , 188.An Nicolai Haehnle ,
181.An Jeff Hartmann , 189.An Jeff Hartmann ,
182.An Thomas Hellstrom , 190.An Thomas Hellstrom ,
183.An Gareth Hughes , 191.An Gareth Hughes ,
184.An Felix Kuehling , 192.An Felix Kuehling ,
185.An Sung-Ching Lin , 193.An Sung-Ching Lin ,
186.An Kevin E. Martin , 194.An Kevin E. Martin ,
187.An Jared D. McNeill , 195.An Jared D. McNeill ,
188.An Daryll Strauss , 196.An Daryll Strauss ,
189.An Keith Whitwell 197.An Keith Whitwell
190.Sh CAVEATS 198.Sh CAVEATS
191Disable AIGLX if necessary 
192.Pq Pa xorg.conf : 
193.Bd -literal -offset indent 
194Section "ServerFlags" 
195 Option "AIGLX" "off" 
196EndSection 
197 
198Section "Extensions" 
199 Option "Composite" "Disable" 
200EndSection 
201.Ed 
202.Pp 199.Pp
203In case of errors, 200In case of errors,
204.Pa /dev/dri/card0 201.Pa /dev/dri/card0
205may be changed, make sure to recreate it in that case. 202may be changed, make sure to recreate it in that case.
206.Pp 203.Pp
207.Cd options DRM_DEBUG 204.Cd options DRM_DEBUG
208can slow DRI down a lot, disable it once 205can slow DRI down a lot, disable it once
209.Nm 206.Nm
210works. 207works.
 208.Pp
 209To use the latest drivers,
 210.Cd options DRM_EXTERNAL
 211must be added to the kernel configuration file.