NOM¶

SYNOPSIS¶

int init_module(void *module_image, unsigned long len,
                const char *param_values);

int finit_module(int fd, const char *param_values,
                 int flags);

Remarque : la glibc ne déclare pas init_module() dans ses en-têtes ni ne fournit pas de fonction autour de finit_module() ; consultez la section NOTES.

DESCRIPTION¶

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 module 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 module_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 tableau sont indiquées en liste, séparées par des virgules.

VALEUR RENVOYÉE¶

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 dehors 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_module().

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 architecture.

Les erreurs supplémentaires suivantes peuvent survenir pour finit_module().

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.

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¶

CONFORMITɶ

NOTES¶

La glibc ne fournit pas de fonction autour de finit_module() ; utilisez syscall(2) pour l'appeler.

Des renseignements concernant les modules chargés sont disponibles dans /proc/modules et dans les arborescences de fichiers des sous-répertoires 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.

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
};

VOIR AUSSI¶

COLOPHON¶

TRADUCTION¶

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 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>.