/[gentoo]/xml/htdocs/doc/en/nvidia-guide.xml
Gentoo

Diff of /xml/htdocs/doc/en/nvidia-guide.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.35 Revision 1.36
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/nvidia-guide.xml,v 1.35 2006/11/29 15:57:52 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/nvidia-guide.xml,v 1.36 2007/02/08 00:09:31 diox Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide link="/doc/en/nvidia-guide.xml"> 5<guide link="/doc/en/nvidia-guide.xml">
6<title>Gentoo Linux nVidia Guide</title> 6<title>Gentoo Linux nVidia Guide</title>
7 7
35<title>Introduction</title> 35<title>Introduction</title>
36<section> 36<section>
37<body> 37<body>
38 38
39<p> 39<p>
40nVidia release their own Linux drivers which provide good performance and full 40The nVidia drivers in the tree are released by nVidia and are built against the
413D acceleration. There are two drivers in Portage. <c>nvidia-drivers</c> is for 41Linux kernel. They contain a binary blob that does the heavy lifting for talking
42newer nVidia graphics cards, while <c>nvidia-legacy-drivers</c> supports older 42to the card. The drivers consist of two parts, a kernel module, and an X11
43cards. 43driver. Both parts are included in a single package. Due to the way nVidia has
44been packaging their drivers, you will need to make some choices before you
45install the drivers. Currently, there are two driver packages in the tree. The
46first, <c>nvidia-drivers</c>, is the latest drivers from nVidia and includes
47support for the latest cards. The second, <c>nvidia-legacy-drivers</c>, supports
48older cards, from the original TNT through the GeForce 6800. However, this
49driver does not support the latest features of the newer cards. You should only
50use <c>nvidia-legacy-driver</c> if your cards is not supported in the
51<c>nvidia-drivers</c> package.
44</p> 52</p>
45 53
46<note> 54<note>
47Previously, Gentoo provided separate ebuilds for the nVidia kernel module 55Previously, Gentoo provided separate ebuilds for the nVidia kernel module
48(<c>nvidia-kernel</c>) and the X11 GLX libraries (<c>nvidia-glx</c>). These 56(<c>nvidia-kernel</c>) and the X11 GLX libraries (<c>nvidia-glx</c>). These
55</body> 63</body>
56</section> 64</section>
57</chapter> 65</chapter>
58 66
59<chapter> 67<chapter>
68<title>Driver compatibility</title>
69<section>
70<title>nvidia-legacy-drivers</title>
71<body>
72
73<p>
74The <c>nvidia-legacy-driver</c> branch supports older nVidia cards which are no
75longer supported in the latest driver releases. This branch is based on an older
76code base of the nVidia drivers, and supports the latest kernels and X.Org
77versions. You should use this driver if you have a TNT, TNT2, GeForce, or
78GeForce 2 series card. The driver compatibility information can be found in
79Appendix A of
80<uri>http://download.nvidia.com/XFree86/Linux-x86/1.0-7184/README/readme.txt</uri>.
81</p>
82
83</body>
84</section>
85<section>
86<title>nvidia-drivers</title>
87<body>
88
89<p>
90The <c>nvidia-drivers</c> branch supports the features in newer nVidia cards.
91The latest version of these drivers has dropped support for the NV2x based
92cards. If you have a GeForce 3 or GeForce 4 series card, you should mask
93<c>>=x11-drivers/nvidia-drivers-1.0.9700</c> in your
94<path>/etc/portage/package.mask</path> file. This will prevent newer versions of
95the driver which are incompatible with your card from being installed. You can
96check for driver compatibility for your card at to determine if it is supported
97on the newer drivers at
98<uri>http://us.download.nvidia.com/XFree86/Linux-x86/1.0-9746/README/appendix-a.html</uri>.
99</p>
100
101</body>
102</section>
103</chapter>
104
105<chapter>
60<title>Configuring your Card</title> 106<title>Configuring your Card</title>
61<section> 107<section>
62<title>Kernel Configuration</title> 108<title>Kernel Configuration</title>
63<body> 109<body>
64 110
65<p> 111<p>
66As mentioned above, the nVidia kernel driver installs and runs against your 112As mentioned above, the nVidia kernel driver installs and runs against your
67current kernel. It builds as a module, so it makes sense that your kernel must 113current kernel. It builds as a module, so it makes sense that your kernel must
68support the loading of kernel modules. If you used <c>genkernel</c> to 114support the loading of kernel modules. If you used <c>genkernel all</c> to
69configure the kernel for you then you're all set. If not, double check your 115configure the kernel for you, then you're all set. If not, double check your
70kernel configuration so that this support is enabled: 116kernel configuration so that this support is enabled:
71</p> 117</p>
72 118
73<pre caption="Enabling the Loading of Kernel Modules"> 119<pre caption="Enabling the Loading of Kernel Modules">
74Loadable module support ---&gt; 120Loadable module support ---&gt;
97Device Drivers ---&gt; 143Device Drivers ---&gt;
98Character devices ---&gt; 144Character devices ---&gt;
99&lt;*&gt; /dev/agpgart (AGP Support) 145&lt;*&gt; /dev/agpgart (AGP Support)
100</pre> 146</pre>
101 147
148<note>
149On amd64, the IOMMU controls the agpgart setting.
150</note>
151
102</body> 152</body>
103</section> 153</section>
104<section> 154<section>
105<title>Arch-specific notes</title> 155<title>Arch-specific notes</title>
106<body> 156<body>
155<p> 205<p>
156The <c>nvidia-drivers</c> and <c>nvidia-legacy-drivers</c> ebuilds 206The <c>nvidia-drivers</c> and <c>nvidia-legacy-drivers</c> ebuilds
157automatically discover your kernel version based on the 207automatically discover your kernel version based on the
158<path>/usr/src/linux</path> symlink. Please ensure that you have this symlink 208<path>/usr/src/linux</path> symlink. Please ensure that you have this symlink
159pointing to the correct sources and that your kernel is correctly configured. 209pointing to the correct sources and that your kernel is correctly configured.
160Please refer to the Configuring the Kernel section of the <uri 210Please refer to the &quot;Configuring the Kernel&quot; section of the <uri
161link="/doc/en/handbook/">Installation Handbook</uri> for details on configuring 211link="/doc/en/handbook/">Installation Handbook</uri> for details on configuring
162your kernel. 212your kernel.
163</p> 213</p>
164 214
165<p> 215<p>
199<title>Optional: Check for Legacy Card Support</title> 249<title>Optional: Check for Legacy Card Support</title>
200<body> 250<body>
201 251
202<note> 252<note>
203Unfortunately, certain legacy video cards are not supported by the newer 253Unfortunately, certain legacy video cards are not supported by the newer
204versions of <c>nvidia-drivers</c>. nVidia provides a <uri 254versions of <c>nvidia-drivers</c>.
205link="http://www.nvidia.com/object/IO_18897.html">list of supported 255nVidia provides a <uri link="http://www.nvidia.com/object/IO_18897.html">list
206cards</uri>. Please check the list before installing the drivers. 256of supported cards</uri>. Please check the list before installing the drivers.
207</note> 257</note>
208 258
209<p> 259<p>
210The following is a list of <b>unsupported</b> legacy video cards: 260The following is a list of <b>unsupported</b> legacy video cards:
211</p> 261</p>
212 262
213<pre caption="Unsupported cards"> 263<pre caption="Unsupported cards">
264TNT
214TNT2 265TNT2
215TNT2 Pro 266TNT2 Pro
216TNT2 Ultra 267TNT2 Ultra
217TNT2 Model 64 (M64) 268TNT2 Model 64 (M64)
218TNT2 Model 64 (M64) Pro 269TNT2 Model 64 (M64) Pro

Legend:
Removed from v.1.35  
changed lines
  Added in v.1.36

  ViewVC Help
Powered by ViewVC 1.1.20