/[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.13 Revision 1.14
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.13 2005/06/04 11:01:24 neysx Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/nvidia-guide.xml,v 1.14 2005/06/04 16:57:03 neysx 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
18to install and configure these drivers. 18to install and configure these drivers.
19</abstract> 19</abstract>
20 20
21<license/> 21<license/>
22 22
23<version>1.10</version> 23<version>1.11</version>
24<date>2005-06-04</date> 24<date>2005-06-04</date>
25
26<chapter>
27<title>Introduction</title>
28<section>
29<body>
30
31<p>
32nVidia release their own Linux drivers which provide good performance and full
333D acceleration. The driver releases are split up into two parts:
34<c>nvidia-kernel</c> and <c>nvidia-glx</c>.
35</p>
36
37<p>
38<c>nvidia-kernel</c> is a kernel driver which handles the low-level
39communication with your video hardware. This is simply a kernel module, named
40<c>nvidia</c>, which installs against your kernel sources and needs to be loaded
41whenever you want to use the nvidia drivers.
42</p>
43
44<p>
45As well as the kernel driver, you need to install the X11 GLX layer
46(<c>nvidia-glx</c>). This is used by X to render graphics, which internally
47uses the <c>nvidia-kernel</c> kernel driver to interface with the hardware.
48</p>
49
50</body>
51</section>
52</chapter>
25 53
26<chapter> 54<chapter>
27<title>Configuring your Card</title> 55<title>Configuring your Card</title>
28<section> 56<section>
29<title>Installing the Appropriate Drivers</title> 57<title>Installing the Appropriate Drivers</title>
30<body> 58<body>
31 59
32<p> 60<p>
33The nVidia drivers include kernel modules that must integrate in your current 61As mentioned above, the nVidia kernel driver installs and runs against your
34kernel. To accomplish this, your kernel must support the loading of kernel 62current kernel. It builds as a module, so it makes sense that your kernel must
35modules. If you used <c>genkernel</c> to configure the kernel for you then 63support the loading of kernel modules. If you used <c>genkernel</c> to configure
36you're all set. If not, double check your kernel configuration so that this 64the kernel for you then you're all set. If not, double check your kernel
37support is enabled: 65configuration so that this support is enabled:
38</p> 66</p>
39 67
40<pre caption="Enabling the Loading of Kernel Modules"> 68<pre caption="Enabling the Loading of Kernel Modules">
41Loadable module support ---&gt; 69Loadable module support ---&gt;
42 [*] Enable loadable module support 70 [*] Enable loadable module support
65link="/doc/en/handbook/">Installation Handbook</uri> for details on configuring 93link="/doc/en/handbook/">Installation Handbook</uri> for details on configuring
66your kernel. 94your kernel.
67</p> 95</p>
68 96
69<p> 97<p>
70If you are using gentoo-sources-2.6.11-r6, your symlink should look like this: 98If you are using gentoo-sources-2.6.11-r6, your /usr/src directory might look
99something like this:
71</p> 100</p>
72 101
73<pre caption="Check your /usr/src/linux symlink"> 102<pre caption="Check your /usr/src/linux symlink">
74# <i>cd /usr/src</i> 103# <i>cd /usr/src</i>
75# <i>ls -l</i> 104# <i>ls -l</i>
76<comment>(Check that linux point to the right directory)</comment> 105<comment>(Check that linux points to the right directory)</comment>
77lrwxrwxrwx 1 root root 22 Apr 23 18:33 linux -&gt; linux-2.6.11-gentoo-r6 106lrwxrwxrwx 1 root root 22 Apr 23 18:33 linux -&gt; linux-2.6.11-gentoo-r6
78drwxr-xr-x 4 root root 120 Apr 8 18:56 linux-2.4.26-gentoo-r4 107drwxr-xr-x 4 root root 120 Apr 8 18:56 linux-2.4.26-gentoo-r4
79drwxr-xr-x 18 root root 664 Dec 31 16:09 linux-2.6.10 108drwxr-xr-x 18 root root 664 Dec 31 16:09 linux-2.6.10
80drwxr-xr-x 18 root root 632 Mar 3 12:27 linux-2.6.11 109drwxr-xr-x 18 root root 632 Mar 3 12:27 linux-2.6.11
81drwxr-xr-x 19 root root 4096 Mar 16 22:00 linux-2.6.11-gentoo-r6 110drwxr-xr-x 19 root root 4096 Mar 16 22:00 linux-2.6.11-gentoo-r6
82</pre> 111</pre>
83 112
84<p> 113<p>
114In the above output, you'll notice that the <c>linux</c> symlink is pointing
115to the <c>linux-2.6.11-gentoo-r6</c> kernel.
116</p>
117
118<p>
85If the symlink is not pointing to the correct sources, you may create the link 119If the symlink is not pointing to the correct sources, you must update the link
86like this: 120like this:
87</p> 121</p>
88 122
89<pre caption="Create /usr/src/linux symlink"> 123<pre caption="Create/Update /usr/src/linux symlink">
90# <i>cd /usr/src</i> 124# <i>cd /usr/src</i>
91# <i>ln -snf linux-2.6.11-gentoo-r6 linux</i> 125# <i>ln -snf linux-2.6.11-gentoo-r6 linux</i>
92</pre> 126</pre>
93 127
94<p> 128<p>
103 137
104<impo> 138<impo>
105Every time you <uri link="/doc/en/kernel-upgrade.xml">compile a new 139Every time you <uri link="/doc/en/kernel-upgrade.xml">compile a new
106kernel</uri> or recompile the current one, you have to run <c>emerge 140kernel</uri> or recompile the current one, you have to run <c>emerge
107nvidia-kernel</c> to reinstall the nVidia modules. nvidia-glx is unaffected by 141nvidia-kernel</c> to reinstall the nVidia modules. nvidia-glx is unaffected by
108a kernel change. 142a kernel change and doesn't even need to be rebuilt when you recompile/upgrade
143X.
109</impo> 144</impo>
110 145
111<p> 146<p>
112Once the installation has finished, run <c>modprobe nvidia</c> to load the 147Once the installation has finished, run <c>modprobe nvidia</c> to load the
113kernel module into memory. 148kernel module into memory.
116<pre caption="Loading the kernel module"> 151<pre caption="Loading the kernel module">
117# <i>modprobe nvidia</i> 152# <i>modprobe nvidia</i>
118</pre> 153</pre>
119 154
120<p> 155<p>
156To prevent you having to manually load the module on every bootup, you probably
121You probably want to have this done each time you boot your system, so edit 157want to have this done automatically each time you boot your system, so edit
122<path>/etc/modules.autoload.d/kernel-2.6</path> (or <path>kernel-2.4</path>) and 158<path>/etc/modules.autoload.d/kernel-2.6</path> (or <path>kernel-2.4</path>,
159depending on which kernel version you use) and add <c>nvidia</c> to it. Don't
123add <c>nvidia</c> to it. Don't forget to run <c>modules-update</c> afterwards. 160forget to run <c>modules-update</c> afterwards.
124</p> 161</p>
125 162
126<pre caption="Running modules-update"> 163<pre caption="Running modules-update">
127# <i>modules-update</i> 164# <i>modules-update</i>
128</pre> 165</pre>
138(XFree86 or Xorg) to use the <c>nvidia</c> driver instead of the default 175(XFree86 or Xorg) to use the <c>nvidia</c> driver instead of the default
139<c>nv</c> driver. 176<c>nv</c> driver.
140</p> 177</p>
141 178
142<p> 179<p>
143Open <path>/etc/X11/XF86Config</path> (or <path>/etc/X11/xorg.conf</path>) with 180Open <path>/etc/X11/xorg.conf</path> (or <path>/etc/X11/XF86Config</path> if you
144your favorite editor (such as <c>nano</c> or <c>vim</c>) and go to the 181still use the older configuration file location) with your favorite editor
145<c>Device</c> section. In that section, change the <c>Driver</c> line: 182(such as <c>nano</c> or <c>vim</c>) and go to the <c>Device</c> section. In that
183section, change the <c>Driver</c> line:
146</p> 184</p>
147 185
148<pre caption="Changing nv to nvidia in the X Server configuration"> 186<pre caption="Changing nv to nvidia in the X Server configuration">
149Section "Device" 187Section "Device"
150 Identifier "nVidia Inc. GeForce2" 188 Identifier "nVidia Inc. GeForce2"
298 336
299</body> 337</body>
300</section> 338</section>
301</chapter> 339</chapter>
302 340
341<chapter>
342<title>Expert Configuration</title>
343<section>
344<title>Documentation</title>
345<body>
346
347<p>
348The nVidia driver package also comes with comprehensive documentation. This is
349installed into <c>/usr/share/doc</c> and can be viewed with the following
350command:
351</p>
352
353<pre caption="Viewing the NVIDIA documentation">
354# <i>less /usr/share/doc/nvidia-glx-*/README.txt.gz</i>
355</pre>
356
357</body>
358</section>
359<section>
360<title>Kernel module parameters</title>
361<body>
362
363<p>
364The <c>nvidia</c> kernel module accepts a number of parameters (options) which
365you can use to tweak the behaviour of the driver. Most of these are mentioned in
366the documentation. To add or change the values of these parameters, edit the
367file <c>/etc/modules.d/nvidia</c>. Remember to run <c>modules-update</c> after
368modifying this file, and bear in mind that you will need to reload the
369<c>nvidia</c> module before the new settings take effect.
370</p>
371
372</body>
373</section>
374<section>
375<title>Advanced X configuration</title>
376<body>
377
378<p>
379The GLX layer also has a plethora of options which can be configured. These
380control the configuration of TV out, dual displays, monitor frequency detection,
381etc. Again, all of the available options are detailed in the documentation.
382</p>
383
384<p>
385If you wish to use any of these options, you need to list them in the relevant
386Device section of your X config file (usually <c>/etc/X11/xorg.conf</c>). For
387example, suppose I wanted to disable the splash logo:
388</p>
389
390<pre caption="Advanced nvidia configuration in the X configuration">
391Section "Device"
392 Identifier "nVidia Inc. GeForce2"
393 Driver "nvidia"
394 <i>Option "NoLogo" "true"</i>
395 VideoRam 65536
396EndSection
397</pre>
398
399</body>
400</section>
401</chapter>
402
303</guide> 403</guide>

Legend:
Removed from v.1.13  
changed lines
  Added in v.1.14

  ViewVC Help
Powered by ViewVC 1.1.20