~ubuntu-branches/ubuntu/precise/nvidia-graphics-drivers-96/precise

« back to all changes in this revision

Viewing changes to debian/nvidia-96-kernel-source.README.Debian

  • Committer: Bazaar Package Importer
  • Author(s): Alberto Milone (tseliot)
  • Date: 2008-07-08 18:49:17 UTC
  • Revision ID: james.westby@ubuntu.com-20080708184917-nnma71l8pyb76owa
Tags: 96.43.05-0ubuntu3
* Recommends nvidia-settings instead of Suggests nvidia-settings
* Put the icon for nvidia-settings in /usr/share/pixmaps

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
nvidia-graphics-drivers for Debian
 
2
----------------------------------
 
3
 
 
4
 
 
5
INTRODUCTION:
 
6
-----------------------------------------------------------------------
 
7
 
 
8
Welcome to Debian NVIDIA packages. This document contains notes on  the 
 
9
kernel module interface for the NVIDIA driver offering.
 
10
 
 
11
 
 
12
KERNEL MODULE INSTRUCTIONS:
 
13
-----------------------------------------------------------------------
 
14
 
 
15
There are TWO ways to build the nvidia-kernel package. Which one depends on
 
16
your situation with your kernel.
 
17
 
 
18
 METHOD #1: You are running a Debian suppiled kernel or built a 
 
19
    linux-headers package along with your own self-built kernel. 
 
20
 
 
21
 METHOD #2: You are running your own self-built kernel built from kernel
 
22
    source. 
 
23
 
 
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
 
27
documentation,
 
28
 
 
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). 
 
32
 
 
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.
 
35
 
 
36
 
 
37
 
 
38
PRELIMINARY: 
 
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. 
 
43
 
 
44
 
 
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
 
48
required.
 
49
 
 
50
 
 
51
HOTPLUG SUPPORT:
 
52
------------------------
 
53
As of version 1.0.5336-8 there is hotplug/udev module loading support provided.
 
54
 
 
55
 
 
56
METHOD #1 Using a linux-headers or kernel-headers package
 
57
***********************************************************************
 
58
 
 
59
As root (or using fakeroot)
 
60
1. cd /usr/src 
 
61
   tar xjvf nvidia-kernel.tar.bz2 -C <YOUR BUILD LOCATION>         
 
62
   (It will install in <YOU BUILD LOCATION>/modules) 
 
63
   - or -
 
64
   tar xjvf nvidia-kernel.tar.bz2  (if building in /usr/src) 
 
65
   
 
66
   The standard build location is /usr/src
 
67
   
 
68
2. Find out your kernel version:
 
69
                     
 
70
   uname -r   For example: 2.6.14-2-k7
 
71
                                          
 
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
 
75
   linux-
 
76
   
 
77
   Make sure your kernel image and headers have matching release numbers to
 
78
   avoid possible problems in packages built from different sources. 
 
79
   
 
80
4. Set some environment variables (if bash is your shell):
 
81
                   
 
82
    export KSRC=/usr/src/linux-headers-2.6.14-2-k7
 
83
    export KVERS=2.6.14-2-k7
 
84
                                                    
 
85
5. Then build nvidia-kernel package:
 
86
                           
 
87
   cd <YOUR BUILD LOCATION>/modules/nvidia-kernel
 
88
   debian/rules binary_modules
 
89
   
 
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)
 
92
                                                                   
 
93
6. Install nvidia-kernel-common on the machine where the module will be
 
94
deployed:
 
95
   
 
96
   If not installed already
 
97
   apt-get install nvidia-kernel-common
 
98
   
 
99
7. Install the nvidia-kernel package:
 
100
                             
 
101
   dpkg -i ../nvidia-kernel-2.6.14-2-k7_96.43.05-1+_.Custom_i386.deb
 
102
   ( or similar filename )
 
103
 
 
104
Now see GENERAL NOTES below method #2
 
105
 
 
106
METHOD #2: Using your own kernel source headers
 
107
***********************************************************************
 
108
 
 
109
To build the nvidia-kernel deb you need to first make sure you have
 
110
kernel-package installed, then do the following:
 
111
 
 
112
As root
 
113
1. cd /usr/src
 
114
   tar xjvf nvidia-kernel.tar.bz2 -C <YOUR BUILD LOCATION>         
 
115
   (It will install in <YOU BUILD LOCATION>/modules) 
 
116
   - or -
 
117
   tar xjvf nvidia-kernel.tar.bz2  (if building in /usr/src) 
 
118
 
 
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
 
121
   location.
 
122
     
 
123
     export MODULE_LOC=<YOUR BUILD LOCATION>/modules
 
124
     
 
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.
 
127
     
 
128
3. Build the modules under MODULE_LOC i.e. <YOU BUILD LOCATION>/modules 
 
129
 
 
130
     cd linux (or your kernel source directory)
 
131
     make-kpkg modules_image
 
132
 
 
133
4. Install nvidia-kernel-common on the machine where the module will be
 
134
installed:
 
135
 
 
136
   apt-get install nvidia-kernel-common
 
137
 
 
138
5. Install the nvidia-kernel package:
 
139
     
 
140
     cd <YOUR BUILD LOCATION>    (e.g. /usr/src)
 
141
     dpkg -i nvidia-kernel-KVER*.deb
 
142
 
 
143
Notes for method #2: 
 
144
 
 
145
- It is advised not to clean the kernel source tree between 
 
146
"make-kpkg kernel_image" and "make-kpkg modules_image". 
 
147
 
 
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) 
 
152
 
 
153
GENERAL NOTES:
 
154
 
 
155
Also you must add any users who wish to use OpenGL applications to the group
 
156
video. You can do this with:
 
157
 
 
158
        adduser username video
 
159
 
 
160
Also note for AGP issues and further information please see the NVIDIA
 
161
README file (README.gz) in the nvidia-glx package 
 
162
 
 
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.
 
165
 
 
166
 
 
167
For any news on this package check http://people.debian.org/~rdonald and
 
168
http://bugs.debian.org/nvidia-kernel-source
 
169
 
 
170
 
 
171
 -- Randall Donald <rdonald@debian.org>, Fri, 30 Apr 2004 19:02:04 -0700