NVIDIA/nvidia-drivers/ja

はNVIDIA製グラフィックスカード用のプロプライエタリなドライバーです. オープンソースの代替としてnouveauがあります.

Portage TreeにあるはNVIDIAによって公開されていて、Linuxカーネルと共に動くようビルドされています. これらにはグラフィックスカードとのやりとりの大部分を行うバイナリ・ブロブが含まれています. ドライバーはカーネルモジュールとX11ドライバーの二つの部分で攻勢されています. この両方が一つのソフトウェアパッケージに含まれています. NVIDIAが行ったパッケージのしかたにより、インストール前にいくつか決めなければならない事柄があります.

はNVIDIAの最新のドライバーが含まれていて、大半のカードがサポートされています. カードの製造時期によっては対応するドライバーのいくつかのバージョンが含まれています. このパッケージはeclassを使用し、システムに含まれるカードの種類を特定した上で正しいバージョンのドライバーをインストールします.

ハードウェアの互換性
は幅広いNVIDIAのグラフィックスカードをサポートします. システムに含まれるカードに合わせられるよう、このパッケージには複数のバージョンがあります. どのバージョンのを使うべきかを確認するには、NVIDIA公式ドキュメントである What's a legacy driver?を参照してください. 確認の際に便利なものとしてan interactive formがあります. システムに含まれるグラフィックスカードを入力すると、もっとも適したバージョンを教えてくれます. (なお、'Product Type'の入力欄にあるLegacyオプションにはご注意ください)

もしグラフィックスカードがレガシーカードと分かったならば、以下のような最近のをマスクしてください.

If the card has been identified as a legacy card then mask the more recent releases of, e.g.:

Gentooが71.86.xxバージョンを提供していないことを念頭に置いておいてください. もしこのドライバーを必要とするグラフィックスカードがシステム内にあるならば、nouveauドライバーを使うことが推奨されます.

カーネル
上記の通り、NVIDIAのカーネルドライバーは現在のカーネルに合わせてインストールされ、実行されます. カーネルモジュールとしてビルドされるので、カーネルはモジュールのロードに対応していなければなりません. (下記参照)

カーネルモジュールは(バイナリ・ブロブとして一般的に知られている)グラフィックスチップを動かすプロプライエタリな部分と、(「のり」である)実行時にカーネルとプロプライエタリな部分の橋渡しをするオープンソースの部分から構成されます. これらがすべて協調して動作しないと、(カーネルパニックや未保存のデータが残っている状態でのXサーバーのクラッシュなどによる)データの損失につながります. また、(過熱やそのた電源管理の問題に代表される)ハードウェアの不具合も考えられます.

カーネルの互換性
時々、新しいカーネルのリリースによってドライバー用の内部ABIが変わることがあります. これは、それらのABIを利用するすべてのドライバーをこの変更に合わせなければならないことを意味します. オープンソースのドライバー、特にカーネルとともに頒布されるものに関しては、ドライバーやカーネルの他の部分をつなぐ一連の機能呼び出しを見直すことが容易で、この様な変更はほとんど手間な加えることができます. しかし、プロプライエタリなドライバーに関しては同じようにはいきません. 内部ABIが変わるとき、プロプライエタリな部分によってどのように「のり」の部分が使われているか分からないため、ただ単に「のり」の部分を修正することは不可能です. うまく修正を重ねて順調に動いているようであっても、nvidia.koを新しい、サポートされていないカーネルで使うことにはデータの損失やハードウェアの不具合が起きるといったリスクが付随します.

新しい、互換性のないバージョンのカーネルがリリースされたとき、しばらくはサポートされる最新のカーネルを使用しつづけることが最善でしょう. NVIDIAが一般に公開してもいいと判断するプロプライエタリなドライバーを公開するのには通常数週間かかります. 気長に待つべきです. もし新しいカーネルが絶対に必要ならば、nvidia-driversのebuildでepatch_userコマンドを使うこともできます. これによってnvidia-driversに何らかの修正を加えて、最新のサポートされていないカーネルでも動くようにすることができます. nvidia-driversのメンテナも、NVIDIA自体もこのような用法はサポートしないことを念頭に置いてください. ハードウェアの保証もおそらく無効になるでしょう. また、NVIDIAのみがまともにデバッグできるのでGentooのメンテナも修正を加えることはできません. (Gentoo、Upstreamの双方の)カーネルのメンテナはプロプライエタリなドライバー、ひいてはプロプライエタリなソフトウェアに「汚染」されたシステムの不調に対してサポートを提供しません.

もしによってカーネルが構築されたならば、準備は整っています. もしそうでなければ、以下が有効になっているかもう一度確認してください:

カーネル内のMemory Type Range Registerも有効にしてください.

すべてではないにせよ少なくともいくつかのドライババージョンでは、VGAアービトレーションとIPMIメッセージハンドラを有効にする必要がある場合もあります:

システムにAGPグラフィックスカードがある場合は、カーネルのagpgartサポートを有効にすることもできます. モジュールとして有効にする他、カーネルに組み込むこともできます. もしagpgartモジュールが使用されなければ、ドライバーに含まれるNvAGPという独自のagpgartの実装が使用されます. システムによっては、こちらを使用する方がカーネル内のagpgartよりも高いパフォーマンスが得られ、その逆も場合もあります. 使用しているシステムでどちらの方がよいパフォーマンスを得られるかを確認するとよいでしょう. 分からない場合は、カーネル内のagpgartを使ってください.

(U)EFIシステムでは uvesafb は動きません. またカーネルで "efifb" サポートを有効にする と、時々NVIDIAドライバの初期化に問題が発生することがあります. 今のところ(U)EFIシステムで他に使えるフレームバッファはありません.

nvidia-drivers ebuild は のシンボリックリンクを元にカーネルバージョンを決定します. このシンボリックリンクが正しいソースを指し、きちんとコンフィグレーションができていることを確認してください. カーネルのコンフィグレーションについては Gentoo Handbook の "カーネルの設定" をお読みください.

First, choose the right kernel source using. When using version 3.7.10 for instance, the kernel listing might look something like this:

In the above output, notice that the linux-3.7.10-gentoo kernel is marked with an asterisk to show that it is the kernel that the symbolic link points to.

If the symlink is not pointing to the correct sources, update the link by selecting the number of the desired kernel sources, as in the example above.

ドライバー
いよいよドライバをインストールします. まず Xサーバー設定ガイド に従い で   と設定します. そうするとXサーバーをインストールする際に、適切なバージョンの をインストールしてくれます.

Once the installation has finished, run to load the kernel module into memory. If this is an upgrade, remove the previous module first.

To prevent from having to manually load the module on every bootup, have this done automatically each time the system is booted, so edit and add   to it.

カーネルモジュールの署名 (任意)
セキュアブートのためのカーネル署名を行っている場合は、NVIDIAのカーネルモジュールも読み込む前に署名しなければなりません.

これはカーネル付属の スクリプトで次のように行えます:

ドライババージョン 358.09 以降では画面モード設定のために新しいモジュールが追加されたので、これも併せて署名しなければなりません.

正しく署名ができたら、ドライバはブート時に読み込まれるはずです. このモージュール署名の方法は nvidia-drivers に限らず、ほかのモジュールでも使えます. 指定するモジュールのパスを変更するだけです.

X サーバー
Once the appropriate drivers are installed, configure the X server to use the  driver instead of the default   driver.

Run so that the X server uses the NVIDIA GLX libraries:

nvidiaサポートをシステム全体で有効にする
Some tools, such as and, use a local USE flag called   which enables XvMCNVIDIA support, useful when watching high resolution movies. Add in  in the USE variable in  or add it as USE flag to  and/or  in.

GeForce 8 series and later GPUs do come with VDPAU support which superseded XvMCNVIDIA support. See the VDPAU article for enabling VDPAU support.

There are also some applications that use the  USE flag, so it might be a good idea to add it to.

Then, run to rebuild the applications that benefit from the USE flag change.

nVidia 設定ツールを使う
NVIDIA also provides a settings tool. This tool allows the user to monitor and change graphical settings without restarting the X server and is available through Portage as part of with the   USE flag set.

OpenGL/OpenCL を有効にする
To enable OpenGL and OpenCL though the device, run:

Make sure that the Xorg server is not running during these changes.

カードをテストする
To test the NVIDIA card, fire up X and run, which is part of the package. It should say that direct rendering is activated:

To monitor the FPS, run.

Blinking console cursor and compat use flag
If a blinking console appears instead of X when using the  nvidia-drivers USE flag on nvidia-drivers-430 and newer there might have a segmentation fault when xorg starts.

Looking for the segfault:
 * 1) Boot to the blinking prompt screen
 * 2) Switch to a tty  +  +
 * 3) Close gdm. For OpenRC:  For systemd:
 * 4) Launch X to see the output:

If a segmentation fault error occurs on the nvidia module during, rebuild nvidia-drivers without the compat useflag.

Follow for further details.

FATAL: modpost: GPL-incompatible module *.ko uses GPL-only symbol
When the ebuild is complaining about the 'mutex_destroy' GPL-only symbol:

Be sure to disable CONFIG_DEBUG_MUTEXES in the kernel's file, as suggested by this forum thread.

Driver fails to initialize when MSI interrupts are enabled
The Linux NVIDIA driver uses Message Signaled Interrupts (MSI) by default. This provides compatibility and scalability benefits, mainly due to the avoidance of IRQ sharing. Some systems have been seen to have problems supporting MSI, while working fine with virtual wire interrupts. These problems manifest as an inability to start X with the NVIDIA driver, or CUDA initialization failures.

MSI interrupts can be disabled via the NVIDIA kernel module parameter. This can be set on the command line when loading the module, or more appropriately via the distribution's kernel module configuration files (such as those under ).

例えば:

4GB 以上のメモリを搭載したマシンで 2D アクセラレーションを使う
When NVIDIA 2D acceleration is giving problems, then it is likely that the system is unable to set up a write-combining range with MTRR. To verify, check the contents of :

Every line should contain  or. When a line shows up with  in it then it is necessary to change a BIOS setting to fix this.

Reboot and enter the BIOS, then find the MTRR settings (probably under "CPU Settings"). Change the setting from  to   and boot back into Linux. There is now no  entry anymore and 2D acceleration now works without any glitches.

Alternatively, it might be necessary to enable MTRR cleanup support (CONFIG_MTRR_SANITIZER=Y) in the Linux kernel:

Failed to initialize DMA on Ryzen
Disable AMD Secure Memory Encryption https://devtalk.nvidia.com/default/topic/1039297/linux/unable-to-start-x-failed-to-initialize-dma-/

"no such device" appears when trying to load the kernel module
This is usually caused by one of the following issues:


 * 1) The system does not have a NVIDIA card at all.  Check  output to confirm that the system has a NVIDIA graphics card installed and detected.
 * 2) The currently installed version of  does not support the installed graphics card model.  Check the README file in /usr/share/nvidia-drivers-*/ for a list of supported devices, or use the driver search at http://www.geforce.com/drivers.
 * 3) Another kernel driver has control of the hardware. Check  to see if another driver like "nouveau" or "efifb" is bound to the graphics card. If so, disable or blacklist this driver.

Xorg says it can't find any screens
When after booting the system, it ends up with a black screen or a console prompt instead of the GUI; then press ++ to bring up a virtual console. Next, run:

to see the output of Xorg. If one of the first errors is that Xorg can't find any screens, then follow the following steps to resolve the issue.

It should be enough to run the following command before rebooting:

But if that doesn't work, run and notice that the video card starts off like this:

Take the first bit,, translate it to decimal and put it in the  file with the   option:

Direct rendering is not enabled
If direct rendering does not work, it may be because the kernel has Direct Rendering Manager enabled, which conflicts with the driver. See the direct rendering status by following instructions in the section Testing the card.

First, disable Direct Rendering Manager in the kernel :

Next, rebuild since the driver may have built against the kernel DRM symbols. It should fix the problem.

Video playback stuttering or slow
Lately there seems to be some breaking with playback of some types of video with the NVIDIA binary drivers, causing slow video playback or significant stuttering. This problem seems to be occurring within the Intel CPU Idle replacement instead of the common ACPI CPU idling method for certain CPU's.

Disable the Intel CPU idling method using  on the kernel command line boot method, which should cause the kernel to automatically fall back to the normal or older ACPI CPU idling method. Also, disabling the NVIDIA Powermizer feature, or setting Powermizer to maximum performance within has been said to help. Although the Intel CPU idling method recently was introduced as the default CPU idling method for i5 and i7 CPUs (versus using ACPI CPU idling) is the root cause here. This idling method significantly solves the problem, however some minimal stuttering or slow video is encountered if deinterlacing was enabled; this is when the video is likely already deinterlaced (ie. alias  with something similar to   as a work around.)

If you're using GRUB2 as your bootloader, you can add this kernel parameter to  like so:

Don't forget to run  after making the change, so that the new configuration is generated (see the GRUB2 page for further details).

After you have rebooted, you can verify that the change is active:

No vertical synchronization (no VSync, tearing) in OpenGL applications
Adding the following option to the screen section prevents tearing on GTX 660, 660 Ti, and probably some other GPUs (reference):

Documentation
The package also comes with comprehensive documentation. This is installed into and can be viewed with the following command:

カーネルモジュールのパラメーター
The  kernel module accepts a number of parameters (options) which can be used to tweak the behavior of the driver. Most of these are mentioned in the documentation. To add or change the values of these parameters, edit the file. Remember to run after modifying this file, and bear in mind to reload the   module before the new settings take effect.

を編集:

モジュールをアンロードして...

...もう一度読み込みます:

X の高度な設定
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.

To use any of these options, list them in the relevant Device section of the X config file (usually ). For example, to disable the splash logo: