Lea Linux - Contributions [fr]

Kernel-modules

2008-11-05T11:14:15Z

Ondelettes : /* Où se trouvent-ils ? */ langue

[[Category:Configurer votre noyau]]
= Les modules de Linux =

<div class="leatitre">Les modules de Linux</div><div class="leapar">par Jean-Christophe</div><div class="leadesc">Comment fonctionnent ces mystérieux modules ?</div>
----

Si vous ne savez pas ce que sont les modules, allez voir le glossaire !

== A quoi ça sert ? ==

; Bon, puisque vous n'avez pas été lire le glossaire, voici la définition qui en est donnée :
: Les modules sont une façon qui a été trouvée pour rendre Linux (le noyau) plus modulaire (!) et plus léger. En effet, ce sont le plus souvent des pilotes qui ont été "sortis" du noyau dans des fichiers séparés, et qui sont chargés en mémoire, soit automatiquement lorsqu'on se sert du périphérique concerné, soit manuellement. Ils permettent de réduire la taille mémoire utilisée par le noyau lui-même. Le concept de modules permet aussi d'ajouter des pilotes de périphériques au système sans devoir recompiler le noyau.

Bon, c'est clair il me semble (normal, c'est moi qui ai écrit ça ;). Les modules permettent aussi d'ajouter des pilotes distribués uniquement sous forme binaire ; on ne peut pas les recompiler, mais on peut s'en servir (ce qui est assez intéressant finalement ;). Les modules ne sont pas que des pilotes, d'une façon générale, ça peut être tout morceau de code qu'on a décidé d'externaliser par rapport au noyau, comme bien sûr un pilote, mais aussi un protocole de communication (par ex. <tt>ppp</tt>) ou n'importe quoi d'autre.

== Où se trouvent-ils ? ==

Ils résident dans <tt>/lib/modules/version_du_noyau</tt>. exemple : <tt>/lib/modules/2.4.17</tt>.

Ce répertoire contient les dossiers suivants qui permettent de séparer les modules selon leur type : <br />

<center>

{| border="BORDER"
| <tt>block/</tt>
| périphériques de type bloc
|-
| <tt>fs/</tt>
| systèmes de fichier (FAT, ext2, etc.)
|-
| <tt>misc/</tt>
| périphériques divers (carte tuner TV, port parallèle, carte son, joystick, etc.)
|-
| <tt>net/</tt>
| pilotes des cartes réseaux et protocoles
|-
| <tt>scsi/</tt>
| périphériques SCSI
|-
| <tt>cdrom/</tt>
| pilotes CDROM non IDE (anciens CD-ROMs)
|-
| <tt>ipv4/</tt><br /><tt>ipv6/</tt>
| protocole IP v4 et v6(protocole réseau)
|-
| <tt>pcmcia/</tt>
| modules pour gérer les cartes PCMCIA
|-
| <tt>video/</tt>
| gestion des cartes video en console, framebuffer
|}

</center>

Ce répertoire peut contenir d'autres dossiers, plus un fichier nommé <tt>modules.dep</tt>, qui contient les dépendances entre modules (le module parport_ide à besoin du module parport, etc.). Ce fichier est généralement regénéré à chaque boot par la commande <code>depmod -a</code> placée dans les scripts de démarrage.

== Comment ajouter des modules, les recompiler ? ==

=== Modules livrés avec le noyau ===

Si vous avez compilé votre noyau vous même et que vous désirez ajouter un module livré avec le noyau, il faut éditer la configuration du noyau, cocher l'option <code>M</code> voulue dans la config du noyau, puis enregistrer la configuration noyau et compiler le tout : <br/>
<code># make && su -c 'make modules_install'</code><br/>
(voir aussi la rubrique [[Kernel-kernel|noyau]])

=== Modules livrés en dehors du noyau ===

Parfois, des modules peuvent être trouvés en dehors de l'arborescence des sources du noyau. Par exemple, vous pouvez télécharger un driver pour certains winmodems (hé oui ça arrive !!!) sur [http://www.o2.net/~gromitkc/winmodem.html cette page]. <br />Certains de ces modules sont livrés sous forme binaire, on peut alors s'en servir tel quels (<code>insmod -f ./le_module</code>). D'autres sont livrés sous forme source sous license GPL ou non ; il faut d'abord les compiler (lisez la doc fournie avec ; cela nécessite en général d'avoir installé les sources du noyau).

=== Prise en compte des nouveaux modules ===

Pour que les modules nouvellement installés soient pris en compte, si ce sont des modules "hors noyau", il est bon de les copier dans <tt>/lib/modules/version_du_noyau/misc</tt> (pour les modules "noyau", la commande <code>make modules_install</code> fait ça) <br />Il faut aussi faire un : <br /><code># depmod -a</code><br />Cette commande remet à jour le fichier <tt>modules.dep</tt>, en fonction du ou des nouveaux modules. <br />Ainsi, vous pourrez charger le module par <code>modprobe le_module</code>.

→ Plus d'infos dans la page man de <tt>depmod</tt>

== Comment les manipuler ? ==

Avec les programmes <code>lsmod</code>, <code>insmod</code>, <code>rmmod</code> et <code>modprobe</code> qui se situent dans <tt>/sbin</tt>.

* <code>lsmod</code> : voir quels modules sont chargés à l'heure actuelle. Cette commande affiche la liste des modules chargés, les dépendances entre les modules chargés, et dit si les modules sont utilisés ou non.
* <code>insmod module</code> : charger un module en mémoire. Si <code>module</code> est spécifié sans extension (en général <code>.o</code>), <code>insmod</code> cherchera le module dans des répertoires par défaut, en général <tt>/lib/module/version_du_noyau</tt>. Sinon, il faut donner le chemin où trouver le module. (Par exemple : <code>insmod -f ./module.o</code> ; le <code>-f</code> permet de forcer le chargement d'un module qui a été compilé avec une version du noyau différente de celle du noyau qui tourne actuellement.)
* <code>rmmod module</code> : décharger un module, où <code>module</code> est le nom donné par <code>lsmod</code>.
* <code>modprobe</code> : exécuter les commandes <code>insmod</code> et <code>rmmod</code> à votre place. <code>modprobe le_module</code> charge <tt>le_module</tt> en mémoire ainsi que tous les modules dont il dépend (en lisant le fichier <tt>modules.dep</tt>). <code>modprobe -r le_module</code> enleve <tt>le_module</tt> de la mémoire, ainsi que tous les modules dont il dépend, sauf s'ils sont utilisés par un autre module bien sûr.

→ Plus d'infos dans les pages man de <tt>lsmod</tt>, <tt>insmod</tt>, <tt>rmmod</tt> et <tt>modprobe</tt>.

== Comment faire pour les charger automatiquement ? ==

=== Chargeur dynamique pour les noyaux 2.4 et antérieurs ===

Tout ça c'est bien beau, mais si à chaque fois avant de regarder la télé, il faut faire <code>modprobe bttv</code>, ou si à chaque fois qu'on veut lancer Xracer il faut faire <code>modprobe 3dfx</code>, ça va vite devenir fastidieux.

Ce qu'on veut, c'est que le bon module se charge lorsqu'on utilise le périphérique (<tt>/dev/le_periph</tt>) correspondant. C'est simple. Il faut indiquer au chargeur de modules que pour acceder à ce périphérique il doit charger le module <tt>le_module</tt>. Cela se fait via son fichier de configuration <tt>/etc/modules.conf</tt> (pour les versions de modutils antérieures à 2.3.5-1, ce fichier s'appelle <tt>/etc/conf.modules</tt>).

Pour qu'un module soit chargé automatiquement, faire : <br /><code># ls -l /dev/le_periph</code><br />qui affiche une ligne ressemblant à : <br/><tt>crw------- 1 user group '''<u>144</u>''', ''<u>12</u>'' May 25 2000 /dev/le_periph</tt><br/>
Pour chaque ligne est affiché :
* Un numéro majeur (ici '''144''') : il identifie le pilote du périphérique,
* Un numéro mineur (ici '''12''') : il sert à différencier les périphériques utilisant un même pilote.

Editez le fichier <tt>/etc/modules.conf</tt> dans votre éditeur de texte préféré et ajoutez une ligne : <br/><code>alias char-major-144 le_module</code><br/>en remplaçant bien sûr <code>144</code> par votre numéro, et <code>le_module</code> par votre module. <br/>Par exemple, pour charger le module gérant la carte 3dfx, j'ai dans mon <tt>modules.conf</tt> la ligne suivante : <br /><code>alias char-major-107 3dfx</code>

; <u>Remarque</u> :
: Il existe des aliases prédéfinis pour remplacer <tt>char-major-xxx</tt> pour les périphériques courants : <tt>eth0</tt> pour la première carte ethernet (<tt>eth1</tt> pour la suivante, etc.), <tt>parport_lowlevel</tt> pour le port parallèle, <tt>sound</tt> pour la carte son, <tt>midi</tt> pour la partie midi de la carte son, etc.

Si votre module a besoin d'options, par exemple pour connaître une adresse ou une interruption, vous pouvez aussi ajouter une ligne du type : <br /><code>options le_module irq=5 dma=0 dma2=1 mpu_io=0x388 io=0x370</code><br/>Chaque module a ses propres options, reportez-vous à la documentation de votre module afin de les connaître.

Enfin, si vous voulez lancer une commande avant ou après que le module soit chargé en mémoire, vous pouvez ajouter une ligne du type : <br/><code>pre-install le_module la_commande</code>, ou : <br/><code>post-install le_module la_commande</code>

→ Plus d'infos dans la page man de <tt>modules.conf</tt>

==== Chargeur dynamique de modules sur Debian ====

Debian juge que l'édition du fichier <tt>modules.conf</tt> par l'utilisateur est trop risquée. A la place, elle propose d'éditer des fichiers dans le répertoire <tt>/etc/modutils/</tt>. Ces fichiers ont la même syntaxe que <tt>modules.conf</tt>. Il existe trois fichiers par défault :
* <tt>/etc/modutils/actions</tt> : regroupe toutes les actions sur les modules,
* <tt>/etc/modutils/aliases</tt> : regroupe tous les alias,
* <tt>/etc/modutils/paths</tt> : regroupe tous les chemins.
Une fois les fichiers mis à jour, la commande <code>update-modules</code> lit les fichiers présents dans <tt>/etc/modutils/</tt> et regénère <tt>modules.conf</tt>.

→ Plus d'infos dans la page man de <tt>update-modules</tt>

=== Chargeur dynamique pour les noyaux 2.6 et à venir ===

Le fichier <tt>/etc/modules.conf</tt> ne sert plus et le fichier <tt>/etc/modprobe.conf</tt> est utilisé à la place. Sa syntaxe est une simplification de la syntaxe de <tt>modules.conf</tt>. Par exemple, à la place de
<code>pre-install le_module une_commande_1
post-install le_module une_commande_2</code>
on aura
<code>install le_module une_commande_1; modprobe --ignore-install le_module;une_commande_2</code>

→ Plus d'infos dans la page man de <tt>modprobe.conf</tt>

=== Chargeur statique de modules ===

Il est possible de charger un module au démarrage de Linux en ajoutant une ligne avec le nom du module dans le fichier <tt>/etc/modules</tt>. Cependant, on perd l'intérêt de la modularité puisqu'il est chargé même s'il n'est pas utilisé.

Voilà, c'est tout, maintenant lorsqu'un programme utilisera le periphérique, plus besoin de charger le module à la main, cela se fera automatiquement.

; <u>Remarque</u> :
: on peut faire des tas de choses "intéressantes" avec les modules, allez voir [http://www.safenetworks.com/Linux/modules.html cette page] par exemple... En résumé, si vous êtes un paranoïaque de la sécurité, n'utilisez pas les modules et compilez-vous un noyau complètement monolithique sans chargeur de modules (merci à [http://www.bruhat.net BooK] pour l'info).

<div class="merci">Cette page est issue de la documentation 'pré-wiki' de Léa et a été convertie avec HTML::WikiConverter. Elle fut créée par Jean-Christophe Cardot le 25/05/2000.</div>

= Copyright =
Copyright © 25/05/2000, Jean-Christophe Cardot
{{CC-BY-NC-SA}}

Kernel-modules

2008-11-05T11:12:19Z

Ondelettes : /* A quoi ça sert ? */ langue

[[Category:Configurer votre noyau]]
= Les modules de Linux =

<div class="leatitre">Les modules de Linux</div><div class="leapar">par Jean-Christophe</div><div class="leadesc">Comment fonctionnent ces mystérieux modules ?</div>
----

Si vous ne savez pas ce que sont les modules, allez voir le glossaire !

== A quoi ça sert ? ==

; Bon, puisque vous n'avez pas été lire le glossaire, voici la définition qui en est donnée :
: Les modules sont une façon qui a été trouvée pour rendre Linux (le noyau) plus modulaire (!) et plus léger. En effet, ce sont le plus souvent des pilotes qui ont été "sortis" du noyau dans des fichiers séparés, et qui sont chargés en mémoire, soit automatiquement lorsqu'on se sert du périphérique concerné, soit manuellement. Ils permettent de réduire la taille mémoire utilisée par le noyau lui-même. Le concept de modules permet aussi d'ajouter des pilotes de périphériques au système sans devoir recompiler le noyau.

Bon, c'est clair il me semble (normal, c'est moi qui ai écrit ça ;). Les modules permettent aussi d'ajouter des pilotes distribués uniquement sous forme binaire ; on ne peut pas les recompiler, mais on peut s'en servir (ce qui est assez intéressant finalement ;). Les modules ne sont pas que des pilotes, d'une façon générale, ça peut être tout morceau de code qu'on a décidé d'externaliser par rapport au noyau, comme bien sûr un pilote, mais aussi un protocole de communication (par ex. <tt>ppp</tt>) ou n'importe quoi d'autre.

== Où se trouvent-ils ? ==

Ils résident dans <tt>/lib/modules/version_du_noyau</tt>. exemple : <tt>/lib/modules/2.4.17</tt>.

Ce répertoire contient les dossiers suivants qui permettent de séparer les modules selon leur type : <br />

<center>

{| border="BORDER"
| <tt>block/</tt>
| périphériques de type bloc
|-
| <tt>fs/</tt>
| systèmes de fichier (FAT, ext2, etc.)
|-
| <tt>misc/</tt>
| périphériques divers (carte tuner TV, port parallèle, carte son, joystick, etc.)
|-
| <tt>net/</tt>
| drivers des cartes réseaux et protocoles
|-
| <tt>scsi/</tt>
| périphériques SCSI
|-
| <tt>cdrom/</tt>
| drivers CDROM non IDE (anciens CD-ROMs)
|-
| <tt>ipv4/</tt><br /><tt>ipv6/</tt>
| protocole IP v4 et v6(protocole réseau)
|-
| <tt>pcmcia/</tt>
| modules pour gérer les cartes PCMCIA
|-
| <tt>video/</tt>
| gestion des cartes video en console, framebuffer
|}

</center>

Ce répertoire peut contenir d'autres dossiers, plus un fichier nommé <tt>modules.dep</tt>, qui contient les dépendances entre modules (le module parport_ide à besoin du module parport, etc.). Ce fichier est généralement regénéré à chaque boot par la commande <code>depmod -a</code> placée dans les scripts de démarrage.

== Comment ajouter des modules, les recompiler ? ==

=== Modules livrés avec le noyau ===

Si vous avez compilé votre noyau vous même et que vous désirez ajouter un module livré avec le noyau, il faut éditer la configuration du noyau, cocher l'option <code>M</code> voulue dans la config du noyau, puis enregistrer la configuration noyau et compiler le tout : <br/>
<code># make && su -c 'make modules_install'</code><br/>
(voir aussi la rubrique [[Kernel-kernel|noyau]])

=== Modules livrés en dehors du noyau ===

Parfois, des modules peuvent être trouvés en dehors de l'arborescence des sources du noyau. Par exemple, vous pouvez télécharger un driver pour certains winmodems (hé oui ça arrive !!!) sur [http://www.o2.net/~gromitkc/winmodem.html cette page]. <br />Certains de ces modules sont livrés sous forme binaire, on peut alors s'en servir tel quels (<code>insmod -f ./le_module</code>). D'autres sont livrés sous forme source sous license GPL ou non ; il faut d'abord les compiler (lisez la doc fournie avec ; cela nécessite en général d'avoir installé les sources du noyau).

=== Prise en compte des nouveaux modules ===

Pour que les modules nouvellement installés soient pris en compte, si ce sont des modules "hors noyau", il est bon de les copier dans <tt>/lib/modules/version_du_noyau/misc</tt> (pour les modules "noyau", la commande <code>make modules_install</code> fait ça) <br />Il faut aussi faire un : <br /><code># depmod -a</code><br />Cette commande remet à jour le fichier <tt>modules.dep</tt>, en fonction du ou des nouveaux modules. <br />Ainsi, vous pourrez charger le module par <code>modprobe le_module</code>.

→ Plus d'infos dans la page man de <tt>depmod</tt>

== Comment les manipuler ? ==

Avec les programmes <code>lsmod</code>, <code>insmod</code>, <code>rmmod</code> et <code>modprobe</code> qui se situent dans <tt>/sbin</tt>.

* <code>lsmod</code> : voir quels modules sont chargés à l'heure actuelle. Cette commande affiche la liste des modules chargés, les dépendances entre les modules chargés, et dit si les modules sont utilisés ou non.
* <code>insmod module</code> : charger un module en mémoire. Si <code>module</code> est spécifié sans extension (en général <code>.o</code>), <code>insmod</code> cherchera le module dans des répertoires par défaut, en général <tt>/lib/module/version_du_noyau</tt>. Sinon, il faut donner le chemin où trouver le module. (Par exemple : <code>insmod -f ./module.o</code> ; le <code>-f</code> permet de forcer le chargement d'un module qui a été compilé avec une version du noyau différente de celle du noyau qui tourne actuellement.)
* <code>rmmod module</code> : décharger un module, où <code>module</code> est le nom donné par <code>lsmod</code>.
* <code>modprobe</code> : exécuter les commandes <code>insmod</code> et <code>rmmod</code> à votre place. <code>modprobe le_module</code> charge <tt>le_module</tt> en mémoire ainsi que tous les modules dont il dépend (en lisant le fichier <tt>modules.dep</tt>). <code>modprobe -r le_module</code> enleve <tt>le_module</tt> de la mémoire, ainsi que tous les modules dont il dépend, sauf s'ils sont utilisés par un autre module bien sûr.

→ Plus d'infos dans les pages man de <tt>lsmod</tt>, <tt>insmod</tt>, <tt>rmmod</tt> et <tt>modprobe</tt>.

== Comment faire pour les charger automatiquement ? ==

=== Chargeur dynamique pour les noyaux 2.4 et antérieurs ===

Tout ça c'est bien beau, mais si à chaque fois avant de regarder la télé, il faut faire <code>modprobe bttv</code>, ou si à chaque fois qu'on veut lancer Xracer il faut faire <code>modprobe 3dfx</code>, ça va vite devenir fastidieux.

Ce qu'on veut, c'est que le bon module se charge lorsqu'on utilise le périphérique (<tt>/dev/le_periph</tt>) correspondant. C'est simple. Il faut indiquer au chargeur de modules que pour acceder à ce périphérique il doit charger le module <tt>le_module</tt>. Cela se fait via son fichier de configuration <tt>/etc/modules.conf</tt> (pour les versions de modutils antérieures à 2.3.5-1, ce fichier s'appelle <tt>/etc/conf.modules</tt>).

Pour qu'un module soit chargé automatiquement, faire : <br /><code># ls -l /dev/le_periph</code><br />qui affiche une ligne ressemblant à : <br/><tt>crw------- 1 user group '''<u>144</u>''', ''<u>12</u>'' May 25 2000 /dev/le_periph</tt><br/>
Pour chaque ligne est affiché :
* Un numéro majeur (ici '''144''') : il identifie le pilote du périphérique,
* Un numéro mineur (ici '''12''') : il sert à différencier les périphériques utilisant un même pilote.

Editez le fichier <tt>/etc/modules.conf</tt> dans votre éditeur de texte préféré et ajoutez une ligne : <br/><code>alias char-major-144 le_module</code><br/>en remplaçant bien sûr <code>144</code> par votre numéro, et <code>le_module</code> par votre module. <br/>Par exemple, pour charger le module gérant la carte 3dfx, j'ai dans mon <tt>modules.conf</tt> la ligne suivante : <br /><code>alias char-major-107 3dfx</code>

; <u>Remarque</u> :
: Il existe des aliases prédéfinis pour remplacer <tt>char-major-xxx</tt> pour les périphériques courants : <tt>eth0</tt> pour la première carte ethernet (<tt>eth1</tt> pour la suivante, etc.), <tt>parport_lowlevel</tt> pour le port parallèle, <tt>sound</tt> pour la carte son, <tt>midi</tt> pour la partie midi de la carte son, etc.

Si votre module a besoin d'options, par exemple pour connaître une adresse ou une interruption, vous pouvez aussi ajouter une ligne du type : <br /><code>options le_module irq=5 dma=0 dma2=1 mpu_io=0x388 io=0x370</code><br/>Chaque module a ses propres options, reportez-vous à la documentation de votre module afin de les connaître.

Enfin, si vous voulez lancer une commande avant ou après que le module soit chargé en mémoire, vous pouvez ajouter une ligne du type : <br/><code>pre-install le_module la_commande</code>, ou : <br/><code>post-install le_module la_commande</code>

→ Plus d'infos dans la page man de <tt>modules.conf</tt>

==== Chargeur dynamique de modules sur Debian ====

Debian juge que l'édition du fichier <tt>modules.conf</tt> par l'utilisateur est trop risquée. A la place, elle propose d'éditer des fichiers dans le répertoire <tt>/etc/modutils/</tt>. Ces fichiers ont la même syntaxe que <tt>modules.conf</tt>. Il existe trois fichiers par défault :
* <tt>/etc/modutils/actions</tt> : regroupe toutes les actions sur les modules,
* <tt>/etc/modutils/aliases</tt> : regroupe tous les alias,
* <tt>/etc/modutils/paths</tt> : regroupe tous les chemins.
Une fois les fichiers mis à jour, la commande <code>update-modules</code> lit les fichiers présents dans <tt>/etc/modutils/</tt> et regénère <tt>modules.conf</tt>.

→ Plus d'infos dans la page man de <tt>update-modules</tt>

=== Chargeur dynamique pour les noyaux 2.6 et à venir ===

Le fichier <tt>/etc/modules.conf</tt> ne sert plus et le fichier <tt>/etc/modprobe.conf</tt> est utilisé à la place. Sa syntaxe est une simplification de la syntaxe de <tt>modules.conf</tt>. Par exemple, à la place de
<code>pre-install le_module une_commande_1
post-install le_module une_commande_2</code>
on aura
<code>install le_module une_commande_1; modprobe --ignore-install le_module;une_commande_2</code>

→ Plus d'infos dans la page man de <tt>modprobe.conf</tt>

=== Chargeur statique de modules ===

Il est possible de charger un module au démarrage de Linux en ajoutant une ligne avec le nom du module dans le fichier <tt>/etc/modules</tt>. Cependant, on perd l'intérêt de la modularité puisqu'il est chargé même s'il n'est pas utilisé.

Voilà, c'est tout, maintenant lorsqu'un programme utilisera le periphérique, plus besoin de charger le module à la main, cela se fera automatiquement.

; <u>Remarque</u> :
: on peut faire des tas de choses "intéressantes" avec les modules, allez voir [http://www.safenetworks.com/Linux/modules.html cette page] par exemple... En résumé, si vous êtes un paranoïaque de la sécurité, n'utilisez pas les modules et compilez-vous un noyau complètement monolithique sans chargeur de modules (merci à [http://www.bruhat.net BooK] pour l'info).

<div class="merci">Cette page est issue de la documentation 'pré-wiki' de Léa et a été convertie avec HTML::WikiConverter. Elle fut créée par Jean-Christophe Cardot le 25/05/2000.</div>

= Copyright =
Copyright © 25/05/2000, Jean-Christophe Cardot
{{CC-BY-NC-SA}}