MODPROBE

Section: Manuel de l'administrateur Linux (8)
Updated: 12 avril 2000
Index Retour au Menu Principal

NOM

modprobe - Manipulations haut niveau de modules chargeables.

SYNOPSIS

modprobe [ -adnqv ] [ -C config ] module [ symbole=valeur ... ]
modprobe [ -adnqv ] [ -C config ] [ -t type ] pattern
modprobe -l [ -C config ] [ -t type ] pattern
modprobe -c [ -C config ]
modprobe -r [ -dnv ] [ -C config ] [ module ...]
modprobe -V

OPTIONS

-a, --all: Charge tous les modules au lieu de s'arrêter après le premier chargement réussi.
-c, --showconfig: Affiche la configuration courante.
-d, --debug: Affiche des informations à propos du fonctionnement interne de l'ensemble des modules concernés.
-k, --autoclean: Rend 'autoclean' ([NdT] décharger automatiquement quand on ne s'en sert plus) le (ou les) module(s) chargé(s). Utilisé par le noyau quand on appelle modprobe pour satisfaire les dépendances manquantes. L'option -q est sous-jacente lors de l'utilisation de l'option -k. Cette option sera directement envoyée à insmod.
-l, --list: Affiche les modules chargeables.
-n, --show: Ne rien faire en réalité, indiquer juste ce qui devrait être fait.
-q, --quiet: N'explique pas pourquoi insmod échoue. Poursuit de façon normale, mais sans affichage, avec d'autres possibilités pour tester. Cette option sera directement envoyée à insmod.
-r, --remove: Enlève le module (ou l'ensemble) ou exécute un 'autoclean' ([NdT] retire les modules inutilisés), en fonction des modules présents dans la ligne de commande.
-s, --syslog: Crée un rapport via syslog plutôt que via stderr. Cette option sera directement envoyée à insmod.
-t, --type moduletype: Ne prend en considération que les modules de ce type (tag).
-v, --verbose: Affiche toutes les commandes comme elles sont exécutées.
-V, --version: Affiche le numéro de version de modprobe.
-C, --config configfile: Utilise le fichier de configuration configfile plutôt que (l'optionnel) /etc/modules.conf pour le paramétrage. La variable d'environnement MODULECONF peut être aussi utilisée pour sélectionner (et écrire) un fichier de configuration différent du fichier par défaut /etc/modules.conf (ou /etc/conf.modules (à éviter)).

DESCRIPTION

Les utilitaires modprobe et depmod rendent le noyau Linux modulaire plus facilement gérable pour tous les utilisateurs, administrateurs et les développeurs de distribution.

modprobe utilise un fichier de type "Makefile" pour les dépendances, créé par depmod, pour charger automatiquement les modules dépendants de l'ensemble des modules disponibles dans les répertoires prédéfinis.

modprobe sert à charger un ensemble de modules, un seul module, les modules dépendants, ou tous les modules marqués par une étiquette spécifique.

modprobe chargera automatiquement la base de modules nécessaire à un ensemble, comme décrit dans le fichier de dépendances modules.dep. Si un chargement échoue, la totalité des modules chargés par la commande sera déchargée automatiquement.

modprobe a deux façons pour charger des modules. La première (le mode d'essai) essaiera de charger un module de la liste (définie par pattern). modprobe arrête le chargement dès qu'un modules est chargé avec succès. Cela peut être utilisé pour charger automatiquement un pilote de carte ethernet parmi d'autres.
Sinon, modprobe peut charger tous les modules d'une liste. Voir les EXEMPLES ci dessous.

Avec l'option -r, modprobe déchargera automatiquement l'ensemble des modules, de la même façon qu'en utilisant rmmod -r. On peut noter que modprobe -r seul fera le ménage parmi les modules inutilisés et lancera les commandes de pré- et de post-enlèvement dans le fichier de configuration /etc/modules.conf.

Avec l'option -l combinée avec l'option -t une liste de tous les modules disponibles d'un type donné sera affichée.

L'option -c affichera la configuration courante (par défaut et le fichier de configuration).

CONFIGURATION

Le comportement de modprobe (et de depmod) peut être modifié par le fichier (optionnel) de configuration /etc/modules.conf.
Pour une description plus détaillée de ce que peut contenir ce fichier, ainsi que la configuration par défaut de depmod et de modprobe, voir modules.conf(5).

Note : les commandes de pré- et de post-enlèvement ne seront pas exécutées si un module est déchargé par kerneld (car ce module est marqué 'autoclean') ! Voir plutôt le support imminent des modules persistants.
Si vous voulez utiliser les caractéristiques de pré et de post-installation, vous devez enlever l'option 'autoclean' pour kerneld et plutôt mettre une commande dans votre "crontab" (c'est utilisé par les systèmes kmod); pour effectuer un rafraîchissement toutes les deux minutes :

*/2 * * * * test -f /proc/modules && /sbin/modprobe -r

STRATÉGIE

L'idée est que modprobe regardera en premier dans le répertoire contenant les modules compilés pour la version spécifique du noyau en cours d'exécution (/lib/modules/2.2.12-20/ par exemple). Si le module n'est pas trouvé ici, modprobe ira dans le répertoire commun de la version du noyau (ex. 2.0, 2.2).

Quand vous installez un nouveau noyau, les modules sont déplacés dans le répertoire relatif à la version spécifique (et à la version générale) du noyau que vous installez. Alors vous devez créer un lien symbolique de ce répertoire vers le répertoire par défaut.

Chaque fois que vous compilez un nouveau noyau, la commande make modules_install créera un nouveau répertoire, mais ne change pas le lien par défaut.

Quand vous avez un module non relié à la distribution du noyau vous devez le mettre dans un des répertoires indépendants de la version sous /lib/modules.

C'est la stratégie par défaut. On peut passer outre avec /etc/modules.conf.

EXEMPLES

modprobe -t net: Charge un des modules qui sont stockés dans le répertoire étiqueté "net". Chaque module est essayé jusqu'à réussite.
modprobe -a -t boot: Tous les modules qui sont dans les répertoires étiquetés boot seront chargés.
modprobe slip: Cela tentera de charger le module slhc.o si il n'a pas déjà été chargé, car le module slip a besoin de fonctionnalités du module slhc. Cette dépendance est décrite dans le fichier "modules.dep" qui est créé automatiquement par depmod
modprobe -r slip: déchargera le module slip. Il enlèvera aussi le module slhc automatiquement, s'il n'est pas utilisé par d'autres modules bien sûr (comme ppp).

FICHIERS

/etc/modules.conf, (aussi mais à éviter: /etc/conf.modules)
/lib/modules/*/modules.dep,
/lib/modules/*

VOIR AUSSI

depmod(8), lsmod(8), kerneld(8), ksyms(8), rmmod(8), modules(2).

UTILITAIRES REQUIS

depmod(8), insmod(8).

NOTES

Le motif pattern fourni à modprobe aura souvent besoin d'être actualisé pour s'assurer que la recherche se fait dans un contexte clair.

AUTEURS

Jacques Gelinas (jack@solucorp.qc.ca)
Bjorn Ekwall (bj0rn@blox.se)

TRADUCTION

Jérome Signouret, 2000.

Time: 09:49:24 GMT, December 26, 2004

Les Man Linux en français sur jp.barralis.com

Les MANs Linux en français...