1
nvidia-graphics-drivers for Debian
2
----------------------------------
6
-----------------------------------------------------------------------
8
Welcome to Debian NVIDIA packages. This document contains notes on the
9
kernel module interface for the NVIDIA driver offering.
12
KERNEL MODULE INSTRUCTIONS:
13
-----------------------------------------------------------------------
15
There are TWO ways to build the nvidia-kernel package. Which one depends on
16
your situation with your kernel.
18
METHOD #1: You are running a Debian suppiled kernel or built a
19
linux-headers package along with your own self-built kernel.
21
METHOD #2: You are running your own self-built kernel built from kernel
24
*** An additional method is to use module-assistant
25
(e.g. module-assistant auto-install nvidia)
26
For more information on module-assistant, see it's man page and package
29
Which method you choose really depends on what kernel headers you wish to
30
use, those from a kernel-headers package or those from kernel
31
source (from which you built your own kernel).
33
As mentioned above, if you are running a Debian supplied kernel you will
34
probably want to choose METHOD #1. If you compile your own kernels, METHOD #2.
39
- Decide where you want to build your module. By default it
40
will build under /usr/src like other kernel modules but you may choose
41
to build it under your home directory as some people prefer and writing to
42
/usr violates the FHS.
45
SUPPORT FOR 2.6 KERNELS:
46
------------------------
47
As of 1.0.5336-1, NVIDIA includes support for a 2.6 kernel. No extra steps are
52
------------------------
53
As of version 1.0.5336-8 there is hotplug/udev module loading support provided.
56
METHOD #1 Using a linux-headers or kernel-headers package
57
***********************************************************************
59
As root (or using fakeroot)
61
tar xjvf nvidia-kernel.tar.bz2 -C <YOUR BUILD LOCATION>
62
(It will install in <YOU BUILD LOCATION>/modules)
64
tar xjvf nvidia-kernel.tar.bz2 (if building in /usr/src)
66
The standard build location is /usr/src
68
2. Find out your kernel version:
70
uname -r For example: 2.6.14-2-k7
72
3. Download and install package: linux-headers-2.6.14-2-k7
73
It will install in /usr/src/
74
Note that packages prior to 2.6.12 used the kernel- prefix rather than
77
Make sure your kernel image and headers have matching release numbers to
78
avoid possible problems in packages built from different sources.
80
4. Set some environment variables (if bash is your shell):
82
export KSRC=/usr/src/linux-headers-2.6.14-2-k7
83
export KVERS=2.6.14-2-k7
85
5. Then build nvidia-kernel package:
87
cd <YOUR BUILD LOCATION>/modules/nvidia-kernel
88
debian/rules binary_modules
90
(You can also combine step 4 and 5 into one line:
91
KSRC=/usr/src/linux-headers-2.6.14-k7 KVERS=2.6.14-4-k7 debian/rules binary_modules)
93
6. Install nvidia-kernel-common on the machine where the module will be
96
If not installed already
97
apt-get install nvidia-kernel-common
99
7. Install the nvidia-kernel package:
101
dpkg -i ../nvidia-kernel-2.6.14-2-k7_96.43.05-1+_.Custom_i386.deb
102
( or similar filename )
104
Now see GENERAL NOTES below method #2
106
METHOD #2: Using your own kernel source headers
107
***********************************************************************
109
To build the nvidia-kernel deb you need to first make sure you have
110
kernel-package installed, then do the following:
114
tar xjvf nvidia-kernel.tar.bz2 -C <YOUR BUILD LOCATION>
115
(It will install in <YOU BUILD LOCATION>/modules)
117
tar xjvf nvidia-kernel.tar.bz2 (if building in /usr/src)
119
2. If you are NOT using the default modules location /usr/src/modules
120
then you must set an environment variable that points to your modules
123
export MODULE_LOC=<YOUR BUILD LOCATION>/modules
125
This is needed by make-kpkg which is used later. If
126
<YOUR BUILD LOCATION> is /usr/src there is no need to set this.
128
3. Build the modules under MODULE_LOC i.e. <YOU BUILD LOCATION>/modules
130
cd linux (or your kernel source directory)
131
make-kpkg modules_image
133
4. Install nvidia-kernel-common on the machine where the module will be
136
apt-get install nvidia-kernel-common
138
5. Install the nvidia-kernel package:
140
cd <YOUR BUILD LOCATION> (e.g. /usr/src)
141
dpkg -i nvidia-kernel-KVER*.deb
145
- It is advised not to clean the kernel source tree between
146
"make-kpkg kernel_image" and "make-kpkg modules_image".
148
- The Riva framebuffer is known to conflict with the nvidia X driver. If you
149
are using X it would be wise not to compile it in. The vesa framebuffer is
150
known to work in some cases, and not in others. (people have recently been
151
having problems with the vesa driver as well)
155
Also you must add any users who wish to use OpenGL applications to the group
156
video. You can do this with:
158
adduser username video
160
Also note for AGP issues and further information please see the NVIDIA
161
README file (README.gz) in the nvidia-glx package
163
An old nvidia.o might be already loaded (run 'lsmod' to check) so
164
do 'rmmod nvidia.o' to remove the module from memory.
167
For any news on this package check http://people.debian.org/~rdonald and
168
http://bugs.debian.org/nvidia-kernel-source
171
-- Randall Donald <rdonald@debian.org>, Fri, 30 Apr 2004 19:02:04 -0700