Provided by: manpages-fr_4.27.0-1_all 
NOM
modprobe – Ajouter et enlever des modules du noyau Linux
SYNOPSIS
modprobe [-v] [-V] [-C fichier_config] [-n] [-i] [-q] [-b] [nom_du_module]
[module paramètres...]
modprobe [-r] [-v] [-n] [-i] [nom_du_module...]
modprobe [-c]
modprobe [--dump-modversions] [nom_du_fichier]
DESCRIPTION
modprobe ajoute ou supprime intelligemment un module du noyau Linux : à noter que pour plus de commodité,
il n'y a pas de différences entre _ et - dans les noms de module (la conversion automatique du tiret bas
est effectuée). modprobe cherche dans le répertoire des modules /usr/lib/`uname -r` tous les modules et
autres fichiers, excepté les fichiers de configuration facultatifs dans le répertoire (voir
modprobe.d(5)). modprobe utilisera aussi les options de module indiquées sur la ligne de commande du
noyau sous la forme <module>.<option> et mettra sous liste noire sous la forme
modprobe.blacklist=<module>.
Notez que contrairement aux séries 2.4 des noyaux Linux (qui ne sont pas prises en charge par cet outil),
cette version de modprobe ne fait rien au module lui-même : le travail de résoudre les symboles et de
comprendre les paramètres est fait à l'intérieur du noyau. Ainsi un échec du module est parfois
accompagné d'un message du noyau (voir dmesg(8)).
modprobe attend un fichier modules.dep.bin à jour comme généré par l'utilitaire correspondant depmod
fourni avec modprobe (voir depmod(8)). Ce fichier liste quels sont les autres modules nécessaires à
chaque module (s'il y en a), et modprobe l'utilise pour ajouter ou supprimer ces dépendances
automatiquement.
Si des paramètres sont donnés après le nom_du_module, ils sont passés au noyau (en supplément de toute
option listée dans le fichier de configuration).
Lors du chargement des modules, nom_du_module peut aussi être un chemin vers le module. Si le chemin est
relatif, il doit explicitement commencer avec « ./ ». Notez que cela peut échouer lors de l'utilisation
d'un chemin vers un module avec des dépendances qui ne correspondent pas à la base de données de depmod
installée.
OPTIONS
-a, --all
Inscrire tous les noms de modules sur la ligne de commande.
-b, --use-blacklist
Cette option commande à modprobe d'appliquer aussi les commandes blacklist dans les fichiers de
configuration (si présents) aux noms de module. Cela est habituellement utilisé par udev(7).
-C répertoire, --config=répertoire
Cette option écrase le répertoire de configuration par défaut. Voir modprobe.d).
Cette option est passée à l'aide des commandes install ou remove aux autres commandes modprobe dans
la variable d'environnement MODPROBE_OPTIONS.
-c, --showconfig
Afficher la configuration effective extraite du répertoire de configuration et quitter.
--dump-modversions
Afficher la liste des informations relatives à la version du module requise par un module. Cette
option est communément utilisée par les distributions pour empaqueter un module du noyau Linux en
utilisant des dépendances versionnées du module.
-d, --dirname
Répertoire racine pour les modules, par défaut /.
--first-time
Normalement, modprobe réussira (et ne fera rien) s'il lui est demandé d'insérer un module qui est
déjà présent ou d'enlever un module qui n'est pas présent. C'est idéal pour les scripts simples ;
néanmoins, il y a davantage de scripts plus compliqués qui veulent souvent savoir si modprobe a
réellement fait quelque chose : cette option fait échouer modprobe si en réalité il n'a rien fait.
--force-vermagic
Tous les modules contiennent une petite chaîne contenant des informations importantes, telles que les
versions du compilateur et du noyau. Si un module échoue à charger et si le noyau se plaint que le
« version magic » ne correspond pas, vous pouvez utiliser cette option pour l'enlever. Bien
évidemment, cette vérification est là pour vous protéger, aussi utiliser cette option est dangereux à
moins de savoir ce que vous faites.
Cela s'applique à chaque module ajouté : à la fois le module (ou son alias) sur la ligne de commande
et chaque module dont il dépend.
--force-modversion
Lorsque les modules sont compilés avec CONFIG_MODVERSIONS défini, une section détaillant les
versions de chaque interface utilisée par (ou fournie par) le module est créée. Si un module échoue
au chargement et si le noyau se plaint que le module est en désaccord au sujet de la version d'une
interface, vous pouvez utiliser --force-modversion pour supprimer toutes les informations de version.
Bien entendu, cette vérification est là pour votre sécurité, aussi utiliser cette option est
dangereux à moins de savoir ce que vous faites.
Cela s'applique à chaque module ajouté : à la fois le module (ou son alias) sur la ligne de commande
et chaque module dont il dépend.
-f, --force
Essayer d’élaguer toute information sur la version du module qui pourrait empêcher son chargement :
cette option équivaut à utiliser à la fois --force-vermagic et --force-modversion. Naturellement, ces
vérifications sont là pour vous protéger, aussi utiliser cette option est dangereux à moins de savoir
ce que vous faites.
Cela s'applique à chaque module ajouté : à la fois le module (ou son alias) sur la ligne de commande
et chaque module dont il dépend.
-i, --ignore-install, --ignore-remove
Cette option force modprobe à ignorer les commandes install et remove (si présentes) du fichier de
configuration pour le module spécifié sur la ligne de commande (les modules dépendants étant toujours
sujets aux commandes qui leur sont attribuées dans le fichier de configuration). À la fois install et
remove seront actuellement ignorées lorsque cette option est utilisée sans se préoccuper si la
demande a été spécifiquement faites seulement avec l'une ou l'autre (et non les deux) des options
--ignore-install ou --ignore-remove. Voir modprobe.d(5).
-n, --dry-run, --show
Cette option fait tout sauf ajouter ou supprimer réellement les modules (ou exécuter les commandes
install ou remove). Combinée à -v, elle est pratique pour déboguer les problèmes. Pour des raisons
historiques, --dry-run et --show signifient vraiment la même chose et sont interchangeables.
-q, --quiet
Avec cet argument, modprobe n'affichera pas de message d'erreur si vous essayez de supprimer ou
d'ajouter un module qu'il ne peut pas trouver (et qui n'est pas un alias ou la commande
install/remove). Cependant, il renverra quand même un code de retour différent de zéro. Le noyau s'en
sert pour rechercher de manière opportuniste des modules qui peuvent exister en utilisant
request_module.
-R, --resolve-alias
Afficher tous les noms de module correspondant à un alias. Cette option s’avère utile pour déboguer
les problèmes d'alias de module.
-r, --remove
Avec cette option, modprobe supprime un module au lieu d’en ajouter un. Si les modules dont dépend ce
dernier sont eux aussi inutilisés, modprobe essaiera de les supprimer aussi. Contrairement à l'ajout,
plus d'un module peut être indiqué sur la ligne de commande (il est inutile de spécifier les
paramètres du module pour l'enlever).
Il n'y a généralement pas de raison pour supprimer un module, mais certains modules bogués le
nécessitent. Le noyau de votre distribution n'a peut-être pas été construit pour prendre en charge la
suppression de modules.
-w TIMEOUT_MSEC, --wait=TIMEOUT_MSEC
Cette option oblige modprobe -r à continuer à essayer de supprimer un module s'il n'a pas réussi, car
le module était occupé, c'est-à-dire que son comptage de références est différent de 0 au moment de
l'appel. modprobe tente de supprimer le module avec un temps d'attente incrémental entre chaque
tentative jusqu'au temps d'attente maximal indiqué en millisecondes dans cette option.
-S version, --set-version=version
Définir la version du noyau au lieu d'utiliser uname(2) pour décider de la version du noyau (qui
dicte où trouver les modules).
--show-depends
Lister les dépendances d'un module (ou d'un alias), incluant le module lui-même. Cette option produit
un ensemble (possiblement vide) de noms de fichier de module, un par ligne, chacun commençant avec
« insmod » et est typiquement utilisé par les distributions pour déterminer quels modules inclure
lors de la génération des images initrd/initramfs. Les commandes install qui sont appliquées sont
montrées avec le préfixe « install ». Cette option n'exécute aucune commande install. Notez que
modinfo(8) peut être utilisé pour extraire les dépendances d'un module depuis le module lui-même,
mais ne sait rien des alias ou des commandes install.
-s, --syslog
Cette option oblige tous les messages d'erreur à passer à travers le mécanisme syslog (comme
LOG_DAEMON avec le niveau LOG_NOTICE) plutôt que vers l'erreur standard. Cette option est activée
automatiquement lorsque stderr n'est pas disponible.
Cette option est passée à l'aide des commandes install ou remove aux autres commandes modprobe dans
la variable d'environnement MODPROBE_OPTIONS.
-V, --version
Afficher la version du programme et quitter.
-v, --verbose
Afficher des messages à propos de ce que fait le programme. Habituellement modprobe n'affiche des
messages que si quelque chose se déroule mal.
Cette option est passée à l'aide des commandes install ou remove aux autres commandes modprobe dans
la variable d'environnement MODPROBE_OPTIONS.
ENVIRONNEMENT
La variable d'environnement MODPROBE_OPTIONS peut aussi être utilisée pour passer des arguments à
modprobe. Le format n'est pas documenté intentionnellement, dans la mesure où l'utilisation d'outils et
de scripts tiers est déconseillée
La variable d'environnement provient de l'implémentation des règles d'installation.
COPYRIGHT
Cette page de manuel était originellement sous copyright 2002, Rusty Russell, IBM Corporation.
VOIR AUSSI
modprobe.d(5), insmod(8), rmmod(8), lsmod(8), modinfo(8), depmod(8)
BOGUES
Merci d'envoyer les rapports de bogues directement au suivi des bogues de kmod à
https://github.com/kmod-project/kmod/issues/ avec la version utilisée, les étapes pour reproduire le
bogue et le retour espéré.
AUTEURS
De nombreuses contributions proviennent de la liste de diffusion linux-modules
<linux-modules@vger.kernel.org> et de Github. Si vous avez une copie de kmod.git lui-même, les sorties de
git-shortlog(1) et de git-blame(1) vous indiquerons les auteurs de certaines parties du projet.
Lucas De Marchi <lucas.de.marchi@gmail.com> est le responsable actuel du projet.
TRADUCTION
La traduction française de cette page de manuel a été créée par bubu <bubub@no-log.org>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License
version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à
debian-l10n-french@lists.debian.org.
kmod 25 avril 2025 MODPROBE(8)