|
6
by Alberto Milone
* debian/rules: |
1 |
NVIDIA video drivers for Ubuntu |
2 |
============================
|
|
3 |
||
4 |
Further information can be found at http://www.nvidia.com/ -- look for |
|
5 |
the "Download Drivers" tab and follow links to the Linux drivers. |
|
6 |
||
7 |
This package is generated from the official NVIDIA driver |
|
8 |
installer that is available from the above homepage. |
|
9 |
||
10 |
DKMS
|
|
11 |
-------------------------
|
|
12 |
Ubuntu includes support to build modules using a utility developed by |
|
13 |
Dell, called DKMS. It will automatically build your kernel module |
|
14 |
for you when you first boot into the kernel (or as necessary). |
|
15 |
||
16 |
Note: the OBSOLETE_BY line in dkms.conf specifies a kernel version |
|
17 |
which obsoletes the necessity for this particular DKMS module. |
|
18 |
For example, OBSOLETE_BY=2.6.39 will prevent DKMS from building |
|
19 |
modules for kernels >= 2.6.39. |
|
20 |
||
21 |
See the DKMS man page for more information. |
|
22 |
||
23 |
Kernel patches |
|
24 |
-------------------------
|
|
25 |
If you need to provide a kernel patch (say for a kernel not formally |
|
26 |
supported yet by NVIDIA), you can add this patch in the |
|
27 |
debian/dkms/patches directory and mention the patch in the |
|
28 |
debian/templates/dkms.conf.in file. |
|
29 |
||
30 |
It is usually a good idea to restrict the use of a patch to certain |
|
31 |
kernel versions with the PATCH_MATCH[n] variable. |
|
32 |
||
33 |
See the DKMS man page for more information. |
|
34 |
||
35 |
32 bit libraries on 64 bit systems |
|
36 |
-------------------------
|
|
37 |
32 bit libraries are provided on 64 bit systems for compatibility |
|
38 |
reasons. |
|
39 |
||
40 |
The following templates are merged together into the same file on |
|
41 |
amd64: |
|
42 |
debian/templates/nvidia-current.links32.in |
|
43 |
debian/templates/nvidia-current.links.in |
|
44 |
||
45 |
$ld_so_conf_path lets the system know where it should look for 32 |
|
46 |
bit libraries. |
|
47 |
||
48 |
Update procedure |
|
49 |
-------------------------
|
|
50 |
When a new NVIDIA is available, do the following to update |
|
51 |
#DRIVERNAME#:
|
|
52 |
||
53 |
0. On your build system, make sure you have the prerequisites |
|
54 |
installed: |
|
55 |
||
56 |
$ sudo apt-get build-dep #DRIVERNAME# |
|
57 |
||
58 |
1. Download the NVIDIA installers i.e. the .run files. |
|
59 |
||
60 |
2. dch -i to update the version in the debian/changelog so that it |
|
61 |
matches the new upstream version. |
|
62 |
||
63 |
Also make sure that the changelog includes both the changes you |
|
64 |
made (if any) to the files in debian/ changes and the changes from |
|
65 |
upstream (i.e. NVIDIA) which you can find in the release notes of |
|
66 |
the driver. |
|
67 |
||
68 |
3. debclean to regenerate most of the files in debian/ from their |
|
69 |
templates in debian/templates/. |
|
70 |
||
71 |
4. Temporarily move the debian/ directory out of the source directory |
|
72 |
and compress it as $SOURCE_NAME _ $NEW_VERSION . orig . tar . gz |
|
73 |
e.g. #DRIVERSRCNAME#_#VERSION#.orig.tar.gz |
|
74 |
||
75 |
5. Move the debian/ directory back to the source directory and type |
|
76 |
debuild -S -sa to produce a new .dsc |
|
77 |
||
78 |
6. Verify the new .dsc produces valid .debs by running it through |
|
79 |
pbuilder, sbuild, etc. as usual. |
|
80 |
||
81 |
7. Install and test the .debs, and then dput the .changes file |
|
82 |
||
83 |
X server ABI updates |
|
84 |
-------------------------
|
|
85 |
In order to update the list of the supported X server ABIs you can |
|
86 |
edit the debian/substvars file. |
|
87 |
||
88 |
Adding new card ids |
|
89 |
-------------------------
|
|
90 |
The NVIDIA driver may work with card ids that are not listed in their |
|
91 |
README file. If this is the case, there won't be a modalias for these |
|
92 |
cards in the driver package (this only affects driver detection in |
|
93 |
Jockey). If you want to make sure that such modaliases are included |
|
94 |
in the package, you'll have to add the card ids in uppercase(e.g. 0AFD), |
|
95 |
either separated by a white space or one per line, in the |
|
96 |
debian/additional_card_ids file. |
|
97 |
||
98 |
||
99 |
IMPORTANT NOTE: If any changes to files in debian/ are needed, make sure |
|
100 |
to discuss your changes with the maintainer (Alberto aka tseliot) before |
|
101 |
you upload. |
|
102 |
||
103 |
||
104 |
-- Alberto Milone <alberto.milone@canonical.com> Mon, 04 Mar 2013 16:47:22 +0100 |