Typo
[linux_from_scratch_hints.git] / OLD / nvidia_glx.txt
blobacdf45fbafe58f4ac68291226abd300b71b80a9e
1 TITLE:          GLX setup on XF402
2 LFS VERSION:    any
3 AUTHOR:         manaveru <manaveru@manaveru.net>
5 SYNOPSIS:
6         Generic instructions on how to setup GLX on Xfree 40[1-2], based on my experience with Nvidia cards.
8 HINT:
9 (Ed. note: There is also a nice mini-HOWTO on this subject which you can find on
10  linuxdoc.org)
12 Required stuff:
13 ===============
14 First, you need a kernel with AGP support. There are available patches for 2.2 
15 kernels, but I really recommand 2.4 kernels for 3D.
17 Read the Kernel2.4 hint for instructions on the upgrade. The AGP support is in 
18 Char devices (agpgart), select to build it as a module and choose your 
19 motherboard chipset in the list. Don't select any DRI option.
21 You need Xfree 4.0.1+ built and running.
23 Then, you have to download the Nvidia GLX modules on www.nvidia.com/drivers.
25 You need the following files:
26         - NVIDIA_kernel-0.9-6.tar.gz
27         - NVIDIA_GLX-0.9-6.tar.gz
29 Installation:
30 =============
31 Unpack the NVIDIA-kernel file and enter the created directory.
32         
33         # make
34 This will produce a module called NVdriver. Copy it to the appropriate kernel 
35 modules directory (the same as agpgart).
37         # cp NVdriver /lib/modules/2.4.1/drivers/char/agp
39 Add the device in /etc/modules.conf and refresh the modules dependencies.
41         # echo alias char-major-195 NVdriver >> /etc/modules.conf
42         # depmod -a
44 Unpack the NVIDIA-GLX file and enter the created directory.
46         # make
48 This will install the Nvidia drivers in the correct locations.
51 Setup:
52 ======
54 You will now edit the XF86Config file to use the new drivers.
55 I'll just show the things to add/modify or verify
56         # vi /etc/X11/XF86Config
58         Section "Module"
59                 Load    "glx"           # add if it's not there
60                 ....
61         EndSection
63         Section "Device"
64                 Driver  "nv"            # remove/comment that line
65                 Driver  "nvidia"        # add this line
66                 ....
67         EndSection
69 Tests:
70 ======
71 Restart X.
72         If X restarts properly, first step is OK.
73         If not, head to troubleshooting section. 
74 Launch Q3, UT or any other GLX compliant game.
75         If you have low performances (2-3 FPS), head to troubleshooting.
76         If performances are OK, you now have 3D accel on Linux.
77 Additionnaly, you may want to test glspec (you can find it on freshmeat.net)
79 Troubleshooting:
80 ================
81 Problem: X locks at startup
82 Solution: you'll need to edit os-registry.c, and check the comments near lines 
83 that start like #if 0.
85 Problem: 3D acceleration not working.
86 Solution: You have some mesa libs laying around in /usr/lib. Remove the 
87 following files /usr/lib/libMesa* /usr/X11R6/lib/libMesa* and reinstall GLX 
88 module. If you have 3D apps that require Mesa libs, you can simply create 
89 symlinks to GLX lib (libGL.so.1). You also need to remove 
90 /usr/X11R6/lib/libGL.so.1.2 and symlink it to /usr/lib/libGL.so.