The nVidia drivers in the tree are released by nVidia and are built against the Linux kernel. They contain a binary blob that does the heavy lifting for talking to the card. The drivers consist of two parts, a kernel module, and an X11 driver. Both parts are included in a single package. Due to the way nVidia has been packaging their drivers, you will need to make some choices before you install the drivers.
The nvidia-drivers package contains the latest drivers from nVidia with support for all cards, with several versions available depending on how old your card is. It uses an eclass to detect what kind of card you're running so that it installs the proper version.
The nvidia-drivers package supports the full range of available nVidia cards. Multiple versions are available for installation, depending on the card(s) you have.
Newer cards such as the GeForce 9, 8, 7, and 6 series should use the latest drivers.
Older cards such as the GeForce FX 5 series should use the 173.x drivers, such as nvidia-drivers-173.14.15. For these cards, you should mask >=x11-drivers/nvidia-drivers-174.00 in your /etc/portage/package.mask file. This will prevent newer versions of the driver which are incompatible with your card from being installed.
Old cards such as the GeForce 3 or GeForce 4 series require the 96.x drivers. For these cards, you should mask >=x11-drivers/nvidia-drivers-97.00 in your /etc/portage/package.mask file.
The oldest NV2x-based cards (such as TNT, TNT2, GeForce, and GeForce 2) require the 71.x drivers (such as nvidia-drivers-71.86.01). For these cards, you should mask >=x11-drivers/nvidia-drivers-87.00 in /etc/portage/package.mask.
You can check for driver compatibility for your card at to determine which driver supports it by viewing the README at its appropriate x86 or x86-64 release page.
As mentioned above, the nVidia kernel driver installs and runs against your current kernel. It builds as a module, so it makes sense that your kernel must support the loading of kernel modules. If you used genkernel all to configure the kernel for you, then you're all set. If not, double check your kernel configuration so that this support is enabled:
Code Listing 3.1: Enabling the Loading of Kernel Modules |
Loadable module support ---> [*] Enable loadable module support |
You also need to enable Memory Type Range Register in your kernel:
Code Listing 3.2: Enabling MTRR |
Processor and Features ---> [*] MTRR (Memory Type Range Register) support |
Also, if you have an AGP graphics card, you can optionally enable agpgart support to your kernel, either compiled in or as a module. If you do not use the in-kernel agpgart, then the drivers will use their own agpgart implementation, called NvAGP. On certain systems, this performs better than the in-kernel agpgart, and on others, it performs worse. You will need to evaluate this on your own system to get the best performance. If you are unsure what to do, use the in-kernel agpgart:
Code Listing 3.3: Enabling agpgart |
Device Drivers ---> Graphics Support ---> -*- /dev/agpgart (AGP Support) ---> |
Note: On amd64, the IOMMU controls the agpgart setting. |
Important: For x86 and AMD64 processors, the in-kernel driver conflicts with the binary driver provided by nVidia. If you will be compiling your kernel for these CPUs, you must completely remove support for the in-kernel driver as shown: |
Code Listing 3.4: Remove the in-kernel driver |
Device Drivers ---> Graphics Support ---> <*> Support for frame buffer devices ---> < > nVidia Framebuffer Support < > nVidia Riva support |
A framebuffer alternative is uvesafb, an advanced framebuffer. Note that you can choose to compile it into your kernel, or as a module. The following example compiles uvesafb into the kernel.
Code Listing 3.5: Enable uvesafb support |
Device Drivers ---> Graphics Support ---> <*> Support for frame buffer devices ---> <*> Userspace VESA VGA graphics support |
Or you can try VESA:
Code Listing 3.6: Enable VESA support |
Device Drivers ---> Graphics Support ---> <*> Support for frame buffer devices ---> [*] VESA VGA graphics support |
For more information, you can look up the documentation for your chosen framebuffer in /usr/src/linux/Documentation/fb/.
Continuing with Kernel Configuration
The nvidia-drivers ebuild automatically discovers your kernel version based on the /usr/src/linux symlink. Please ensure that you have this symlink pointing to the correct sources and that your kernel is correctly configured. Please refer to the "Configuring the Kernel" section of the Installation Handbook for details on configuring your kernel.
First, you'll need to emerge eselect (if you don't already have it). If you are using gentoo-sources-2.6.18-r4, your kernel listing might look something like this:
Code Listing 3.7: Check your /usr/src/linux symlink |
# eselect kernel list Available kernel symlink targets: [1] linux-2.6.18-gentoo-r4 * [2] linux-2.6.20-gentoo-r7 [3] linux-2.6.20-gentoo-r8 (Verify that the right kernel is marked with an asterisk |
In the above output, you'll notice that the linux-2.6.18-gentoo-r4 kernel is marked with an asterisk (*) to show that it is the symlinked kernel.
If the symlink is not pointing to the correct sources, you must update the link by selecting the number of your desired kernel sources, as in the example above.
Code Listing 3.8: Create/Update /usr/src/linux symlink |
(Select the correct kernel) # eselect kernel set 1 |
Installing the Appropriate Drivers
Now it's time to install the drivers.
Code Listing 3.9: Installing the nVidia drivers |
# emerge nvidia-drivers
|
Note: The drivers can be installed with the gtk USE flag set. This will install media-video/nvidia-settings, a handy graphical tool for monitoring and configuring several aspects of your nVidia card. |
Important: Every time you compile a new kernel or recompile the current one, you will need to run emerge nvidia-drivers to reinstall the nVidia modules. An easier way to keep track of modules installed by ebuilds (such as nvidia-drivers) is to install sys-kernel/module-rebuild. Once you've installed it, simply run module-rebuild populate to populate its database with a list of packages to be rebuilt. Once you've finished compiling or recompiling a kernel, just run module-rebuild rebuild to rebuild the drivers for your new kernel. |
Once the installation has finished, run modprobe nvidia to load the kernel module into memory. If this is an upgrade, you should remove the previous module first.
Code Listing 3.10: Loading the kernel module |
# lsmod | grep nvidia && rmmod nvidia # modprobe nvidia |
To prevent you having to manually load the module on every bootup, you probably want to have this done automatically each time you boot your system, so edit /etc/modules.autoload.d/kernel-2.6 and add nvidia to it. Don't forget to run update-modules afterwards.
Important: If you compiled agpgart as a module, you will need to add it to /etc/modules.autoload.d/kernel-2.6. |
Code Listing 3.11: Running update-modules |
# update-modules
|
Once the appropriate drivers are installed you need to configure your X Server to use the nvidia driver instead of the default nv driver.
Open /etc/X11/xorg.conf with your favorite editor (such as nano or vim) and go to the Device section. In that section, change the Driver line:
Code Listing 3.12: Changing nv to nvidia in the X Server configuration |
Section "Device"
Identifier "nVidia Inc. GeForce2"
Driver "nvidia"
VideoRam 65536
EndSection
|
Then go to the Module section and make sure the glx module gets loaded while the dri module doesn't:
Code Listing 3.13: Updating the Module section |
Section "Module" (...) # Load "dri" Load "glx" (...) EndSection |
Next, in section Screen, make sure that either the DefaultDepth directive is set to 16 or 24, or that you only have Display subsections with Depth settings of 16 or 24. Without it, the nVidia GLX extensions will not start.
Code Listing 3.14: Updating the Screen section |
Section "Screen" (...) DefaultDepth 16 Subsection "Display" (...) EndSection |
Run eselect so that the X Server uses the nVidia GLX libraries:
Code Listing 3.15: Running eselect |
# eselect opengl set nvidia
|
Adding your Users to the video Group
You have to add your user to the video group so he has access to the nVidia device files:
Code Listing 3.16: Adding your user to the video group |
# gpasswd -a youruser video
|
This might not be totally necessary if you aren't using udev but it doesn't hurt either and makes your system future-proof.
To test your nVidia card, fire up X and run glxinfo, which is part of the mesa-progs package. It should say that direct rendering is activated:
Code Listing 3.17: Checking the direct rendering status |
$ glxinfo | grep direct
direct rendering: Yes
|
To monitor your FPS, run glxgears.
Some tools, such as mplayer and xine-lib, use a local USE flag called xvmc which enables XvMCNVIDIA support, useful when watching high resolution movies. Add in xvmc in your USE variable in /etc/make.conf or add it as USE flag to media-video/mplayer and/or media-libs/xine-lib in /etc/portage/package.use.
There are also some applications that use the nvidia USE flag, so you may want to add it to /etc/make.conf.
Then, run emerge -uD --newuse world to rebuild the applications that benefit from the USE flag change.
nVidia also provides you with a settings tool. This tool allows you to monitor and change graphical settings without restarting the X server and is available through Portage as media-video/nvidia-settings. As mentioned earlier, it will be pulled in automatically if you install the drivers with the gtk USE flag set in /etc/make.conf or in /etc/portage/package.use.
Getting 2D to work on machines with 4Gb or more memory
If you are having troubles with the nVidia 2D acceleration it is likely that you are unable to set up a write-combining range with MTRR. To verify, check the contents of /proc/mtrr:
Code Listing 4.1: Checking if you have write-combining enabled |
# cat /proc/mtrr
|
Every line should contain "write-back" or "write-combining". If you see a line with "uncachable" in it you will need to change a BIOS setting to fix this.
Reboot and enter the BIOS, then find the MTRR settings (probably under "CPU Settings"). Change the setting from "continuous" to "discrete" and boot back into Linux. You will now find out that there is no "uncachable" entry anymore and 2D acceleration now works without any glitches.
When I attempt to load the kernel module I receive a "no such device"
This usually occurs when you don't have a matching video card. Make sure that you have an nVidia-powered graphical card (you can double-check this using lspci).
If you are confident that you have an nVidia card, check your BIOS and see if the directive Assign IRQ to VGA is set.
The nVidia driver package also comes with comprehensive documentation. This is installed into /usr/share/doc and can be viewed with the following command:
Code Listing 5.1: Viewing the NVIDIA documentation |
$ less /usr/share/doc/nvidia-drivers-*/README.gz
|
The nvidia kernel module accepts a number of parameters (options) which you can use to tweak the behaviour of the driver. Most of these are mentioned in the documentation. To add or change the values of these parameters, edit the file /etc/modprobe.d/nvidia.conf. Remember to run update-modules after modifying this file, and bear in mind that you will need to reload the nvidia module before the new settings take effect.
Code Listing 5.2: Adjusting nvidia options |
(Edit /etc/modprobe.d/nvidia.conf in your favourite editor) # nano -w /etc/modprobe.d/nvidia.conf (Update module information) # update-modules (Unload the nvidia module...) # modprobe -r nvidia (...and load it once again) # modprobe nvidia |
The GLX layer also has a plethora of options which can be configured. These control the configuration of TV out, dual displays, monitor frequency detection, etc. Again, all of the available options are detailed in the documentation.
If you wish to use any of these options, you need to list them in the relevant Device section of your X config file (usually /etc/X11/xorg.conf). For example, suppose I wanted to disable the splash logo:
Code Listing 5.3: Advanced nvidia configuration in the X configuration |
Section "Device"
Identifier "nVidia Inc. GeForce2"
Driver "nvidia"
Option "NoLogo" "true"
VideoRam 65536
EndSection
|
The contents of this document are licensed under the Creative Commons - Attribution / Share Alike license.