modprobe [ -v] [ -V] [ -C fichier-de-configuration] [ -n] [ -i] [ -q] [ -o nom-du-module] [nom-du-module] [ paramètres du module...]
modprobe [-r] [ -v] [ -n] [ -i] [ nom-du-module...]
modprobe [-l] [-t nom-du-répertoire] [ -a] [ wildcard]
modprobe [-c]
modprobe charge et décharge intelligemment un module du Noyau Linux : notez que par commodité, il n'y a pas de différence entre _ et - dans les noms des modules. modprobe regarde dans le répertoire des modules /lib/modules/`uname -r` pour tous les fichiers modules et autres, à l'exception du fichier de configuration optionnel /etc/modprobe.conf (voir modprobe.conf(8)).
Notez que cette version de modprobe ne fait rien par elle-même directement sur le module : le travail de résolution des symboles et de compréhension des paramètres s'effectue dans le noyau. Aussi un problème dans un module est parfois accompagné d'un message noyau : voir dmesg(8).
modprobe s'attend à trouver un fichier modules.dep à jour, tel qu'il est généré par depmod (voir depmod(8)). Ce fichier liste quels autres modules sont nécessaires (s'il y en a), et modprobe les utilise pour ajouter ou enlever ces dépendances automatiquement. Voir modules.dep(8)).
Si tous les arguments sont donnés après le nom-du-module, ils sont passés au noyau (en plus de toutes les options listées dans le fichier de configuration).
Affiche les messages sur ce que sont en train de faire les programmes. Généralement modprobe affiche simplement des messages si quelque chose tourne mal.
Cette option est passée via les commandes install ou remove aux autres commandes modprobe dans la variable d'environnement MODPROBE_OPTIONS.
Cette option remplace le fichier de configuration par défaut (/etc/modprobe.conf).
Cette option est passée via les commandes install ou remove aux autres commandes modprobe dans la variable d'environnement MODPROBE_OPTIONS.
Affiche le fichier de configuration et quitte.
Cette option fait tout, sauf l'ajout ou la suppression des modules (ou exécuter les commandes install ou remove). L'utilisation conjointe de -v , est pratique pour les problèmes de débogage.
Cette option a pour effet d'ignorer les commandes ignore et install de modprobe dans le fichier de configuration (s'il existe), pour le module sur la ligne de commandes (tous les modules qui en dépendent sont toujours sujets aux commandes qui leurs sont propres dans le fichier de configuration). Voir modprobe.conf(5).
Normalement modprobe va signaler une erreur si vous essayez d'enlever ou d'ajouter un module qu'il ne peut pas trouver (et qu'il n'y a pas non plus d'alias ou de commande install/remove). Avec ce drapeau, modprobe va simplement ignorer tous les noms erronés (le noyau utilise cela de façon opportuniste pour sonder les modules qui pourraient exister).
Cette option indique à modprobe d'enlever, plutôt que d'ajouter un module. Si les modules dont il dépend sont également inutilisés, modprobe essayera également de les enlever. Tout comme l'ajout, on peut spécifier plusieurs modules sur une ligne de commandes (cela n'aurait pas de sens de spécifier les paramètres d'un module lors du retrait d'un module).
Il n'y a généralement aucune raison d'enlever des modules, mais quelques modules bogués le nécessitent. Votre noyau peut ne pas supporter le retrait des modules.
Affiche la version du programme et quitte. Regardez ci-dessous pour les particularités lorsqu'il fonctionne sur des vieux noyaux.
Essaye de ne pas tenir compte des informations sur la version du module, ce qui dans d'autres circonstances empêcherait son chargement : c'est similaire à l'utilisation conjointe de --force-vermagic et --force-modversion . Naturellement, ces contrôles existent pour votre protection, aussi utiliser ces options n'est pas sans danger.
Cela s'applique à tous les modules ajoutés : à la fois le module (ou alias) sur la ligne de commande, et tous les modules dont il dépend.
Chaque module possède une petite chaîne de caractères contenant des informations importantes, telles que les versions du noyau et du compilateur. Si un module ne peut être chargé et que le noyau signale que la « version magic » ne correspond pas, vous pouvez utiliser cette option pour l'enlever. Naturellement, ce contrôle est là pour votre protection, aussi enlever cette option n'est pas sans danger.
Cela s'applique à tous les modules ajoutés : à la fois le module (ou alias) sur la ligne de commande, et tous les modules dont il dépend.
Lorsque les modules sont compilés avec l'option CONFIG_MODVERSIONS, une section est créée détaillant les versions de chaque interface qui a été utilisée (ou fournie) par le module. Si un module ne peut être chargé et que le noyau signale que le module n'est pas d'accord au sujet de la version d'une quelconque interface, vous pouvez utiliser « --force-modversion » pour enlever l'ensemble des informations de versions. Naturellement, ce contrôle est là pour votre protection, aussi l'utilisation de cette option n'est pas sans danger.
Cela s'applique à tous les modules ajoutés : à la fois le module (ou alias) sur la ligne de commande, et tous les modules dont il dépend.
Liste tous les modules correspondant à la wildcard qui est donnée (ou « * » si aucune wildcard n'est fournie). Cette option est fournie pour des raisons de compatibilité ascendante : voyez find(1) et basename(1) pour une alternative plus étendue.
Insère tous les modules correspondant à la wilcard donnée. Cette option est fournie pour des raisons de compatibilité ascendante : voyez find(1) et basename(1) pour une alternative plus étendue.
Restreint -l ou -a au module dans le répertoire correspondant au nom-du-répertoire donné. Cette option est fournie pour des raisons de compatibilité ascendante : voyez find(1) et basename(1) ou plus une alternative plus étendue.
Cette option permet que chaque message d'erreur soit transmis au mécanisme syslog (en tant que LOG_DAEMON avec le niveau LOG_NOTICE) plutôt que sur la sortie standard. Elle est automatiquement activée lorsque stderr est indisponible.
Cette option est passée via les commandes install ou remove aux autres commandes modprobe dans la variable d'environnement MODPROBE_OPTIONS.
Définie la version du noyau, plutôt que d'utiliser uname(2) pour déterminer la version du noyau (ce qui détermine où trouver les modules). Cela désactive les contrôles de compatibilité ascendante (si bien que modprobe.old(8) ne sera jamais exécuté).
Liste les dépendances d'un module (ou alias), en incluant le module lui-même. Cela produit un ensemble de noms de module (éventuellement vide), un par ligne. Il ne lance aucune commande install qui pourrait s'appliquer. Notez que modinfo(8) peut être utilisé pour extraire les dépendances d'un module à partir du module lui-même, mais il ne connaît rien des alias.
Cette option essaye de renommer le module qui est en train d'être inséré dans le noyau. Quelques modules de test peuvent heureusement être insérés à de nombreuses reprises, mais le noyau refusera d'avoir deux modules de même noms. Normalement, les modules ne devraient pas avoir besoin d'ajouts multiples, étant donné que cela les rendrait inutiles si aucun autre module ne les supporte.
Normalement, modprobe va réussir (et ne rien faire) si on lui demande d'ajouter un module qui est déjà présent, ou enlever un module qui n'est pas présent. C'est pour assurer une compatibilité ascendante avec modutils, et c'est idéal pour des scripts simplistes. Cependant, des scripts plus complets voudront généralement connaître si modprobe a réellement fait quelque chose : cette option fait en sorte que modprobe échoue dans ce cas précis.
Cette version de modprobe est pour les noyaux 2.5.48 ou supérieurs. S'il détecte un noyau avec un support de l'ancien type de modules (pour lesquels la majorité du travail se faisait dans le mode utilisateur), il va essayer de lancer modprobe.old à la place, ainsi il est complètement transparent pour l'utilisateur.