~ubuntu-branches/ubuntu/maverick/nvidia-graphics-drivers-96/maverick-proposed

« back to all changes in this revision

Viewing changes to debian/nvidia-glx-96.README.Debian

  • Committer: Bazaar Package Importer
  • Author(s): Alberto Milone
  • Date: 2010-01-08 23:34:51 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20100108233451-f1142o5r7z0ou4o0
Tags: 96.43.14-0ubuntu1
* Rework packaging taking Mandriva's as a model:
  - Use alternatives instead of diversions.
  - Reduce the number of binary packages to nvidia-96,
    nvidia-96-dev and nvidia-96-modaliases.
* debian/rules:
  - Switch to CDBS.
  - Remove libGL.la as no static library is provided.
* debian/nvidia-current.README.Debian.in:
  - Document the update process.
* nvidia-current.postinst: try to build the module for the most
  recent kernel in addition to building it for the current kernel
  (LP: #474917).
* New upstream release (LP: #494166):
 - Add support for xserver 1.7.x.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
nvidia-graphics-drivers for Ubuntu
2
 
----------------------------------
3
 
 
4
 
 
5
 
INTRODUCTION:
6
 
-----------------------------------------------------------------------
7
 
 
8
 
Welcome to the Ubuntu NVIDIA packages. This document has notes on the
9
 
X Server and GL libraries of the NVIDIA driver offering.
10
 
 
11
 
 
12
 
A Note about Thread Local Storage (TLS):
13
 
----------------------------------------
14
 
Under 2.6.x kernels a new TLS method is used and different libraries are
15
 
required. NVIDIA provides these libraries and at boot time (via
16
 
/etc/init.d/nvidia-glx)  a test is performed on your system to see if 
17
 
your require these extra libraries. Having the TLS libraries installed 
18
 
(in /usr/lib/tls and libglx.so) running under a 2.4.x kernel will cause 
19
 
problems when running GL applications. Likewise, not having these libraries 
20
 
installed under 2.6.x might prevent X from starting at all. 
21
 
 
22
 
Simple Explanation: 
23
 
To switch back and forth between the two systems simply run:
24
 
 
25
 
      /etc/init.d/nvidia-glx start
26
 
      
27
 
      This is run automatically at boot time. 
28
 
 
29
 
To force a certain setting (e.g. you may have a 2.4 kernel patched for
30
 
NPTL) place  USE_TLS=1 in /etc/defaults/nvidia-glx for using the nvidia tls
31
 
libraries. USE_TLS=0 for not using tls libraries.  This isn't normally
32
 
necessary for most users. 
33
 
 
34
 
 
35
 
What Happens:
36
 
Symlinks are created in /usr/lib/tls from libraries installed in
37
 
/usr/lib/nvidia. 
38
 
 
39
 
 
40
 
For any news on this package check http://people.debian.org/~rdonald and
41
 
http://bugs.debian.org/nvidia-glx
42
 
 
43
 
 
44
 
NOTES ABOUT GLX DRIVER AND OPENGL:
45
 
-----------------------------------------------------------------------
46
 
 
47
 
Using the nvidia X driver requires some user modification. 
48
 
 
49
 
        First, modify your /etc/X11/xorg.conf
50
 
 
51
 
        Minimum requirements:
52
 
        In Section "Device"
53
 
           Change Driver "nv" to Driver "nvidia"
54
 
        
55
 
        See /usr/share/doc/nvidia-glx/README.gz and
56
 
        /usr/share/doc/nvidia-glx/examples/XF86Config.sample.gz
57
 
        for descriptions of all supported options. 
58
 
        Appendix F:  CONFIGURING AGP is an important section.
59
 
        
60
 
 
61
 
Note about OpenGL headers: The header files are not installed to 
62
 
/usr/include/GL but to /usr/share/doc/nvidia-glx-dev/include/GL. 
63
 
This allows use of and not overwriting of the  
64
 
preinstalled headers (e.g. xlibmesa-dev). If you wish to use the NVIDIA
65
 
supplied headers (e.g. you require NVIDIA GL extensions) you must copy them to
66
 
/usr/include/GL yourself or include /usr/share/doc/nvidia-glx-dev/include in
67
 
your includes path when compiling.
68
 
 
69
 
 
70
 
Also note all users using GLX must be in group video. (i.e. adduser <user>
71
 
video)
72
 
 
73
 
 
74
 
 
75
 
 -- Randall Donald <rdonald@debian.org>, Mon, 31 Mar 2003 23:40:05 -0800