nightmorph 06/05/07 12:39:17 Modified: dri-howto.xml Log: 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 .
Revision Changes Path 1.29 xml/htdocs/doc/en/dri-howto.xml 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 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 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 Index: dri-howto.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v retrieving revision 1.28 retrieving revision 1.29 diff -u -r1.28 -r1.29 --- dri-howto.xml 1 Feb 2006 11:58:34 -0000 1.28 +++ dri-howto.xml 7 May 2006 12:39:17 -0000 1.29 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v 1.28 2006/02/01 11:58:34 neysx Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v 1.29 2006/05/07 12:39:17 nightmorph Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/dri-howto.xml"> @@ -20,8 +20,8 @@ <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> <license/> -<version>1.2</version> -<date>2006-02-01</date> +<version>1.3</version> +<date>2006-05-07</date> <chapter> <title>Introduction</title> @@ -92,8 +92,10 @@ <p> This guide is for people who can't get direct rendering working with just Xorg. X11-DRM works for 3dfx, gamma, i8x0, matrox, rage128, radeon, mach64 and sis300 -series drivers. See the <uri link="http://dri.freedesktop.org/";>DRI -homepage</uri> for more info and documentation. +series drivers. VIA card owners should not use <c>x11-drm</c>, but should +instead use the DRI provided in recent kernels (>2.6.13). See the <uri +link="http://dri.freedesktop.org/";>DRI homepage</uri> for more info and +documentation. </p> </body> @@ -271,6 +273,11 @@ intel-agp </pre> +<note> +If you compiled <c>agpgart</c> as a module, you will also need to add it to +<path>/etc/modules.autoload.d/kernel-2.6</path>. +</note> + </body> </section> </chapter> @@ -282,18 +289,18 @@ <body> <p> -Reboot your computer to your new kernel. It's time to see if you have direct -rendering and how good it is. +Reboot your computer to your new kernel and login as a normal user. It's time +to see if you have direct rendering and how good it is. </p> <pre caption="Testing rendering"> -# <i>startx</i> +$ <i>startx</i> <comment>(No need to load modules for your driver or agpgart, if you compiled agpgart as a module.)</comment> <comment>(They will be loaded automatically.)</comment> -# <i>glxinfo | grep rendering</i> +$ <i>glxinfo | grep rendering</i> direct rendering: Yes <comment>(If it says "No," you don't have 3D acceleration.)</comment> -# <i>glxgears</i> +$ <i>glxgears</i> <comment>(Test your frames per second (FPS) at the default size. The number should be )</comment> <comment>(significantly higher than before installing x11-drm. Do this while the CPU is as idle as possible.)</comment> </pre> @@ -452,6 +459,57 @@ EndSection </pre> +<warn> +Enabling <c>AGPFastWrite</c> on a VIA chipset will very likely cause your +machine to lock up. VIA chipsets do not play nicely with fast writes, so use +this setting at your own risk. +</warn> + +<note> +Remember, if you want fast writes to work properly, you will have to first +enable the appropriate option in your BIOS. +</note> + +<!-- +** +This section needs to be in eventually, but non-nvidia cards don't use +/proc/driver at all. We need some way to get users to check and see that SBA +and fast-writes are allowed for their hardware; that info is somewhere else in +/proc. If you have a non-nvidia card, you can help by emailing [EMAIL PROTECTED] with the relevant bits of your /proc so I can get this +info into the guide. See below for where things are found on an nvidia card. +** + +<p> +A few options may increase performance by up to 30 percent (or more) over the +default. Set them in <path>/etc/X11/xorg.conf</path>. However, you will first +need to check that your motherboard and video card support these options. +</p> + +<p> +First, let's check the supported modes of your video cards, and see if your it +supports fast writes. Remember to replace <c>nvidia</c> with the actual name of +your device in <path>/proc/driver/nvidia/</path>. +</p> + +<pre caption="Video card check"> +$ <i>cat /proc/driver/nvidia/agp/card</i> +</pre> + +<p> +Next, let's check out the capabilities of the motherboard: +</p> + +<pre caption="Motherboard check"> +$ <i>cat /proc/driver/nvidia/agp/host-bridge</i> +</pre> + +<impo> +Remember, the modes and capabilities for your video card and motherboard must +match for these settings to work! +</impo> +--> + <p> If you want to set even more features, check out the <uri link="http://dri.freedesktop.org/wiki/FeatureMatrix";>feature matrix</uri> on -- [email protected] mailing list
