|
Lines 11-22
Link Here
|
| 11 |
<author title="Editor"> |
11 |
<author title="Editor"> |
| 12 |
<mail link="curtis119@gentoo.org">M Curtis Napier</mail> |
12 |
<mail link="curtis119@gentoo.org">M Curtis Napier</mail> |
| 13 |
</author> |
13 |
</author> |
| 14 |
<author title="Editor"> |
14 |
<author title="Editor"> |
| 15 |
<mail link="nightmorph@gentoo.org">Joshua Saddler</mail> |
15 |
<mail link="nightmorph@gentoo.org">Joshua Saddler</mail> |
| 16 |
</author> |
16 |
</author> |
|
|
17 |
<author title="Editor"> |
| 18 |
<mail link="diox@swords.be">Dimitry Bradt</mail> |
| 19 |
</author> |
| 20 |
|
| 17 |
|
21 |
|
| 18 |
<abstract> |
22 |
<abstract> |
| 19 |
Many Gentooists have an nVidia chipset on their system. nVidia provides specific |
23 |
Many Gentooists have an nVidia chipset on their system. nVidia provides specific |
| 20 |
Linux drivers to boost the performance of your card. This guide informs you how |
24 |
Linux drivers to boost the performance of your card. This guide informs you how |
| 21 |
to install and configure these drivers. |
25 |
to install and configure these drivers. |
| 22 |
</abstract> |
26 |
</abstract> |
|
Lines 32-58
Link Here
|
| 32 |
<title>Introduction</title> |
36 |
<title>Introduction</title> |
| 33 |
<section> |
37 |
<section> |
| 34 |
<body> |
38 |
<body> |
| 35 |
|
39 |
|
| 36 |
<p> |
40 |
<p> |
| 37 |
nVidia release their own Linux drivers which provide good performance and full |
41 |
nVidia release their own Linux drivers which provide good performance and full |
| 38 |
3D acceleration. The driver releases are split up into two parts: |
42 |
3D acceleration. <c>nvidia-kernel</c> and <c>nvidia-glx</c> have recently been |
| 39 |
<c>nvidia-kernel</c> and <c>nvidia-glx</c>. |
43 |
merged to match the needs of <c>xorg-server</c>. |
| 40 |
</p> |
|
|
| 41 |
|
| 42 |
<p> |
| 43 |
<c>nvidia-kernel</c> is a kernel driver which handles the low-level |
| 44 |
communication with your video hardware. This is simply a kernel module, named |
| 45 |
<c>nvidia</c>, which installs against your kernel sources and needs to be loaded |
| 46 |
whenever you want to use the nvidia drivers. |
| 47 |
</p> |
| 48 |
|
| 49 |
<p> |
| 50 |
As well as the kernel driver, you need to install the X11 GLX layer |
| 51 |
(<c>nvidia-glx</c>). This is used by X to render graphics, which internally |
| 52 |
uses the <c>nvidia-kernel</c> kernel driver to interface with the hardware. |
| 53 |
</p> |
44 |
</p> |
| 54 |
|
45 |
|
| 55 |
</body> |
46 |
</body> |
| 56 |
</section> |
47 |
</section> |
| 57 |
</chapter> |
48 |
</chapter> |
| 58 |
|
49 |
|
|
Lines 60-76
Link Here
|
| 60 |
<title>Configuring your Card</title> |
51 |
<title>Configuring your Card</title> |
| 61 |
<section> |
52 |
<section> |
| 62 |
<title>Kernel Configuration</title> |
53 |
<title>Kernel Configuration</title> |
| 63 |
<body> |
54 |
<body> |
| 64 |
|
55 |
|
| 65 |
<p> |
56 |
<p> |
| 66 |
As mentioned above, the nVidia kernel driver installs and runs against your |
57 |
The nVidia driver installs and runs against your current kernel. It builds as a |
| 67 |
current kernel. It builds as a module, so it makes sense that your kernel must |
58 |
module, so it makes sense that your kernel must support the loading of kernel |
| 68 |
support the loading of kernel modules. If you used <c>genkernel</c> to configure |
59 |
modules. If you used <c>genkernel</c> to configure the kernel for you then |
| 69 |
the kernel for you then you're all set. If not, double check your kernel |
60 |
you're all set. If not, double check your kernel configuration so that this |
| 70 |
configuration so that this support is enabled: |
61 |
support is enabled: |
| 71 |
</p> |
62 |
</p> |
| 72 |
|
63 |
|
| 73 |
<pre caption="Enabling the Loading of Kernel Modules"> |
64 |
<pre caption="Enabling the Loading of Kernel Modules"> |
| 74 |
Loadable module support ---> |
65 |
Loadable module support ---> |
| 75 |
[*] Enable loadable module support |
66 |
[*] Enable loadable module support |
| 76 |
</pre> |
67 |
</pre> |
|
Lines 145-159
Link Here
|
| 145 |
</section> |
136 |
</section> |
| 146 |
<section> |
137 |
<section> |
| 147 |
<title>Continuing with Kernel Configuration</title> |
138 |
<title>Continuing with Kernel Configuration</title> |
| 148 |
<body> |
139 |
<body> |
| 149 |
|
140 |
|
| 150 |
<p> |
141 |
<p> |
| 151 |
nVidia's modules and libraries are combined in two packages: <c>nvidia-glx</c> |
142 |
nVidia's modules and libraries are now combined in one packages: |
| 152 |
and <c>nvidia-kernel</c>. The former are the X11 GLX libraries while the latter |
143 |
<c>nvidia-drivers</c>. It contains the X11 GLX libraries while and the kernel |
| 153 |
are the kernel modules. |
144 |
modules. |
| 154 |
</p> |
145 |
</p> |
| 155 |
|
146 |
|
| 156 |
<p> |
147 |
<p> |
| 157 |
The nvidia-kernel ebuild auto discovers your kernel version based on the |
148 |
The nvidia-kernel ebuild auto discovers your kernel version based on the |
| 158 |
<path>/usr/src/linux</path> symlink. Please ensure that you have this symlink |
149 |
<path>/usr/src/linux</path> symlink. Please ensure that you have this symlink |
| 159 |
pointing to the correct sources and that your kernel is correctly configured. |
150 |
pointing to the correct sources and that your kernel is correctly configured. |
|
Lines 198-210
Link Here
|
| 198 |
<section> |
189 |
<section> |
| 199 |
<title>Optional: Check for Legacy Card Support</title> |
190 |
<title>Optional: Check for Legacy Card Support</title> |
| 200 |
<body> |
191 |
<body> |
| 201 |
|
192 |
|
| 202 |
<note> |
193 |
<note> |
| 203 |
Unfortunately, certain legacy video cards are not supported by the newer |
194 |
Unfortunately, certain legacy video cards are not supported by the newer |
| 204 |
versions of <c>nvidia-glx</c> and <c>nvidia-kernel</c>. nVidia provides a <uri |
195 |
versions of <c>nvidia-drivers</c>. nVidia provides a <uri |
| 205 |
link="http://www.nvidia.com/object/IO_18897.html">list of supported cards</uri>. |
196 |
link="http://www.nvidia.com/object/IO_18897.html">list of supported cards</uri>. |
| 206 |
Please check the list before installing the drivers. |
197 |
Please check the list before installing the drivers. |
| 207 |
</note> |
198 |
</note> |
| 208 |
|
199 |
|
| 209 |
<p> |
200 |
<p> |
| 210 |
The following is a list of <b>unsupported</b> legacy video cards: |
201 |
The following is a list of <b>unsupported</b> legacy video cards: |
|
Lines 227-270
Link Here
|
| 227 |
GeForce2 MX Integrated graphics |
218 |
GeForce2 MX Integrated graphics |
| 228 |
Quadro |
219 |
Quadro |
| 229 |
Quadro2 Pro |
220 |
Quadro2 Pro |
| 230 |
Quadro2 EX |
221 |
Quadro2 EX |
| 231 |
</pre> |
222 |
</pre> |
| 232 |
|
223 |
|
| 233 |
<p> |
|
|
| 234 |
If you own one of these cards, you will have to mask the newer versions of the |
| 235 |
nVidia drivers, and install an older version: |
| 236 |
</p> |
| 237 |
|
| 238 |
<pre caption="Masking newer drivers"> |
| 239 |
# <i>echo ">media-video/nvidia-kernel-1.0.6629-r5" >> /etc/portage/package.mask</i> |
| 240 |
# <i>echo ">media-video/nvidia-glx-1.0.6629-r7" >> /etc/portage/package.mask</i> |
| 241 |
</pre> |
| 242 |
|
| 243 |
</body> |
224 |
</body> |
| 244 |
</section> |
225 |
</section> |
| 245 |
<section> |
226 |
<section> |
| 246 |
<title>Installing the Appropriate Drivers</title> |
227 |
<title>Installing the Appropriate Drivers</title> |
| 247 |
<body> |
228 |
<body> |
| 248 |
|
229 |
|
| 249 |
<p> |
230 |
<p> |
| 250 |
Now it's time to install <c>nvidia-kernel</c> and <c>nvidia-glx</c>. Since |
231 |
Now it's time to install <c>nvidia-drivers</c>. |
| 251 |
<c>nvidia-glx</c> depends on <c>nvidia-kernel</c>, installing <c>nvidia-glx</c> |
|
|
| 252 |
is sufficient. |
| 253 |
</p> |
232 |
</p> |
| 254 |
|
233 |
|
| 255 |
<pre caption="Installing the nVidia modules"> |
234 |
<pre caption="Installing the nVidia modules"> |
| 256 |
# <i>emerge nvidia-glx</i> |
235 |
# <i>emerge nvidia-drivers</i> |
| 257 |
</pre> |
236 |
</pre> |
| 258 |
|
237 |
|
| 259 |
<impo> |
238 |
<impo> |
| 260 |
Every time you <uri link="/doc/en/kernel-upgrade.xml">compile a new |
239 |
Every time you <uri link="/doc/en/kernel-upgrade.xml">compile a new |
| 261 |
kernel</uri> or recompile the current one, you have to run <c>emerge |
240 |
kernel</uri> or recompile the current one, you have to run <c>emerge |
| 262 |
nvidia-kernel</c> to reinstall the nVidia modules. <c>nvidia-glx</c> is |
241 |
nvidia-drivers</c> to reinstall the nVidia modules. |
| 263 |
unaffected by a kernel change and doesn't even need to be rebuilt when you |
|
|
| 264 |
recompile/upgrade X. |
| 265 |
</impo> |
242 |
</impo> |
| 266 |
|
243 |
|
| 267 |
<p> |
244 |
<p> |
| 268 |
Once the installation has finished, run <c>modprobe nvidia</c> to load the |
245 |
Once the installation has finished, run <c>modprobe nvidia</c> to load the |
| 269 |
kernel module into memory. |
246 |
kernel module into memory. |
| 270 |
</p> |
247 |
</p> |
|
Lines 523-541
Link Here
|
| 523 |
|
500 |
|
| 524 |
<p> |
501 |
<p> |
| 525 |
This will preserve your <path>/dev/nvidia*</path> nodes even if you reboot. |
502 |
This will preserve your <path>/dev/nvidia*</path> nodes even if you reboot. |
| 526 |
</p> |
503 |
</p> |
| 527 |
|
504 |
|
| 528 |
<note> |
505 |
<note> |
| 529 |
Alternatively, you might try emerging the latest <c>nvidia-kernel</c> and |
506 |
Alternatively, you might try emerging the latest <c>nvidia-drivers</c> from the |
| 530 |
<c>nvidia-glx</c> from the 8xxx series. At the time of this writing, both are |
507 |
8xxx series. At the time of this writing, both are still marked ~arch. These |
| 531 |
still marked ~arch. These drivers no longer rely on hotplug or udev to create |
508 |
drivers no longer rely on hotplug or udev to create the proper device nodes, so |
| 532 |
the proper device nodes, so you won't need to run <c>NVmakedevices.sh</c>. |
509 |
you won't need to run <c>NVmakedevices.sh</c>. Instead, the X driver itself |
| 533 |
Instead, the X driver itself will create your <path>/dev/nvidia*</path> files |
510 |
will create your <path>/dev/nvidia*</path> files when you start X. However, |
| 534 |
when you start X. However, this will require you to use a recent kernel (2.6.14 |
511 |
this will require you to use a recent kernel (2.6.14 and greater). |
| 535 |
and greater). |
|
|
| 536 |
</note> |
512 |
</note> |
| 537 |
|
513 |
|
| 538 |
</body> |
514 |
</body> |
| 539 |
</section> |
515 |
</section> |
| 540 |
</chapter> |
516 |
</chapter> |
| 541 |
|
517 |
|
|
Lines 549-561
Link Here
|
| 549 |
The nVidia driver package also comes with comprehensive documentation. This is |
525 |
The nVidia driver package also comes with comprehensive documentation. This is |
| 550 |
installed into <c>/usr/share/doc</c> and can be viewed with the following |
526 |
installed into <c>/usr/share/doc</c> and can be viewed with the following |
| 551 |
command: |
527 |
command: |
| 552 |
</p> |
528 |
</p> |
| 553 |
|
529 |
|
| 554 |
<pre caption="Viewing the NVIDIA documentation"> |
530 |
<pre caption="Viewing the NVIDIA documentation"> |
| 555 |
# <i>less /usr/share/doc/nvidia-glx-*/README.txt.gz</i> |
531 |
# <i>less /usr/share/doc/nvidia-drivers-*/README.txt.gz</i> |
| 556 |
</pre> |
532 |
</pre> |
| 557 |
|
533 |
|
| 558 |
</body> |
534 |
</body> |
| 559 |
</section> |
535 |
</section> |
| 560 |
<section> |
536 |
<section> |
| 561 |
<title>Kernel module parameters</title> |
537 |
<title>Kernel module parameters</title> |
