~ubuntu-branches/ubuntu/raring/nvidia-graphics-drivers-304/raring-proposed

« back to all changes in this revision

Viewing changes to debian/nvidia-304.README.Debian

  • Committer: Package Import Robot
  • Author(s): Alberto Milone
  • Date: 2012-12-06 16:43:42 UTC
  • Revision ID: package-import@ubuntu.com-20121206164342-v0weyv72951pe5ft
Tags: 304.64-0ubuntu1
Initial release (LP: #1086718).

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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/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/nvidia-current.links32.in
 
43
   debian/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
nvidia-304:
 
52
 
 
53
0.  On your build system, make sure you have the prerequisites
 
54
    installed:
 
55
 
 
56
    $ sudo apt-get build-dep nvidia-304
 
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.
 
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. nvidia-graphics-drivers-304_304.64.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, 21 Dec 2009 12:36:15 +0100