.\" -*- coding: UTF-8 -*-
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.nh
.ad l
.\" Begin generated content:
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH MODPROBE 8 "26 août 2024" kmod modprobe
.PP
.SH NOM
.PP
modprobe – Ajouter et enlever des modules du noyau Linux
.PP
.SH SYNOPSIS
.PP
\fBmodprobe\fP [\fB\-v\fP] [\fB\-V\fP] [\fB\-C\fP \fIfichier_config\fP] [\fB\-n\fP] [\fB\-i\fP] [\fB\-q\fP] [\fB\-b\fP] [\fInom_du_module\fP]
         [\fImodule paramètres\fP.\&.\&.\&]
.PP
\fBmodprobe\fP [\fB\-r\fP] [\fB\-v\fP] [\fB\-n\fP] [\fB\-i\fP] [\fInom_du_module\fP.\&.\&.\&]
.PP
\fBmodprobe\fP [\fB\-c\fP]
.PP
\fBmodprobe\fP [\fB\-\-dump\-modversions\fP] [\fInom_du_fichier\fP]
.PP
.SH DESCRIPTION
.PP
\fBmodprobe\fP ajoute ou supprime intelligemment un module du noyau Linux : à
noter que pour plus de commodité, il n'y a pas de différences entre \fB_\fP et
\fB\-\fP dans les noms de module (la conversion automatique du tiret bas est
effectuée).\& \fBmodprobe\fP 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
\fBmodprobe.\&d\fP(5)).\& \fBmodprobe\fP 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>.\&
.PP
Notez que contrairement aux séries 2.\&4 des noyaux Linux (qui ne sont pas
prises en charge par cet outil), cette version de \fBmodprobe\fP 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 \fBdmesg\fP(8)).\&
.PP
\fBmodprobe\fP attend un fichier \fImodules.\&dep.\&bin\fP à jour comme généré par
l'utilitaire correspondant \fBdepmod\fP fourni avec \fBmodprobe\fP (voir
\fBdepmod\fP(8)).\& Ce fichier liste quels sont les autres modules nécessaires
à chaque module (s'il y en a), et \fBmodprobe\fP l'utilise pour ajouter ou
supprimer ces dépendances automatiquement.\&
.PP
Si des paramètres sont donnés après le \fInom_du_module\fP, ils sont passés au
noyau (en supplément de toute option listée dans le fichier de
configuration).\&
.PP
Lors du chargement des modules, \fInom_du_module\fP 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'usage d'un chemin
vers un module avec des dépendances qui ne correspondent pas à la base de
données de \fBdepmod\fP installée.\&
.PP
.SH OPTIONS
.PP
\fB\-a\fP \fB\-\-all\fP
.RS 4
Inscrire tous les noms de modules sur la ligne de commande.\&
.PP
.RE
\fB\-b\fP \fB\-\-use\-blacklist\fP
.RS 4
Cette option commande à \fBmodprobe\fP d'appliquer aussi les commandes
\fBblacklist\fP dans les fichiers de configuration (si présents) aux noms de
module.\& Cela est habituellement utilisé par \fBudev\fP(7).\&
.PP
.RE
\fB\-C\fP \fIrépertoire\fP \fB\-\-config\fP \fIrépertoire\fP
.RS 4
Cette option écrase le répertoire de configuration par défaut.\& Voir
\fBmodprobe.\&d\fP).\&
.PP
Cette option est passée à l'aide des commandes \fBinstall\fP ou \fBremove\fP aux
autres commandes \fBmodprobe\fP dans la variable d'environnement
MODPROBE_OPTIONS.\&
.PP
.RE
\fB\-c\fP \fB\-\-showconfig\fP
.RS 4
Afficher la configuration effective du répertoire de configuration et
quitter\&.
.PP
.RE
\fB\-\-dump\-modversions\fP
.RS 4
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.\&
.PP
.RE
\fB\-d\fP \fB\-\-dirname\fP
.RS 4
Répertoire racine pour les modules, par défaut \fB/\fP.\&
.PP
.RE
\fB\-\-first\-time\fP
.RS 4
Normalement, \fBmodprobe\fP 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
\fBmodprobe\fP a réellement fait quelque chose : cette option fait échouer
\fBmodprobe\fP si en réalité il n'a rien fait.\&
.PP
.RE
\fB\-\-force\-vermagic\fP
.RS 4
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
évidement, cette vérification est là pour vous protéger, aussi utiliser
cette option est dangereux à moins de savoir ce que vous faites.\&
.PP
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.\&
.PP
.RE
\fB\-\-force\-modversion\fP
.RS 4
Lorsque les modules sont compilés avec un ensemble CONFIG_MODVERSIONS, 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 \fB\-\-force\-modversion\fP 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.\&
.PP
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.\&
.PP
.RE
\fB\-f\fP \fB\-\-force\fP
.RS 4
Essayer d’élaguer toute information sur la version du module qui pourrait
empêcher son chargement : cette option équivaut à utiliser à la fois
\fB\-\-force\-vermagic\fP et \fB\-\-force\-modversion\fP.\& Naturellement, ces
vérifications sont là pour vous protéger, aussi utiliser cette option est
dangereux à moins de savoir ce que vous faites.\&
.PP
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.\&
.PP
.RE
\fB\-i\fP \fB\-\-ignore\-install\fP \fB\-\-ignore\-remove\fP
.RS 4
Cette option force \fBmodprobe\fP à ignorer les commandes \fBinstall\fP et
\fBremove\fP (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 \fBinstall\fP et \fBremove\fP 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) de
\fB\-\-ignore\-install\fP ou \fB\-\-ignore\-remove\fP.\& Voir \fBmodprobe.\&d\fP(5).\&
.PP
.RE
\fB\-n\fP, \fB\-\-dry\-run\fP, \fB\-\-show\fP
.RS 4
Cette option fait tout sauf ajouter ou supprimer réellement les modules (ou
exécuter les commandes \fBinstall\fP ou \fBremove\fP).\& Combinée à \fB\-v\fP, elle
est pratique pour déboguer les problèmes.\& Pour des raisons historiques,
\fB\-\-dry\-run\fP et \fB\-\-show\fP signifient vraiment la même chose et sont
interchangeables.\&
.PP
.RE
\fB\-q\fP \fB\-\-quiet\fP
.RS 4
Avec cet argument, \fBmodprobe\fP 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 \fBinstall\fP/\fBremove\fP).\& Cependant, il
renverra un code 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.\&
.PP
.RE
\fB\-R\fP \fB\-\-resolve\-alias\fP
.RS 4
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.\&
.PP
.RE
\fB\-r\fP \fB\-\-remove\fP
.RS 4
Avec cette option, \fBmodprobe\fP supprime un module au lieu d’en ajouter un.\&
Si les modules dont dépend ce dernier sont aussi inusités, \fBmodprobe\fP
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).\&
.PP
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.\&
.PP
.RE
\fB\-w\fP \fITIMEOUT_MSEC\fP \fB\-\-wait\fP \fITIMEOUT_MSEC\fP
.RS 4
Cette option oblige \fBmodprobe \-r\fP à 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.\&
\fBmodprobe\fP 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.\&
.PP
.RE
\fB\-S\fP \fIversion\fP \fB\-\-set\-version\fP \fIversion\fP
.RS 4
Définir la version du noyau au lieu d'utiliser \fBuname\fP(2) pour décider de
la version du noyau (qui dicte où trouver les modules).\&
.PP
.RE
\fB\-\-show\-depends\fP
.RS 4
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
\fBinstall\fP qui sont appliquées sont montrées avec le préfixe « install ».\&
Cette option n'exécute aucune commande \fBinstall\fP.\& Notez que \fBmodinfo\fP(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 \fBinstall\fP.\&
.PP
.RE
\fB\-s\fP \fB\-\-syslog\fP
.RS 4
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.\&
.PP
Cette option est passée à l'aide des commandes \fBinstall\fP ou \fBremove\fP aux
autres commandes \fBmodprobe\fP dans la variable d'environnement
MODPROBE_OPTIONS.\&
.PP
.RE
\fB\-V\fP \fB\-\-version\fP
.RS 4
Afficher la version du programme et quitter.\&
.PP
.RE
\fB\-v\fP \fB\-\-verbose\fP
.RS 4
Afficher des messages à propos de ce que fait le programme.\& Habituellement
\fBmodprobe\fP n'affiche des messages que si quelque chose se déroule mal.\&
.PP
Cette option est passée à l'aide des commandes \fBinstall\fP ou \fBremove\fP aux
autres commandes \fBmodprobe\fP dans la variable d'environnement
MODPROBE_OPTIONS.\&
.PP
.RE
.SH ENVIRONNEMENT
.PP
La variable d'environnement MODPROBE_OPTIONS peut aussi être utilisée pour
passer des arguments à \fBmodprobe\fP.\& Le format n'est pas documenté
intentionnellement, dans la mesure où l'utilisation d'outils et de scripts
tiers est déconseillée\&
.PP
La variable d'environnement provient de l'implémentation des règles
d'installation.\&
.PP
.SH COPYRIGHT
.PP
Cette page de manuel était originellement sous copyright 2002, Rusty
Russell, IBM Corporation.\&
.PP
.SH "VOIR AUSSI"
.PP
\fBmodprobe.\&d\fP(5), \fBinsmod\fP(8), \fBrmmod\fP(8), \fBlsmod\fP(8), \fBmodinfo\fP(8),
\fBdepmod\fP(8)
.PP
.SH AUTEURS
.PP
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
\fBgit\-shortlog\fP(1) et de \fBgit\-blame\fP(1) vous indiquerons les auteurs de
certaines parties du projet.\&
.PP
\fBLucas De Marchi\fP <lucas.\&de.\&marchi@gmail.\&com> est le
responsable actuel du projet.\&
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
bubu <bubub@no-log.org>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .