1 .\" $NetBSD: drm.4,v 1.7 2009/05/12 08:16:46 wiz Exp $
3 .\" Copyright (c) 2007 Thomas Klausner
4 .\" All rights reserved.
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
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
17 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
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
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
24 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 .Nd Direct Rendering Manager (DRI kernel support)
45 .\".Cd options DRM_LINUX
48 .Tn Direct Rendering Manager
50 .Tn Direct Rendering Infrastructure
52 .Pa http://dri.freedesktop.org/ )
53 for supporting video acceleration.
54 For older chipsets it's used for 3d acceleration only, but newer chipsets
57 for 2d acceleration (XVideo, EXA) as well.
61 drivers provide support for the following chipsets:
63 .Bl -tag -width XsavagedrmXXX -offset indent -compact
65 Intel i915, i945, i965, G3x, G4x
67 Mach64 (3D Rage Pro, Rage)
69 Matrox G[24]00, G[45]50
84 To make use of the driver:
88 The kernel must include
92 MesaLib and the video driver to be used must be compiled with DRI support
94 DRI must be enabled in the
105 In order to use two graphics cards (an on-board and another
106 AGP/PCI/PCIe card) with DRI, a
110 has to be created using
115 acceleration fails to initialize with a
116 .Dq contigmalloc_map: failed size...
117 error in dmesg, the reserve of memory for DMA ran out early and should
118 be increased to a sufficiently high value by setting the
123 variable of the same name is provided for obtaining its current value.
125 Debugging output can be enabled and disabled by setting the
134 DRM was first available for Linux.
135 Subsequently Eric Anholt ported the DRM kernel modules to
138 Disable AIGLX if necessary
140 .Bd -literal -offset indent
141 Section "ServerFlags"
146 Option "Composite" "Disable"
150 .Cd options DRM_DEBUG
151 can slow DRI down a lot, disable it once