neysx 05/06/04 16:57:03 Modified: xml/htdocs/doc/en nvidia-guide.xml Log: #94957 Add intro & advanced stuff, tx dsd
Revision Changes Path 1.14 +118 -18 xml/htdocs/doc/en/nvidia-guide.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/nvidia-guide.xml?rev=1.14&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/nvidia-guide.xml?rev=1.14&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/nvidia-guide.xml.diff?r1=1.13&r2=1.14&cvsroot=gentoo Index: nvidia-guide.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/nvidia-guide.xml,v retrieving revision 1.13 retrieving revision 1.14 diff -u -r1.13 -r1.14 --- nvidia-guide.xml 4 Jun 2005 11:01:24 -0000 1.13 +++ nvidia-guide.xml 4 Jun 2005 16:57:03 -0000 1.14 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/nvidia-guide.xml,v 1.13 2005/06/04 11:01:24 neysx Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/nvidia-guide.xml,v 1.14 2005/06/04 16:57:03 neysx Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/nvidia-guide.xml"> @@ -20,21 +20,49 @@ <license/> -<version>1.10</version> +<version>1.11</version> <date>2005-06-04</date> <chapter> +<title>Introduction</title> +<section> +<body> + +<p> +nVidia release their own Linux drivers which provide good performance and full +3D acceleration. The driver releases are split up into two parts: +<c>nvidia-kernel</c> and <c>nvidia-glx</c>. +</p> + +<p> +<c>nvidia-kernel</c> is a kernel driver which handles the low-level +communication with your video hardware. This is simply a kernel module, named +<c>nvidia</c>, which installs against your kernel sources and needs to be loaded +whenever you want to use the nvidia drivers. +</p> + +<p> +As well as the kernel driver, you need to install the X11 GLX layer +(<c>nvidia-glx</c>). This is used by X to render graphics, which internally +uses the <c>nvidia-kernel</c> kernel driver to interface with the hardware. +</p> + +</body> +</section> +</chapter> + +<chapter> <title>Configuring your Card</title> <section> <title>Installing the Appropriate Drivers</title> <body> <p> -The nVidia drivers include kernel modules that must integrate in your current -kernel. To accomplish this, your kernel must support the loading of kernel -modules. If you used <c>genkernel</c> to configure the kernel for you then -you're all set. If not, double check your kernel configuration so that this -support is enabled: +As mentioned above, the nVidia kernel driver installs and runs against your +current kernel. It builds as a module, so it makes sense that your kernel must +support the loading of kernel modules. If you used <c>genkernel</c> to configure +the kernel for you then you're all set. If not, double check your kernel +configuration so that this support is enabled: </p> <pre caption="Enabling the Loading of Kernel Modules"> @@ -67,13 +95,14 @@ </p> <p> -If you are using gentoo-sources-2.6.11-r6, your symlink should look like this: +If you are using gentoo-sources-2.6.11-r6, your /usr/src directory might look +something like this: </p> <pre caption="Check your /usr/src/linux symlink"> # <i>cd /usr/src</i> # <i>ls -l</i> -<comment>(Check that linux point to the right directory)</comment> +<comment>(Check that linux points to the right directory)</comment> lrwxrwxrwx 1 root root 22 Apr 23 18:33 linux -> linux-2.6.11-gentoo-r6 drwxr-xr-x 4 root root 120 Apr 8 18:56 linux-2.4.26-gentoo-r4 drwxr-xr-x 18 root root 664 Dec 31 16:09 linux-2.6.10 @@ -82,11 +111,16 @@ </pre> <p> -If the symlink is not pointing to the correct sources, you may create the link +In the above output, you'll notice that the <c>linux</c> symlink is pointing +to the <c>linux-2.6.11-gentoo-r6</c> kernel. +</p> + +<p> +If the symlink is not pointing to the correct sources, you must update the link like this: </p> -<pre caption="Create /usr/src/linux symlink"> +<pre caption="Create/Update /usr/src/linux symlink"> # <i>cd /usr/src</i> # <i>ln -snf linux-2.6.11-gentoo-r6 linux</i> </pre> @@ -105,7 +139,8 @@ Every time you <uri link="/doc/en/kernel-upgrade.xml">compile a new kernel</uri> or recompile the current one, you have to run <c>emerge nvidia-kernel</c> to reinstall the nVidia modules. nvidia-glx is unaffected by -a kernel change. +a kernel change and doesn't even need to be rebuilt when you recompile/upgrade +X. </impo> <p> @@ -118,9 +153,11 @@ </pre> <p> -You probably want to have this done each time you boot your system, so edit -<path>/etc/modules.autoload.d/kernel-2.6</path> (or <path>kernel-2.4</path>) and -add <c>nvidia</c> to it. Don't forget to run <c>modules-update</c> afterwards. +To prevent you having to manually load the module on every bootup, you probably +want to have this done automatically each time you boot your system, so edit +<path>/etc/modules.autoload.d/kernel-2.6</path> (or <path>kernel-2.4</path>, +depending on which kernel version you use) and add <c>nvidia</c> to it. Don't +forget to run <c>modules-update</c> afterwards. </p> <pre caption="Running modules-update"> @@ -140,9 +177,10 @@ </p> <p> -Open <path>/etc/X11/XF86Config</path> (or <path>/etc/X11/xorg.conf</path>) with -your favorite editor (such as <c>nano</c> or <c>vim</c>) and go to the -<c>Device</c> section. In that section, change the <c>Driver</c> line: +Open <path>/etc/X11/xorg.conf</path> (or <path>/etc/X11/XF86Config</path> if you +still use the older configuration file location) with your favorite editor +(such as <c>nano</c> or <c>vim</c>) and go to the <c>Device</c> section. In that +section, change the <c>Driver</c> line: </p> <pre caption="Changing nv to nvidia in the X Server configuration"> @@ -300,4 +338,66 @@ </section> </chapter> +<chapter> +<title>Expert Configuration</title> +<section> +<title>Documentation</title> +<body> + +<p> +The nVidia driver package also comes with comprehensive documentation. This is +installed into <c>/usr/share/doc</c> and can be viewed with the following +command: +</p> + +<pre caption="Viewing the NVIDIA documentation"> +# <i>less /usr/share/doc/nvidia-glx-*/README.txt.gz</i> +</pre> + +</body> +</section> +<section> +<title>Kernel module parameters</title> +<body> + +<p> +The <c>nvidia</c> kernel module accepts a number of parameters (options) which +you can use to tweak the behaviour of the driver. Most of these are mentioned in +the documentation. To add or change the values of these parameters, edit the +file <c>/etc/modules.d/nvidia</c>. Remember to run <c>modules-update</c> after +modifying this file, and bear in mind that you will need to reload the +<c>nvidia</c> module before the new settings take effect. +</p> + +</body> +</section> +<section> +<title>Advanced X configuration</title> +<body> + +<p> +The GLX layer also has a plethora of options which can be configured. These +control the configuration of TV out, dual displays, monitor frequency detection, +etc. Again, all of the available options are detailed in the documentation. +</p> + +<p> +If you wish to use any of these options, you need to list them in the relevant +Device section of your X config file (usually <c>/etc/X11/xorg.conf</c>). For +example, suppose I wanted to disable the splash logo: +</p> + <<Truncated>> -- [email protected] mailing list
