Gentoo Archives: gentoo-doc-cvs

From: Josh Saddler <nightmorph@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: dri-howto.xml
Date: Sun, 07 May 2006 12:39:07
Message-Id: 20060507123917.AB641642B1@smtp.gentoo.org
1 nightmorph 06/05/07 12:39:17
2
3 Modified: dri-howto.xml
4 Log:
5 Updated some parts of the dri-howto doc. Until I can track down an ati or non-nvidia cardholder, though, the proposed hardware check process will have to wait. Mostly, I need a monkey/volunteer to show some bits of /proc. The section is in comments in the guide now, so it can be added eventually. See bug 116506 .
6
7 Revision Changes Path
8 1.29 xml/htdocs/doc/en/dri-howto.xml
9
10 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/dri-howto.xml?rev=1.29&content-type=text/x-cvsweb-markup&cvsroot=gentoo
11 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/dri-howto.xml?rev=1.29&content-type=text/plain&cvsroot=gentoo
12 diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/dri-howto.xml.diff?r1=1.28&r2=1.29&cvsroot=gentoo
13
14 Index: dri-howto.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v
17 retrieving revision 1.28
18 retrieving revision 1.29
19 diff -u -r1.28 -r1.29
20 --- dri-howto.xml 1 Feb 2006 11:58:34 -0000 1.28
21 +++ dri-howto.xml 7 May 2006 12:39:17 -0000 1.29
22 @@ -1,5 +1,5 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v 1.28 2006/02/01 11:58:34 neysx Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v 1.29 2006/05/07 12:39:17 nightmorph Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 <guide link="/doc/en/dri-howto.xml">
29 @@ -20,8 +20,8 @@
30 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
31 <license/>
32
33 -<version>1.2</version>
34 -<date>2006-02-01</date>
35 +<version>1.3</version>
36 +<date>2006-05-07</date>
37
38 <chapter>
39 <title>Introduction</title>
40 @@ -92,8 +92,10 @@
41 <p>
42 This guide is for people who can't get direct rendering working with just Xorg.
43 X11-DRM works for 3dfx, gamma, i8x0, matrox, rage128, radeon, mach64 and sis300
44 -series drivers. See the <uri link="http://dri.freedesktop.org/">DRI
45 -homepage</uri> for more info and documentation.
46 +series drivers. VIA card owners should not use <c>x11-drm</c>, but should
47 +instead use the DRI provided in recent kernels (&gt;2.6.13). See the <uri
48 +link="http://dri.freedesktop.org/">DRI homepage</uri> for more info and
49 +documentation.
50 </p>
51
52 </body>
53 @@ -271,6 +273,11 @@
54 intel-agp
55 </pre>
56
57 +<note>
58 +If you compiled <c>agpgart</c> as a module, you will also need to add it to
59 +<path>/etc/modules.autoload.d/kernel-2.6</path>.
60 +</note>
61 +
62 </body>
63 </section>
64 </chapter>
65 @@ -282,18 +289,18 @@
66 <body>
67
68 <p>
69 -Reboot your computer to your new kernel. It's time to see if you have direct
70 -rendering and how good it is.
71 +Reboot your computer to your new kernel and login as a normal user. It's time
72 +to see if you have direct rendering and how good it is.
73 </p>
74
75 <pre caption="Testing rendering">
76 -# <i>startx</i>
77 +$ <i>startx</i>
78 <comment>(No need to load modules for your driver or agpgart, if you compiled agpgart as a module.)</comment>
79 <comment>(They will be loaded automatically.)</comment>
80 -# <i>glxinfo | grep rendering</i>
81 +$ <i>glxinfo | grep rendering</i>
82 direct rendering: Yes
83 <comment>(If it says "No," you don't have 3D acceleration.)</comment>
84 -# <i>glxgears</i>
85 +$ <i>glxgears</i>
86 <comment>(Test your frames per second (FPS) at the default size. The number should be )</comment>
87 <comment>(significantly higher than before installing x11-drm. Do this while the CPU is as idle as possible.)</comment>
88 </pre>
89 @@ -452,6 +459,57 @@
90 EndSection
91 </pre>
92
93 +<warn>
94 +Enabling <c>AGPFastWrite</c> on a VIA chipset will very likely cause your
95 +machine to lock up. VIA chipsets do not play nicely with fast writes, so use
96 +this setting at your own risk.
97 +</warn>
98 +
99 +<note>
100 +Remember, if you want fast writes to work properly, you will have to first
101 +enable the appropriate option in your BIOS.
102 +</note>
103 +
104 +<!--
105 +**
106 +This section needs to be in eventually, but non-nvidia cards don't use
107 +/proc/driver at all. We need some way to get users to check and see that SBA
108 +and fast-writes are allowed for their hardware; that info is somewhere else in
109 +/proc. If you have a non-nvidia card, you can help by emailing
110 +nightmorph@g.o with the relevant bits of your /proc so I can get this
111 +info into the guide. See below for where things are found on an nvidia card.
112 +**
113 +
114 +<p>
115 +A few options may increase performance by up to 30 percent (or more) over the
116 +default. Set them in <path>/etc/X11/xorg.conf</path>. However, you will first
117 +need to check that your motherboard and video card support these options.
118 +</p>
119 +
120 +<p>
121 +First, let's check the supported modes of your video cards, and see if your it
122 +supports fast writes. Remember to replace <c>nvidia</c> with the actual name of
123 +your device in <path>/proc/driver/nvidia/</path>.
124 +</p>
125 +
126 +<pre caption="Video card check">
127 +$ <i>cat /proc/driver/nvidia/agp/card</i>
128 +</pre>
129 +
130 +<p>
131 +Next, let's check out the capabilities of the motherboard:
132 +</p>
133 +
134 +<pre caption="Motherboard check">
135 +$ <i>cat /proc/driver/nvidia/agp/host-bridge</i>
136 +</pre>
137 +
138 +<impo>
139 +Remember, the modes and capabilities for your video card and motherboard must
140 +match for these settings to work!
141 +</impo>
142 +-->
143 +
144 <p>
145 If you want to set even more features, check out the <uri
146 link="http://dri.freedesktop.org/wiki/FeatureMatrix">feature matrix</uri> on
147
148
149
150 --
151 gentoo-doc-cvs@g.o mailing list