init_module(2) System Calls Manual init_module(2)
NOM
init_module, finit_module - Charger un module de noyau
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
SYNOPSIS
#include <linux/module.h> /* Définition des constantes MODULE_* */
#include <sys/syscall.h> /* Définition des constantes SYS_* */
#include <unistd.h>
int syscall(SYS_init_module, void module_image[.len], unsigned long len,
const char *param_values);
int syscall(SYS_finit_module, int fd,
const char *param_values, int flags);
Note : la glibc ne fournit pas de fonction autour de cet appel système,
l'utilisation de syscall(2) est requise.
DESCRIPTION
init_module() charge une image ELF dans l'espace du noyau, réalise
toutes les réallocations de symboles nécessaires, initialise les pa-
ramètres du module aux valeurs fournies par l'appelant et exécute en-
suite la fonction init du module. Cet appel système nécessite des
droits.
L'argument module_image pointe vers un tampon contenant l'image binaire
à charger ; len indique la taille du tampon. L'image du module devrait
être une image ELF valable, construite pour le noyau en fonctionnement.
L'argument param_values est une chaîne contenant une liste de valeurs,
séparées par des espaces, de paramètres du module (définis dans le mo-
dule en utilisant module_param() et module_param_array()). Le noyau
analyse cette chaîne et initialise les paramètres indiqués. Toutes les
spécifications de paramètres sont de la forme :
nom[=valeur[,valeur...]]
Le paramètre nom est un de ceux définis dans le module en utilisant mo-
dule_param() (consultez le fichier include/linux/moduleparam.h dans les
sources du noyau Linux). Le paramètre valeur est facultatif pour les
paramètres de type bool et invbool. Les valeurs des paramètres de ta-
bleau sont indiquées en liste, séparées par des virgules.
finit_module()
L'appel système finit_module() est comme init_module(), mais lit le mo-
dule à charger à partir du descripteur de fichier fd. Il est utile
quand l'authenticité d'un module du noyau peut être déterminée par son
emplacement sur le système de fichiers. Dans les cas où c'est possible,
la complication induite par la vérification cryptographique de modules
signés pour déterminer leur authenticité peut être évitée. L'argument
param_values est comme pour init_module().
L'argument flags modifie l'opération de finit_module(). C'est un masque
OU bit à bit de zéro ou plusieurs des attributs suivants.
MODULE_INIT_IGNORE_MODVERSIONS
Ignorer les hachages de version de symbole.
MODULE_INIT_IGNORE_VERMAGIC
Ignorer la version magique du noyau.
Certaines vérifications de sécurité sont construites dans un module
pour s'assurer qu'il correspond au noyau sur lequel il est chargé. Ces
vérifications sont enregistrées quand le module est construit et utili-
sées quand le module est chargé. D'abord, le module enregistre une
chaîne « vermagic » contenant le numéro de version du noyau et les
fonctionnalités principales (comme le type de microprocesseur). En-
suite, si le module a été construit avec l'option de configuration
CONFIG_MODVERSIONS activée, un hachage de version est enregistré pour
chaque symbole que le module utilise. Ce hachage est basé sur les types
de l'argument et la valeur de retour pour la fonction nommée par le
symbole. Dans ce cas, le numéro de version du noyau dans la chaîne
« vermagic » est ignoré, car les hachages de version de symbole sont
supposés être suffisamment fiables.
L'utilisation de l'attribut MODULE_INIT_IGNORE_VERMAGIC indique que la
chaîne « vermagic » est à ignorer, et l'attribut MO-
DULE_INIT_IGNORE_MODVERSIONS indique que les hachages de version de
symbole sont à ignorer. Si le noyau est construit pour permettre le
chargement forcé (c'est-à-dire configuré avec CONFIG_MO-
DULE_FORCE_LOAD), alors le chargement continuera, sinon il échouera
avec ENOEXEC comme attendu pour les modules malformés.
VALEUR RENVOYÉE
Ces appels système renvoient 0 en cas de succès, ou -1 en cas d'échec,
auquel cas errno est positionné pour indiquer l'erreur.
ERREURS
EBADMSG (depuis Linux 3.7)
La signature du module est mal formatée.
EBUSY Délai dépassé en essayant de résoudre une référence de symbole
par ce module.
EFAULT Un argument d'adresse faisait référence à un emplacement en de-
hors de l'espace d'adressage accessible du processus.
ENOKEY (depuis Linux 3.7
La signature du module est incorrecte ou le noyau n'a pas de
clef pour ce module. Cette erreur n'est renvoyée que si le noyau
a été configuré avec CONFIG_MODULE_SIG_FORCE. Si le noyau n'a
pas été configuré avec cette option, alors un module incorrect
ou non signé corrompt simplement le noyau.
ENOMEM Plus assez de mémoire.
EPERM L'appelant n'avait pas les droits (n'avait pas la capacité
CAP_SYS_MODULE), ou le chargement de module est désactivé
(consultez /proc/sys/kernel/modules_disabled dans proc(5)).
Les erreurs supplémentaires suivantes peuvent survenir pour init_mo-
dule().
EEXIST Un module de ce nom est déjà chargé.
EINVAL param_values est incorrect, ou certaines parties de l'image ELF
de module_image contiennent des incohérences.
ENOEXEC
L'image binaire fournie dans module_image n'est pas une image
ELF, ou est une image ELF incorrecte ou pour une autre architec-
ture.
Les erreurs supplémentaires suivantes peuvent survenir pour finit_mo-
dule().
EBADF Le fichier indiqué par fd n'est pas ouvert en lecture.
EFBIG Le fichier indiqué par fd est trop gros.
EINVAL flags n'est pas correct.
ENOEXEC
fd ne fait pas référence à un fichier ouvert.
ETXTBSY (depuis Linux 4.7)
Le fichier indiqué par fd est ouvert en lecture et écriture.
En plus des erreurs précédentes, si la fonction init du module est exé-
cutée et renvoie une erreur, alors init_module() ou finit_module()
échoue et errno est définie à la valeur renvoyée par la fonction init.
VERSIONS
finit_module() est disponible depuis Linux 3.8.
STANDARDS
init_module() et finit_module() sont spécifiques à Linux.
NOTES
L'appel système init_module() n'est pas pris en charge par la glibc. Il
n'est pas déclaré dans les en-têtes de la glibc mais, par un caprice de
l'histoire, les versions de la glibc antérieures à la glibc 2.23 four-
nissaient une interface binaire pour cet appel système. Ainsi, avant la
glibc 2.23, il suffit de déclarer manuellement l'interface dans votre
code pour utiliser cet appel système. Sinon, vous pouvez l'invoquer en
utilisant syscall(2).
Des renseignements concernant les modules chargés sont disponibles dans
/proc/modules et dans les arborescences de fichiers des sous-réper-
toires par module sous /sys/module.
Consultez le fichier include/linux/module.h dans les sources du noyau
Linux pour obtenir des renseignements de fond utiles.
Linux 2.4 et antérieurs
Dans Linux 2.4 et antérieurs, l'appel système init_module() était assez
différent :
#include <linux/module.h>
int init_module(const char *name, struct module *image);
(les applications en espace utilisateur peuvent détecter la versions de
init_module() disponible en appelant query_module() ; ce dernier appel
échoue avec l'erreur ENOSYS à partir de Linux 2.6)
L'ancienne version de l'appel système charge l'image de module réal-
louée pointée par image dans l'espace du noyau et exécute la fonction
init du module. L'appelant doit fournir l'image réallouée (depuis Li-
nux 2.6, l'appel système init_module() s'occupe de la réallocation).
L'image du module commence avec une structure module suivie par du code
et des données appropriés. Depuis Linux 2.2, la structure module est
définie comme suit :
struct module {
unsigned long size_of_struct;
struct module *next;
const char *name;
unsigned long size;
long usecount;
unsigned long flags;
unsigned int nsyms;
unsigned int ndeps;
struct module_symbol *syms;
struct module_ref *deps;
struct module_ref *refs;
int (*init)(void);
void (*cleanup)(void);
const struct exception_table_entry *ex_table_start;
const struct exception_table_entry *ex_table_end;
#ifdef __alpha__
unsigned long gp;
#endif
};
On s'attend à ce que tous les champs pointeurs, à l'exception de next
et refs, pointent vers l'intérieur du corps du module et qu'ils
puissent être initialisés de manière appropriée pour l'espace noyau,
c'est-à-dire relogés avec le reste du module.
VOIR AUSSI
create_module(2), delete_module(2), query_module(2), lsmod(8), mod-
probe(8)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, Fran-
çois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Gué-
rard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org> et David Prévot <david@tilapin.org>
Cette traduction est une documentation libre ; veuillez vous reporter à
la GNU General Public License version 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.
Pages du manuel de Linux 6.03 4 décembre 2022 init_module(2)
Generated by dwww version 1.15 on Sat Jun 29 01:42:54 CEST 2024.