Merge branch 'upstream'
[nvidia.git] / README
1 Quick and Dirty HOW-TO on installing and using FreeBSD Nvidia driver in Dragonfly
2
3 1. Make sure you got git installed, it is in pkgsrc/devel/scmgit-base
4
5 2. You should checkout corecode's git repository, by following command:
6
7         git clone git://ww2.fs.ei.tum.de/~corecode/git/nvidia.git
8
9 3. then CD to new repository, make; make install
10
11 4. add nvidia_load="YES" to your /boot/loader.conf
12
13 5. Check kldstat, that nvidia.ko is loaded.
14
15 6. Now you should manually make devfs nodes for nvidia device:
16
17         cd /dev
18         mknod nvidia0 c 180 0
19         mknod nvidiactl c 180 255
20         chmod 644 nvidia*
21
22 7. Now starts the most interesting - corecode's wrapper for X.org to make drivers function properly.
23
24         cd obj/wrapmodule ; make
25         cp libnvidiawrap.so /usr/pkg/lib/xorg/modules
26
27 8. Now you need to link the installed nvidia libs to version-less names
28
29         cd /usr/pkg/lib/xorg/modules
30         ln -fs libnvidia-wfb.so.1 libwfb.so
31         ln -fs libglx.so.1 libglx.so
32
33 9. Now create the glue for the nvidia GL libs:
34
35         cd obj/wraplib ; make
36         cd .. ; cp libGL* libXv* /usr/pkg/lib
37         mv /usr/pkg/lib/libGL.so.1 /usr/pkg/lib/libGL.so.w
38         cp wraplib/libGL.so wraplib/libGL.so.1 /usr/pkg/lib
39
40 Maybe you'll have to add a symlink to libGL.so in case your pkgsrc/libtool was being stupid:
41
42         cd /usr/pkg/lib
43         ln -fs libGL.so.1 libGL.so.1.0.5
44
45 10. Now we should edit xorg.conf, open it in your favourite editor (I prefer ee) and edit it the following way:
46 Section "Module"
47         Load "nvidiawrap" // Wrapper should be the first module in that section
48         Load "glx" // Add it for Nvidia accelerated OpenGL
49
50 Section "Device"
51         Driver "nvidia" //Replace Driver "nv" with that string and comment BusID string
52
53
54 11. (Not necessary) You probably want nvidia-settings tool for controlling your
55     videocard, so grab it from here:
56
57         http://download.nvidia.com/XFree86/nvidia-settings/nvidia-settings-1.0.tar.gz
58
59 extract, run
60
61         gmake install
62
63 It should function out of the box
64 If nvidia-settings refuses to start, make symlinks to your version of libraries. It wants (at least on my system):
65
66         libgtk-x11-2.0.so.400, libgdk-x11-2.0.so.400, libatk-1.0.so.600,
67         libgdk_pixbuf-2.0.so.400, libpangoxft-1.0.so.399, libfreetype.so.9,
68         libpangox-1.0.so.399, libpango-1.0.so.399, libgobject-2.0.so.400,
69         libgmodule-2.0.so.400, libglib-2.0.so.400