insmod | Début | Suivant | Sommaire | Préc.page.lue | Accueil |
NOM | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
SYNOPSIS | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
DESCRIPTION | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
insmod essaie de lier un module dans le noyau en cours d'exécution en résolvant les noms de symboles à partir de la table des symboles exportés par le noyau.
Si le nom du fichier objet est donné sans répertoire ni extension, insmod cherchera le module dans quelques répertoires par défaut. La variable d'environnement MODPATH peut surcharger ces répertoires par défaut. Si un fichier de configuration comme /etc/modules.conf existe, il surchargera les chemins indiqués dans MODPATH.
La variable d'environnement MODULECONF peut sélectionner un fichier de configuration différent de /etc/modules.conf (ou /etc/conf.modules (obsolète)). Cette variable d'environnement prévaudra sur toutes les définitions précédentes.
Quand la variable d'environnement UNAME_MACHINE est remplie, modutils l'utilisera à la place du champ « machine » de l'appel système uname(2). Ceci est surtout utile si vous compilez des modules 64 bits dans un espace utilisateur 32 bits ou inversement ; remplissez UNAME_MACHINE avec le type de modules construits. La version actuelle de modutils ne supporte pas la construction croisée complète de modules, elle est limitée au choix entre 32 et 64 bits de l'architecture hôte.
OPTIONS | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
PARAMÈTRES DES MODULES | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
Dans les modules pour les noyau 2.0, tout symbole d'entier ou de pointeur caractère peut être manipulé comme un paramètre et être modifié. Depuis les noyaux 2.1, les symboles sont explicitement marqués comme des paramètres, afin que seules des données spécifiques soient modifiables. De plus, le type est indiqué pour vérifier la valeur fournie au chargement.
Pour les entiers, les valeurs peuvent être en base 10, 8 ou 16, comme en C : 17, O21 ou Ox11. Les éléments de tableau sont fournis en séquence, séparés par des virgules. Des éléments peuvent être « sautés » en omettant leur valeur.
Dans les modules 2.0, les valeurs ne débutant pas par un nombre sont considérées
comme des chaînes. Depuis les 2.1, l'information sur le type de paramètre indique
si la valeur doit être considérée comme une chaîne. Si la valeur commence par
un guillemet
("),
la chaîne est interprétée comme en C, avec séquence d'échappement
et le reste. Notez que depuis la ligne de commande du shell, les guillemets
doivent être protégés pour éviter leur interprétation par ce dernier.
SYMBOLES ET MODULES SOUS LICENCE GPL | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
Si le noyau supporte l'attribut /proc/sys/kernel/tainted, alors insmod fera un OU entre l'attribut et « 1 » au chargement d'un module sans licence GPL. Un avertissement sera affiché si le noyau supporte le mode tâché (tainted) et qu'on charge un module sans licence. Un avertissement est fourni pour tout module ayant MODULE_LICENSE() non compatible GPL, même sur les noyaux anciens ne supportant pas l'entâchement. Ceci limite les avertissements quand les modutils récents sont utilisés sur des noyaux anciens.
Le mode insmod -f (force) fera un OU entre l'attribut tainted et « 2 » sur les noyaux supportant l'entâchement. Ceci déclenche toujours un avertissement.
Certains développeurs du noyau réclament que les symboles exportés par leur code ne soit utilisés que dans des modules avec une licence compatible GPL. Ces symboles sont exportés avec EXPORT_SYMBOL_GPL plutôt qu'avec le normal EXPORT_SYMBOL. Les symboles GPL-seulement exportés par le noyau et d'autres modules ne sont visibles que des modules ayant une licence compatible GPL. Ils apparaissent dans /proc/ksyms avec le préfixe « GPLONLY_ ». insmod ignore le préfixe GPLONLY_ des symboles en chargeant un module avec une licence compatible GPL, afin que le module fasse référence au nom du symbole sans le préfixe. Les symboles GPL-seulement ne sont pas rendus disponibles aux modules sans licence compatible GPL, ou sans licence indiquée.
AIDE KSYMOOPS | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
L'autre problème avec le débogage des problèmes du noyau dans les modules est que le contenu de /proc/ksyms et /proc/modules peut changer entre l'instant du Oops et le moment où vous analysez le fichier journal. Pour pallier ce problème, si le répertoire /var/log/ksymoops existe alors insmod et rmmod copieront automatiquement /proc/ksyms et /proc/modules dans /var/log/ksymoops avec le préfixe « date +%Y%m%d%H%M%S ». L'administrateur système peut indiquer à ksymoops quel fichier employer pour déboguer un Oops. Il n'y a pas d'option pour désactiver cette copie automatique. Si vous ne voulez pas qu'elle se produise, il ne faut pas créer de répertoire /var/log/ksymoops. Si le répertoire existe, il doit appartenir à root, avoir le mode 644 ou 600 et vous devriez lancer chaque jour le script suivant, installé comme insmod_clean_ksymoops.
#!/bin/sh # Supprime la sauvegarde de ksyms et des modules sans accès depuis 2 jours if [ -d /var/log/ksymoops ] then set -e # S'assurer qu'il y en a toujours au moins une version d=`date +%Y%m%d%H%M%S` cp -a /proc/ksyms /var/log/ksymoops/${d}.ksyms cp -a /proc/modules /var/log/ksymoops/${d}.modules find /var/log/ksymoops -type f -atime +2 -exec rm {} \; fi
VERSIONS | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
Historique | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
VOIR AUSSI | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
TRADUCTION | Début | Précédent | Suivant | Sommaire | Préc.page.lue | Accueil |
Ce document est une traduction réalisée par Jérome Signouret en 2000 et révisée le 19 novembre 2007.
L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 8 insmod ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.
Sommaire | Début | Suivant | Sommaire | Préc.page.lue | Accueil |
Table des mots clés | Début | Suivant | Sommaire | Préc.page.lue | Accueil |
OPTIONS | |
-e persist_name, --persist=persist_name | OPTIONS |
-f, --force | OPTIONS |
-h, --help | OPTIONS |
-k, --autoclean | OPTIONS |
-L, --lock | OPTIONS |
-m, --map | OPTIONS |
-n, --noload | OPTIONS |
-N, --numeric-only | OPTIONS |
-O blob_name, --blob=blob_name | OPTIONS |
-o module_name, --name=module_name | OPTIONS |
-P prefix, --prefix=prefix | OPTIONS |
-p, --probe | OPTIONS |
-q, --quiet | OPTIONS |
-r, --root | OPTIONS |
-S, --kallsyms | OPTIONS |
-s, --syslog | OPTIONS |
-v, --verbose | OPTIONS |
-V, --version | OPTIONS |
-X, --export; -x, --noexport | OPTIONS |
-Y, --ksymoops; -y, --noksymoops | OPTIONS |
__insmod_modulename_Oobjectfile_Mmtime_Vversion | AIDE KSYMOOPS |
__insmod_modulename_Ppersistent_filename | AIDE KSYMOOPS |
__insmod_modulename_Ssectionname_Llength | AIDE KSYMOOPS |