Pilotes NVidia NVidia/nvidia-drivers

From Gentoo Wiki
< NVIDIA(Redirected from NVidia/nvidia-drivers/fr)
Jump to:navigation Jump to:search
This page is a translated version of the page NVIDIA/nvidia-drivers and the translation is 34% complete.
Outdated translations are marked like this.

x11-drivers/nvidia-drivers est le pilote graphique propriétaire pour les cartes graphiques NVIDIA. nouveau est une alternative open source à ce pilote.

Les pilotes x11-drivers/nvidia-drivers de l'arbre sont distribués par NVIDIA et compilés pour une prise en charge par le noyau Linux. Ils contiennent une partie binaire (blob) qui fait l'essentiel du travail de discussion avec la carte. Ils comprennent deux parties, un module du noyau et un pilote X11. Les deux parties sont incluses dans un paquet unique. Dû a la manière dont NVIDIA empaquettent leurs pilotes, il est nécessaire de faire des choix avant de les installer.

Le paquet x11-drivers/nvidia-drivers contient la dernière version des pilotes NVIDIA qui prennent en charge la plupart des cartes, avec plusieurs versions disponibles selon l'âge de la carte. Il a recours à une eclass pour détecter le type de carte utilisée et ainsi installer la version adéquate.

Remarque
It's always recommended (and good practice) to check the corresponding documentation provided by NVIDIA for the version of the system's installed driver, as that information may be more up-to-date and prevalent for more use cases. If any issues arise, README documentation may come of a great help. The official README documentation for all NVIDIA's drivers can also be found online.

USE flags

USE flags for x11-drivers/nvidia-drivers NVIDIA Accelerated Graphics Driver

+X Add support for X11
+modules Build the kernel modules
+static-libs Install the XNVCtrl static library for accessing sensors and other features
+strip Allow symbol stripping to be performed by the ebuild for special files
+tools Install additional tools such as nvidia-settings
dist-kernel Enable subslot rebuilds on Distribution Kernel upgrades
kernel-open Use the open source variant of the drivers (Turing/Ampere+ GPUs only, aka GTX 1650+ -- recommended with >=560.xx drivers if usable)
modules-compress Install compressed kernel modules (if kernel config enables module compression)
modules-sign Cryptographically sign installed kernel modules (requires CONFIG_MODULE_SIG=y in the kernel)
persistenced Install the persistence daemon for keeping devices state when unused (e.g. for headless)
powerd Install the NVIDIA dynamic boost support daemon (only useful with specific laptops, ignore if unsure)
wayland Enable dev-libs/wayland backend

Open source kernel modules

Remarque
This driver only works on Turing GPUs and newer (i.e. GTX 1650 and newer), as mentioned next to the kernel-open flag above.

In May 2022, Nvidia announced work towards open sourcing their graphics cards' kernel drivers. The driver is hosted on GitHub.

Users can try out the open source driver by enabling the corresponding USE flag:

FILE /etc/portage/package.use
x11-drivers/nvidia-drivers kernel-open

Compatibilité matérielle

Le paquet x11-drivers/nvidia-drivers prend en charge de nombreuses cartes NVIDIA. De multiples versions sont disponibles selon la (les) carte(s) que vous avez. Reportez-vous à la page Qu'est-ce qu'un « Legacy GPU »?,de la documentation officielle de NVIDIA pour déterminer la version du pilote qui doit être utilisée. Un moyen très commode pour la trouver est d'utiliser cet utilitaire. Saisissez le nom de votre carte graphique (en faisant attention à cocher l'option « Legacy » dans le champ produit) et la version la plus adaptée à votre carte s'affichera sous le formulaire.

Si vous avez identifié votre carte comme étant une carte ancienne/obsolete, vous devez masquer les versions plus récentes des pilotes nvidia-drivers,par exemple:

If the card has been identified as a legacy card (470 or lower) then it is highly recommended to either replace the hardware or switch to the nouveau driver, as the official driver is no longer receiving security updates.

It is possible to still use the unsupported driver, if the user is happy with the risks and lack of support by Nvidia and Gentoo:

FILE /etc/portage/package.unmaskUnmask 470 drivers
~x11-drivers/nvidia-drivers-470.256.02


FILE /etc/portage/package.maskMasking drivers with version higher than 470
>x11-drivers/nvidia-drivers-471
Remarque
Change the values to the 390 variants if that driver is the one required.

Installation

Distribution Kernel

When using a distribution kernel (sys-kernel/gentoo-kernel or sys-kernel/gentoo-kernel-bin), building driver support is as simple as adding the following to /etc/portage/make.conf:

FILE /etc/portage/make.confNvidia make.conf example
USE="dist-kernel"

This will trigger the Nvidia driver to automatically rebuild on every kernel update. Restarting is recommended after doing a kernel update.

Conseil
If using GRUB as a bootloader then adding the useflag dbus to /etc/portage/make.conf will also trigger GRUB to update the boot

Noyau

Comme mentionné ci-dessus, le pilote noyau NVIDIA s'installe et fonctionne en lien avec le noyau en service. Il est compilé en tant que module, c'est pourquoi votre noyau doit supporter le chargement de modules (voir ci-dessous).

Le module du noyau (nvidia.ko) comprend une partie propriétaire (communément appelée le « blob ») (Binary Large Object pour Grand Objet Binaire) qui pilote les circuits de votre carte, et une partie Open Source (la  « colle ») qui, en exécution, agit comme intermédiaire entre la partie propriétaire et le noyau. Tout cela doit s’emboîter proprement sous peine de devoir faire face à des pertes de données (via des paniques du noyau, des crash du serveur X sans sauvegarde des données des applications X) et même des pannes matérielles (surchauffe et autres problèmes en relation avec la gestion de l'énergie).

Compatibilité du noyau

De temps à autres, une nouvelle version du noyau modifie les ABI (Interface Binaire d'Applications) des pilotes, ce qui signifie que tous les pilotes qui ont recours à ces ABI doivent être changés. Pour les pilotes Open Source, en particulier ceux distribués avec le noyau, effectuer ces changements est presque trivial, dans la mesure où la chaîne complète des appels entre les pilotes et les autres parties du noyau, peut être passée en revue très facilement. Pour les pilotes propriétaires, comme le nvidia.ko, ce n'est pas la même partie de plaisir. Lorsque les ABI internes changent, vous ne pouvez pas tout simplement adapter la « colle », parce que vous ne savez pas comment cette colle est utilisée par la partie propriétaire. Si vous parvenez à réparer les choses et que tout semble marcher correctement, vous risquez encore, que le lancement de nvidi.ko dans votre noyau, nouveau et non pris en charge, aboutisse à des pertes de données et des pannes matérielles.

Lorsqu'une version nouvelle et incompatible du noyau sort, il est probablement mieux de s'en tenir, pendant un temps, à la version du noyau prise en charge la plus récente. NVIDIA prend ordinairement quelques semaines pour préparer la nouvelle version propriétaire qu'ils jugent adaptée à un usage général. Soyez tout simplement patient. Si c'est vraiment nécessaire, il est possible d'utiliser la commande epatch_user des eutils.eclass avec le ebuild nvidia-drivers : ceci permet à l’utilisateur d'amender nvidia-drivers pour qu'il s'adapte d'une certaine manière à la version non prise en charge du noyau choisie. Bien noter que dans ce cas ni les mainteneurs de nvidia-drivers, ni NVIDIA n'apporteront leur aide en cas de problème. La garantie matérielle sera très vraisemblablement rendue caduque. Les développeurs de Gentoo ne peuvent pas se mettre à régler ces problèmes dans la mesure où il s'agit d'un pilote propriétaire que seul NVIDIA peut déboguer correctement. Par ailleurs, les mainteneurs du noyau (à la fois de Gentoo et de l'amont) ne prendront certainement pas en charge des pilotes propriétaires, ou des systèmes « impurs » qui rencontreraient des problèmes.

Si genkernel all a été utiliser pour configurer le noyau, alors tout est prêt. Dans le cas contraire revérifier la configuration du noyau afin d’être sure que l'option est activé:

KERNEL Enable loadable module support
[*] Enable loadable module support --->

Vous devez aussi activer la prise en charge de MTRR (Memory Type Range Register) dans votre noyau :

KERNEL Activer le support MTRR (CONFIG_MTRR)
Processor type and features --->
   [*] MTRR (Memory Type Range Register) support

With at least some if not all driver versions it may also be required to enable VGA Arbitration and the IPMI message handler:

KERNEL Enable VGA Arbitration (CONFIG_VGA_ARB)
Device Drivers --->
   PCI support --->
      [*] VGA Arbitration
KERNEL Enable IPMI message handler (CONFIG_ACPI_IPMI)
Device Drivers --->
   Character devices --->
      [*] IPMI top-level message handler

De plus, si vous avez une carte graphique AGP, vous pouvez ajouter en option la prise en charge de agpgart à votre noyau, soit incorporée au noyau, soit en tant que module. Si vous ne choisissez pas d'utiliser le module incorporée au noyau de agpgart, alors les pilotes utiliseront leur propre mise en œuvre de agpgart, appelée NvAGP. Sur certains systèmes, cela conduit à de meilleures performances, sur d'autres c'est l'inverse. Vous devrez apprécier cela vous-même sur votre système pour trouver ce qui apporte la meilleure performance. En cas de doute, utilisez la mise en œuvre incorporée au noyau agpgart:

KERNEL Activer le support agpgart (CONFIG_AGP)
Device Drivers --->
   Graphics support --->
      -*- /dev/agpgart (AGP Support) --->
Remarque
Sur amd64, IOMMU gère les réglages agpgart.
Important
Pour les processeurs x86 et AMD64, les pilotes framebuffer internes du noyau génèrent des conflits avec les pilotes binaires de NVIDIA. Avant de compiler le noyau pour ces processeurs, enlever complètement le support pour ces pilotes internes ainsi:
KERNEL Disable support for the in-kernel driver
Device Drivers --->
    Graphics support --->
        Frame buffer Devices --->
            <*> Support for frame buffer devices --->
            < >   nVidia Framebuffer Support
            < >   nVidia Riva support

Maintenant, vérifier que le pilote [nouveau] n'est pas activé :

KERNEL
Device Drivers  --->
    Graphics support  --->
        < > Nouveau (nVidia) cards
KERNEL Disable support for the in-kernel driver (CONFIG_FB_NVIDIA, CONFIG_FB_RIVA)
Device Drivers --->
    Graphics support --->
        Frame buffer Devices --->
            <*> Support for frame buffer devices --->
               < > nVidia Framebuffer Support
               < > nVidia Riva support

Now make sure the nouveau driver is disabled:

KERNEL Disable support for the nouveau driver (CONFIG_DRM_NOUVEAU)
Device Drivers  --->
    Graphics support  --->
        < > Nouveau (nVidia) cards

SimpleDRM must not be built-in (CONFIG_DRM_SIMPLEDRM=y)[1]. Effects of it being enabled might include: no TTY, not working Xorg sessions/Wayland compositors, etc. Nonetheless, it is harmless as a module (CONFIG_DRM_SIMPLEDRM=m).

KERNEL Disable SimpleDRM support (CONFIG_DRM_SIMPLEDRM)
Device Drivers --->
   Graphics support --->
      < > Simple framebuffer driver

A framebuffer driver is required for rendering the Linux console (TTY) as this functionality is not yet provided by the proprietary NVIDIA driver[2][3], i.e. nvidia-drivers, unlike in-tree DRM drivers, rely on other framebuffer drivers to provide Linux console (TTY) support, instead of providing its own. As shown below, set Mark VGA/VBE/EFI FB as generic system framebuffer (CONFIG_SYSFB_SIMPLEFB=y), and then enable a framebuffer driver. Common options for this are to use either efifb (CONFIG_FB_EFI=y) for UEFI devices or vesafb (CONFIG_FB_VESA=y) for BIOS/CSM devices. simplefb (CONFIG_FB_SIMPLE=y|m) may also be chosen, however there are reports of it not working, as there exist reports of it working as well as others; the decision is up to end user to make.

KERNEL Enable framebuffer drivers for the kernel 5.15 and later (CONFIG_SYSFB_SIMPLEFB, CONFIG_FB_VESA, CONFIG_FB_EFI, CONFIG_FB_SIMPLE)
Device Drivers --->
   Firmware Drivers  --->
      [*] Mark VGA/VBE/EFI FB as generic system framebuffer
   Graphics support --->
      Frame buffer Devices  --->
         <*> Support for frame buffer devices  --->
            [*] VESA VGA graphics support
            [*] EFI-based Framebuffer Support 
            <*> Simple framebuffer support

L'ebuild x11-drivers/nvidia-drivers détecte automatiquement la version de votre noyau en se basant sur le lien symbolique /usr/src/linux. Assurez-vous que ce lien symbolique pointe bien sur les bonnes sources et que votre noyau est bien configuré. Reportez-vous à la section "Configurer votre noyau" du Manuel de Gentoo pour une plus ample information sur la manière de configurer votre noyau.

Sélectionner le noyau en utilisant eselect. Par exemple pour utiliser le noyau sys-kernel/gentoo-sources version 3.7.10 le listing du noyau peut apparaître ainsiː

root #eselect kernel list
Available kernel symlink targets:
  [1]   linux-3.7.10-gentoo *
  [2]   linux-3.7.9-gentoo

Dans la liste ci-dessus, notez que le noyau linux-3:7:10-gentoo est marqué d'un astérisque (*) pour montrer qu'il est le noyau pointé par le lien symbolique.

Si le lien symbolique ne pointe pas sur les bonnes sources, actualiser en choisissant le numéro correspondant aux sources du noyau que vous voulez utiliser, comme dans l'exemple ci-dessous.

root #eselect kernel set 1

Kernel GCC plugins

If GCC plugins of the Kernel are enabled compilation of nvidia-drivers will use them. If the compiler version that was used to compile the plugins does not match the nvidia-drivers' compiler an error will occur.

KERNEL Enable GCC plugins (CONFIG_GCC_PLUGINS)
General architecture-dependent options --->
   GCC plugins --->
      ...

This behavior cannot be fixed, see bug #804618 or various forum posts [4] [5] [6]. Using these plugins seems controversial, too [7].

If the problem occurs, re-compile the plugins (in /usr/src/linux):

root #make oldconfig && make prepare

Configuration

Pilotes

Il est temps maintenant d'installer les pilotes. Vous pouvez le faire en suivant les instructions du Guide de configuration du serveur X et en définissant VIDEO_CARDS="nvidia" dans /etc/portage/make.conf. Lors de l'installation du serveur X, il sélectionnera alors la bonne version du pilote x11-drivers/nvidia-drivers pour vous.

Remarque
Les pilotes peuvent être installés en activant l'option gtk de la variable USE dans le fichier /etc/portage/make.conf. Cela installera le paquet media-video/nvidia-settings, un outil pratique pour voir et configurer de nombreux aspects de votre carte NVIDIA.
Important
À chaque mise à jour du noyau ou re-compilation du noyau actuel, vous devez réinstaller les modules du noyau NVIDIA. Une façon aisée de recompiler les modules installés par les ebuilds (tel que x11-drivers/nvidia-drivers) consiste à exécuter emerge @module-rebuild.

Une fois l'installation terminée, exécutez modprobe nvidia pour charger le module du noyau en mémoire. S'il s'agit d'une mise à jour, vous devez préalablement retirer le module précédent.

root #lsmod | grep nvidia
root #rmmod nvidia
root #modprobe nvidia

Signature des modules du noyeau (optionnel)

Remarque
L'information fournie dans cette section est hors propos pour les systèmes qui n'implémente pas la signature des modules du noyeau.Libre a vous de la sauter.

Si la signature du démarrage du noyau est utilisée, alors il faut signer les modules NVIDIA avant qu'ils soient chargés.

Effectuer ceci en utilisant le script fourni par le noyau perl de la façon suivante.

root #perl /usr/src/linux/scripts/sign-file sha512 /usr/src/linux/signing_key.priv /usr/src/linux/signing_key.x509 /lib/modules/Kernel-Version-modules-path/video/nvidia-uvm.ko
root #perl /usr/src/linux/scripts/sign-file sha512 /usr/src/linux/signing_key.priv /usr/src/linux/signing_key.x509 /lib/modules/Kernel-Version-modules-path/video/nvidia.ko

Depuis la version 358.09 du pilote un nouveau module a été créer qui gère le mode setting et pour ces version du pilote ce module doit lui aussi être signer.

root #perl /usr/src/linux/scripts/sign-file sha512 /usr/src/linux/signing_key.priv /usr/src/linux/signing_key.x509 /lib/modules/Kernel-Version-modules-path/video/nvidia-modeset.ko

When using a Wayland compositor or need to use PRIME offload, sign the following two modules:

root #/usr/src/linux/scripts/sign-file sha512 /usr/src/linux/certs/signing_key.pem /usr/src/linux/certs/signing_key.x509 /lib/modules/Kernel-Version-modules-path/video/nvidia-drm.ko
root #/usr/src/linux/scripts/sign-file sha512 /usr/src/linux/certs/signing_key.pem /usr/src/linux/certs/signing_key.x509 /lib/modules/Kernel-Version-modules-path/video/nvidia-peermem.ko

Une fois ces modules signés, le pilote se chargera comme prévu au démarrage. La méthode de signature des modules peut être utilisée pour signer d'autre modules − pas seulement le pilote NVIDIA. Dans ce cas il faut modifier le chemin et le module correspondant en conséquence.

Dracut configuration (optional)

When using Dracut, it may be worthwhile to ensure that the NVIDIA modules are not bundled in the generated ramdisk (initramfs) image. Otherwise, every update may require regeneration of the image.

FILE /etc/dracut.conf.d/nvidia.confDisabling NVIDIA modules in ramdisk
# Omit the nvidia driver from the ramdisk, to avoid needing to regenerate
# the ramdisk on updates.
omit_drivers+=" nvidia nvidia-drm nvidia-modeset nvidia-uvm "

Le serveur X

Once the appropriate drivers are installed, the X server should work without any extra configuration. An example of /etc/X11/xorg.conf for single-GPU systems is provided below.

FILE /etc/X11/xorg.conf.d/nvidia.confExplicit nvidia driver section
Section "Device"
   Identifier  "nvidia"
   Driver      "nvidia"
EndSection

For laptops with integrated Intel graphics card, try the XOrg config as suggested by the NVIDIA/Optimus page.

nvidia-persistenced

NVIDIA packages a daemon called nvidia-persistenced to assist in situations where the tearing down of the GPU device state isn't desired. Typically, the tearing down of the device state is the intended behavior of the device driver. Still, the latencies incurred by repetitive device initialization can significantly impact performance for some applications.

nvidia-persistenced is intended to be run as a daemon from system initialization and is generally designed as a tool for compute-only platforms where the NVIDIA device is not used to display a graphical user interface. Depending on the user's system and its uses, it may not be necessary to set persistenced USE flag.

Currently, Gentoo does not elect to set the persistenced USE flag as default.

Droits d'accès/Permissions

The user(s) needing to access the video card will need to be added to the video group:

root #gpasswd -a larry video

Note that users will be able to run X without permission to the DRI subsystem, but hardware acceleration will be disabled. For Wayland sessions not setting this may result in a very low FPS.

PCI-Express Runtime D3 (RTD3) Power Management

NVIDIA GPUs have many power-saving mechanisms. Some of them will reduce clocks and voltages to different parts of the chip. Sometimes, turning off clocks or power to parts of the chip entirely, without affecting functionality or continuing to function, just at a slower speed.

The NVIDIA Linux driver includes initial experimental support for dynamically managing power to the NVIDIA GPU.

Thus, this feature is available only when the following conditions are satisfied:

  • This feature is supported only on notebooks.
  • This feature requires system hardware as well as ACPI support. The necessary hardware and ACPI support was first added in the Intel Coffeelake chipset series. Hence, this feature is supported from Intel Coffeelake chipset series.
  • This feature requires a Turing or newer GPU (i.e. GTX 1650+).
  • This feature is supported with Linux kernel versions 4.18 and newer. With older kernel versions, it may not work as intended.
  • This feature is supported when Linux kernel defines CONFIG_PM=y. Typically, if the system supports S3 (suspend-to-RAM), then CONFIG_PM would be defined.

Setup

If the user wants to enable this feature, then it's recommended to follow the 'Automated Setup' section in Chapter 22 of the official NVIDIA README documentation. It has also been outlined below for convenience.

Create a file named 80-nvidia-pm.rules in /etc/udev/rules.d/ directory with the following contents:

FILE /etc/udev/rules.d/80-nvidia-pm.rules
# Enable runtime PM for NVIDIA VGA/3D controller devices on driver bind
ACTION=="bind", SUBSYSTEM=="pci", ATTR{vendor}=="0x10de", ATTR{class}=="0x030000", TEST=="power/control", ATTR{power/control}="auto"
ACTION=="bind", SUBSYSTEM=="pci", ATTR{vendor}=="0x10de", ATTR{class}=="0x030200", TEST=="power/control", ATTR{power/control}="auto"

# Disable runtime PM for NVIDIA VGA/3D controller devices on driver unbind
ACTION=="unbind", SUBSYSTEM=="pci", ATTR{vendor}=="0x10de", ATTR{class}=="0x030000", TEST=="power/control", ATTR{power/control}="on"
ACTION=="unbind", SUBSYSTEM=="pci", ATTR{vendor}=="0x10de", ATTR{class}=="0x030200", TEST=="power/control", ATTR{power/control}="on"

The following file needs be added to /etc/modprobe.d/ file to seamlessly enable this feature.

FILE /etc/modprobe.d/nvidia-pm.conf
# Enable RTD3
options nvidia NVreg_DynamicPowerManagement=0x02

More information and other configuration options are documented in Chapter 22 of NVIDIA's README documentation.

Activer le support Global de nVidia

Most NVIDIA GPUs have hardware encoding/decoding. Here is the support matrix. GeForce 8 series and later GPUs have VDPAU superseding legacy XvMCNVIDIA support. Some ebuilds, like media-video/ffmpeg and media-video/obs-studio, have USE flags vdpau and nvenc to enable NVIDIA hardware encoding/decoding.

Il y a également des applications qui ont besoin de l'option nvidia de la variable USE, aussi désirerez-vous peut-être l'ajouter au fichier /etc/portage/make.conf.

Exécutez ensuite emerge -uD --newuse @world pour recompiler les applications qui bénéficient du changement d'option de la variable USE.

root #emerge -uD --newuse @world

Utiliser l'outil de configuration de nVidia

NVIDIA fournit également un outil de configuration. Cet outi permet de voir et de modifier des réglages graphiques sans avoir à redémarrer le serveur X. Il est disponible dans Portage sous le nom media-video/nvidia-settings. Comme indiqué plus haut, il sera automatiquement installé si vous installez les pilotes avec l'option gtk de la variable USE activée, soit dans /etc/portage/make.conf, soit dans /etc/portage/package.use.

Utilisation

Tester la carte

Pour tester votre carte NVIDIA, lancer X et exécuter la commande glxinfo, qui fait partie du paquet x11-apps/mesa-progs. Elle devrait notifier que le rendu direct est activé :

user $glxinfo | grep direct
direct rendering: Yes

Pour contrôler le FPS (nombre de trames par seconde), exécuter glxgears.

Dépannage

Pour une vue d'ensemble des bogues reportés non résolus du paquet x11-drivers/nvidia-drivers, se reporter à Gentoo bugtracker: known bugs.

Random freezes

Freezes can occur for various reasons. Check that:

  • All power saving options turned off in the system firmware setup.
  • Only the original (from installation) driver options card defined in the /etc/modprobe.d/nvidia.conf file.

FATAL: modpost: GPL-incompatible module *.ko uses GPL-only symbol

When the ebuild is complaining about the 'mutex_destroy' GPL-only symbol:

root #emerge x11-drivers/nvidia-drivers
FATAL: modpost: GPL-incompatible module nvidia.ko uses GPL-only symbol 'mutex_destroy' 

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

Le pilote ne s'initialise pas lorsque les interruptions MSI sont activées

Par défaut, le pilote NVIDIA Linux utilise les interruptions signalées par message MSI(Message Signaled Interrupts ). Ceci procure des avantages de compatibilité et d'adaptabilité, principalement parce que cela évite le partage des requêtes d'interruption (IRQ). Quelques systèmes ont été identifiés comme ayant des problèmes de prise en charge des MSI, alors qu'ils fonctionnent bien avec les interruptions câblées virtuelles. Ces problèmes se traduisent par une inaptitude à démarrer le serveur X avec le pilote NVIDIA, ou des échecs dans l'initialisation de la plate-forme de compilation parallèle CUDA de NVIDIA.

Les MSI peuvent être désactivées via le paramètre NVreg_EnableMSI=0 du module NVIDIA du noyau. Ceci peut être défini en ligne de commande au moment du chargement du module, ou de manière plus appropriée via les fichiers de configuration du module du noyau de la distribution (tel que ceux placés dans /etc/modprobe.d/).

Par exemple :

FILE /etc/modprobe.d/nvidia.confSetting nvidia NVreg_EnableMSI
# Nvidia drivers support
alias char-major-195 nvidia
alias /dev/nvidiactl char-major-195
  
# To tweak the driver the following options can be used, note that
# you should be careful, as it could cause instability!! For more 
# options see /usr/share/doc/nvidia-drivers-337.19/README 
#
# !!! SECURITY WARNING !!!
# DO NOT MODIFY OR REMOVE THE DEVICE FILE RELATED OPTIONS UNLESS YOU KNOW
# WHAT YOU ARE DOING.
# ONLY ADD TRUSTED USERS TO THE VIDEO GROUP, THESE USERS MAY BE ABLE TO CRASH,
# COMPROMISE, OR IRREPARABLY DAMAGE THE MACHINE.
options nvidia NVreg_DeviceFileMode=0660 NVreg_DeviceFileUID=0 NVreg_DeviceFileGID=27 NVreg_ModifyDeviceFiles=1 NVreg_EnableMSI=0

Faire fonctionner l'accélération 2D sur des machines possédant 4 GB de mémoire ou plus

Lorsque l'accélération 2D de NVIDIA provoque des problèmes, il est probable que ce soit parce le système ne peut pas définir une plage mémoire associée au mode write-combining pour les MTTR (Memory Type Range Registers). Pour en être sûr, vérifier le contenu de /proc/mtrr:

root #cat /proc/mtrr

Chacune des lignes devrait contenir write-back ou write-combining. Si vous apercevez une ligne avec uncachable vous devez changer un paramètre de votre BIOS pour régler ce problème.

Redémarrez et entrez dans la configuration du BIOS (probablement sous Paramètres du processeur). Changez le paramètre continuous en discrete et redémarrez votre Linux. Vous verrez alors qu'il n'y a plus d'entrée uncachable et que l'accélération 2D fonctionne sans problème.

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

KERNEL Enable MTRR cleanup support
Processor type and features  --->
   [*]   MTRR (Memory Type Range Register) support
   [*]   MTRR cleanup support 
   (0)     MTRR cleanup enable value (0-1) 
   (1)     MTRR cleanup spare reg num (0-7)

Failed to initialize DMA on Ryzen

Disable AMD Secure Memory Encryption[8]:

KERNEL Disable AMD Secure Memory Encryption (SME) support
Processor type and features  --->
   [ ]   AMD Secure Memory Encryption (SME) support

Lors du chargement du module du noyau, apparition du message no such device

Ceci est généralement dû à un des problèmes suivants :

  1. Le système n'a pas de carte NVIDIA. Vérifier le résultat de la commande lspci pour confirmer qu'une carte graphique NVIDIA est installée et reconnue.
  2. La version installée du pilote x11-drivers/nvidia-drivers ne supporte pas le modèle de carte installée. Vérifier le README /usr/share/nvidia-drivers-*/ pour une liste de cartes supportées, ou utiliser la recherche de pilote à http://www.geforce.com/drivers.
  3. Un autre pilote du noyau contrôle la carte. Vérifier lspci -k si un autre pilote tel que nouveau est lié a la carte graphique. Dans ce cas, désactiver ou blacklister ce pilote.

Le rendu direct n'est pas activé

Si le rendu direct ne fonctionne pas, c'est peut-être parce que le DRI ou Direct Rendering Manager (gestionnaire de rendu direct) est activé dans le noyau, et qu'il entre en conflit avec le pilote. Vous pouvez vérifier l'état du rendu direct en suivant les instructions de la section Tester la carte.

Tout d'abord, désactivez le gestionnaire de rendu direct (CONFIG_DRM) dans le noyau :

KERNEL Désactivez le gestionnaire de rendu direct(DRI)
Device drivers --->
    Graphics support --->
        < > Direct Rendering Manager (XFree86 4.1.0 and higher DRI support)

Puis recompilez les pilotes x11-drivers/nvidia-drivers car le pilote peut avoir été compilé avec les symboles DRM du noyau. Cela devrait régler le problème.

Vidéo saccadée ou lente

Dernièrement, il semble qu'il y ait des problèmes avec certains types de vidéo avec le pilote NVIDIA binaire, ayant pour résultat des lenteur dans la lecture vidéo ou des "bégaiement". Ce problème semble survenir avec le Intel CPU Idle replacement plutôt que la méthode commune ACPI CPU idling pour certains microprocesseurs.

Désactiver la méthode CPU idling d'Intel en utilisant intel_idle.max_cstate=0 dans la commande de démarrage du noyau, ce qui doit avoir pour résultat l'utilisation automatique par le noyau de l'ancienne méthode ACPI pour la veille du CPU. De même, désactiver NVIDIA Powermizer, ou régler Powermizer à la performance maximum avec nvidia-settings peut aider à résoudre les problèmes. Bien que la méthode CPU idling d'Intel a été récemment introduite comme méthode par défaut pour les processeurs i5 et i7 (en lieu et place d'ACPI), c'est ici la source du problème. Cette méthode résout de façon significative le problème, cependant des "bégaiements" ou lenteurs de la vidéo apparaissent si le désentrelacement a été activé ; c'est le cas quand la vidéo a probablement déjà été désentrelacée (par exemple, alias mplayer-nodeint et quelque chose de similaire pour mplayer -vo vdpau:deint=0:denoise=0:nochroma-deint:colorspace=0:hqscaling=1, video.mpg comme solution.)

If using GRUB as the bootloader, add this kernel parameter to /etc/default/grub like so:

FILE /etc/default/grubAdding intel_idle.max_cstate kernel parameter in GRUB
GRUB_CMDLINE_LINUX_DEFAULT="intel_idle.max_cstate=0"

Don't forget to run grub-mkconfig -o /boot/grub/grub.cfg after making the change, so that the new configuration is generated (see the GRUB article for further details).

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

user $cat /sys/module/intel_idle/parameters/max_cstate
0

No HDMI Output/Video/Sound

This problem tended to occur whenever the HDMI hub device turned-off for a period of time, or the computer was started with an HDMI hub device turned off.

First, find the PCI device ID, using lspci.

When this problem occurs, substitute the PCI ID within the following command for rescanning the PCI bus:

root #echo on > /sys/bus/pci/devices/0000\:06\:00.0/power/control

This avoides disable runtime power management for PCI function 0, placing this PCI bus always on.

Pas de synchronisation verticale (no VSync, tearing) dans les applications OpenGL

Ajouter les options suivante dans la section écran pour éviter le tearing (déchirure) on GTX 660, 660 Ti, et probablement d'autre GPUs (référence):

FILE /etc/X11/xorg.conf
Section "Screen"
     . . .
    Option         "metamodes" "nvidia-auto-select +0+0 { ForceFullCompositionPipeline = On }"
     . . .
EndSection

udevd using 100% of the CPU, X server failed to start

Workaround available in bug #670340 comment #8

Distorted white lines during early boot

If nothing but a black screen with distorted white lines appears right after the kernel and initramfs is loaded, try disabling CONFIG_SYSFB_SIMPLEFB and all framebuffer device drivers except CONFIG_FB_EFI.

ERROR: Kernel configuration is invalid.

When building nvidia-drivers, a message could appear like:

root #emerge x11-drivers/nvidia-drivers
...
* Preparing nvidia module
make -j8 HOSTCC=x86_64-pc-linux-gnu-gcc 'LDFLAGS=-m elf_x86_64' NV_VERBOSE=1 IGNORE_CC_MISMATCH=yes SYSSRC=/usr/src/linux SYSOUT=/usr/src/linux modules 
make[1]: Entering directory '/usr/src/linux-5.15.23-gentoo'
test -e include/generated/autoconf.h -a -e include/config/auto.conf || (		\
echo >&2;							\
echo >&2 "  ERROR: Kernel configuration is invalid.";		\
echo >&2 "         include/generated/autoconf.h or include/config/auto.conf are missing.";\
echo >&2 "         Run 'make oldconfig && make prepare' on kernel src to fix it.";	\
echo >&2 ;							\
/bin/false)

This is not an error but the code logic that checks for this error. Therefore, the kernel configuration is in fact not invalid.

Plymouth can't find nvidia-uvm module

When using systemd, it may be worth considering adding the following configuration to /etc/modprobe.d to ensure that nvidia-uvm is loaded as a soft dependency of the nvidia module. This helps prevent an error that happens when the configuration file is added to the initrd but not the nvidia-uvm module; causing an error on Plymouth about not being able to find the nvidia-uvm module.

This may not be required unless specifically using Dracut, systemd, and observe the error produced by Plymouth (not finding nvidia-uvm) in the logs.

FILE /etc/modprobe.d/nvidia-uvm.confMake nvidia-uvm a soft dependency of the nvidia module (on systemd)
# Make a soft dependency for nvidia-uvm as adding the module loading to
# /usr/lib/modules-load.d/nvidia-uvm.conf for systemd consumption, makes the
# configuration file to be added to the initrd but not the module, throwing an
# error on plymouth about not being able to find the module.
# Ref: /usr/lib/dracut/modules.d/00systemd/module-setup.sh

# Even adding the module is not the correct thing, as we don't want it to be
# included in the initrd, so use this configuration file to specify the
# dependency.

softdep nvidia post: nvidia-uvm

Wayland GLAMOR (weird keyboard typing bug)

Symtoms: weird keyboard behavior when trying, it deletes and redraw the characters.

Affected: xwayland apps, i noticed it especially on discord and skype

Workaround:

XWAYLAND_NO_GLAMOR=1

Enable this envvar and it will disable GLAMOR, will take more resources but the issue won't occur anymore. you can just add it to /etc/environment file. more information in the gitlab link.

  • notice: disabling glamor causes wine-proton games to work a lot slower and there are reports of steam for linux not even starting.

API mismatch

Symptoms: API mismatch can cause launching GPU accelerated applications to fail to launch. It can also cause external displays which are connected via a discrete NVIDIA graphics card to be detected, but not be enabled or activated (the screen will show up in xrandr, but will refuse to display output - the display will stay in low power mode.).

Detection: This problem can be detected using a few different methods:

1. Compare the currently loaded kernel module version with the currently available userspace management utilities.

Kernel module check:

user $modinfo nvidia | grep version | head -n 1
version:        515.65.01

Userspace utility version:

user $nvidia-settings --version | grep version
nvidia-settings:  version 520.56.06

Observe in the previous command output there is a difference in the patch versions: 515.65.01 vs 515.65.06.

2. Something like the following message will be written to the dmesg log:

user $dmesg
[  337.995427] NVRM: API mismatch: the client has the version 520.56.06, but
               NVRM: this kernel module has the version 515.65.01.  Please
               NVRM: make sure that this kernel module and all NVIDIA driver
               NVRM: components have the same version.
[  339.048386] [drm:nv_drm_dumb_map_offset [nvidia_drm]] *ERROR* [nvidia-drm] [GPU ID 0x00000100] Failed to lookup gem object for mapping: 0x00000006
[  339.048400] [drm:nv_drm_dumb_map_offset [nvidia_drm]] *ERROR* [nvidia-drm] [GPU ID 0x00000100] Failed to lookup gem object for mapping: 0x00000007

3. The post-install ebuild log output also includes logic to detect for the API mismatch and instructions for the solution:

user $emerge @module-rebuild
>>> Installing (1 of 1) x11-drivers/nvidia-drivers-520.56.06::gentoo
 * >>> SetUID: [chmod go-r] /usr/bin/nvidia-modprobe ...                                                                             [ ok ]
 * Removing x11-drivers/nvidia-drivers-520.56.06 from moduledb.
 * Updating module dependencies for 6.0.5-gentoo-x86_64 ...                                                                          [ ok ]
 * Adding module to moduledb.
 * Currently loaded NVIDIA modules do not match the newly installed
 * libraries and may prevent launching GPU-accelerated applications.
 * The easiest way to fix this is usually to reboot

Cause: API mismatch occurs when the nvidia kernel modules are of a different version than the userspace utilities. This occurs when a full system reboot is not performed after an nvidia-drivers package the update.

Solution: The simplest solution is to perform a full system reboot.

Configuration expert

Documentation

Le paquet du pilote nVidia x11-drivers/nvidia-drivers est fourni avec une documentation exhaustive. Elle est installée dans /usr/share/doc et peut être lue en utilisant la commande suivante :

user $less /usr/share/doc/nvidia-drivers-*/README.bz2

Paramètres du module du noyau

Le module du noyau nvidia reconnaît un certain nombre de paramètres (options) qui peuvent être utiliser pour peaufiner le comportement du pilote. La plupart d'entre-eux sont mentionnés dans la documentation. Pour ajouter des paramètres, ou pour en changer la valeur, éditez le fichier /etc/modprobe.d/nvidia.conf. Pensez à exécuter la commande update-modules après avoir modifié ce fichier, et n'oubliez pas que vous devrez recharger le module nvidia pour que les nouveaux paramètres soient pris en compte.

Attention !
Pay close attention to this section as these kernel options can enable features that the hardware may or may not support. These options are not forgiving, so be careful with the parameters. Do not make any changes without validating and double-checking that the change is needed.
Attribute Default Description
NVreg_DeviceFileUID 0 Modify the user ID for the device file. The default value sets it to the root user. Setting this to another user ID will make the driver module create the device file with access available to that user ID.
NVreg_DeviceFileGID 27 Modify the Group ID for the device file. The default value sets it to the video group.
NVreg_DeviceFileMode Undefined Set the permissions for the device file. A value of 0660 grants the owner and group-owner read-write access while other users cannot access the device file.
NVreg_ModifyDeviceFiles 1 Instruct the driver to enable or disable dynamic device file management.
NVreg_EnablePCIeGen3 0 Enable PCIe Gen 3.x support. If the system supports this 8GT high speed bus then enable it with this module option flag. When this is enabled but the system does not support Gen 3.0, the behavior of the system can become irratic and unstable. Some have even reported damage to hardware enabling this when it is not properly supported. By default the Nvidia driver is set to use PCIe Gen 2.x for compatibility reasons.
NVreg_UsePageAttributeTable 0 This is one of the latest and newest additions to the Nvidia driver modules option. It allows the driver to take full advantage of the PAT technology - a newer way of allocating memory, replacing the older Memory Type Range Register (MTRR) method. The PAT method creates a partition type table at a specific address mapped inside the register and utilizes the memory architecture and instruction set more efficiently and faster. If the computer supports PAT and the feature is enabled in the kernel then this flag can be enabled. Without PAT support, users may experience unstable performance and even crashes if this is enabled. So be careful with these options.
NVreg_EnableVia4x 0 Enable AGP 4x mode in the the NVIDIA driver on Via-chipset-powered systems. Some of these hardware configurations would not work properly in AGP 4x mode when others would. The default leaves it at AGP 2x mode.
NVreg_EnableALiAGP 0 On ALi1541 and ALi1647 chipsets, AGP support is by default disabled by the NVIDIA drivers. The value specifies the speed factor to use, so the values 1, 2, 4 and 8 represent AGP 1x, 2x, 4x and 8x respectively. NVIDIA does not recommend changing the value as it may lead to unstable systems.
NVreg_ReqAGPRate Unspecified Forces the AGP mode on the driver. For instance, a value of 1 means AGP 1x, while a value of 4 means AGP 4x.
NVreg_NvAGP Changes the AGP Gart mode setting. Possible values are: 0 (Disable), 1 (Enable using NVIDIAs internal AGP-Gart), 2 (Enable using the Linux kernel AGP-Gart) and 3 (Enable and use any available, but try th NVIDIA internal one first).
NVreg_EnableAGPSBA 0 Disables (0) or enables (1) AGP Side Banding. For stability reasons, the setting is by default disabled, but the setting can be enabled for testing and debugging purposes. This is not supported by NVIDIA though.
NVreg_EnableAGPFW 0 Enables AGP Fast-Writes when set to 1. Depending on the system's chipset this may cause stability issues if enabled.
NVreg_Mobile 0 Through this setting, users can force the EDID information for particular systems. This workaround is provided for mobile GPU's where EDID information is either non-functional or disabled. Potential values are 0 (Auto detection of the correct setting), 1 (Dell notebooks), 2 (non-Compaq Toshiba laptops), 3 (All other notebooks/laptops), 4 (Compaq Toshiba laptops) or 5 (Gateway machines).
NVreg_RemapLimit 60 Maximum amount of system memory remapping. It specifies the amount of memory that the driver will be allowed to remap through the IOMMU/SWIOTLB on a 64-bit system. Only use it if the IOMMU or SMIOTLB is larger than 64mb. NVIDIA recommends to subtract 4mb from the total amount of memory to use. For instance, the default value is 60 which is in fact 64mb. To set it to 128mb, set the value to 124.
NVreg_UpdateMemoryTypes 0 Tweak the use of page table attributes. Possible values are: 0 (Nvidias logic mechanism), 1 (Enable the use of changed page table attributes) and 2 (Disable the use of page table attributes).
NVreg_InitializeSystemMemoryAllocations 1 Tell the NVIDIA driver to clear system memory allocations prior to using it for the GPUs. Disabling can give a slight performance boost but at the cost of increased security risks. By default the driver will wipe the allocated by zeroing out its content.
NVreg_UseVBios 1 Enable or disable the use of the video BIOS int10 code. Set to 0 to disable.
NVreg_RMEdgeIntrCheck Unspecified Enable or disable checking for edge-triggered interrupts.
NVreg_EnableMSI 1 Enable or disable PCIe-MSI capabilities. Enable this to use MSI interrupts instead of wired interrupts.
NVreg_MapRegistersEarly 0 If set to 1, allow the driver to map the memory locations early when the system is probing the hardware instead of the default option of doing this when loaded by modprobe or during startx. This is a debugging feature.
NVreg_RegisterForACPIEvents 1 Enable the driver to register with the ACPI of the system to receive ACPI events. This can be disabled (0) when issues occur with ACPI or while debugging an issue.
NVreg_EnableGpuFirmware Varies Enable or disable use of GSP firmware. Turing and later GPUs include a GPU System Processor (GSP) which can be used to offload GPU initialization and management tasks. When using GSP firmware, the driver will not yet correctly support display-related features or power management related features. These features will be added to GSP firmware in future driver releases.

Éditer /etc/modprobe.d/nvidia.conf:

root #update-modules

Décharger le module nvidia

root #modprobe -r nvidia

...et rechargez-le :

root #modprobe nvidia

Configuration avancée de X

La couche GLX possède aussi une pléthore d'options. Elles contrôlent la configuration de la sortie TV, du double-écran, contrôle la détection de fréquence, etc. Là-encore, les options disponibles sont expliquées en détail dans la documentation.

Pour utiliser ces options, vous devez les lister dans la section périphérique ad hoc de votre fichier de configuration de X (en général /etc/X11/xorg.conf.d/nvidia.conf). Par exemple, pour désactiver le logo de démarrage :

FILE /etc/X11/xorg.confDisable the splash logo
Section "Device"
  Identifier "nVidia Inc. GeForce2"
  Driver     "nvidia"
  Option     "NoLogo" "true"
  VideoRam   65536
EndSection

Voir aussi

Remerciements

Nous tenons à remercier les auteurs et éditeurs suivants pour leur contribution à ce guide :Sven Vermeulen, Joshua Saddler, M Curtis Napier, Chris Gianelloni et José Fournier.

References


This page is based on a document formerly found on our main website gentoo.org.
The following people contributed to the original document: Sven Vermeulen (SwifT) , M Curtis Napier, and Chris Gianelloni
They are listed here because wiki history does not allow for any external attribution. If you edit the wiki article, please do not add yourself here; your contributions are recorded on each article's associated history page.