focal (8) module-assistant.8.gz
NOM
module-assistant - Gérer les paquets de modules pour le noyau
SYNOPSIS
module-assistant [ -fihnqstv ] [ -k répertoire des en-têtes ou des sources ] [ -l liste des versions de
noyau ] { update | search | prepare | auto-install | list | list-available | list-installed | auto-
unpacked | get | build | install | clean | purge | fakesource } [ pkg ... ]
m-a ...
DESCRIPTION
module-assistant est l'outil en ligne de commande qui permet de gérer les paquets source des modules
préparés pour la distribution Debian. Il aide les utilisateurs à construire et à installer facilement un
ou plusieurs paquets de modules destinés à un ou plusieurs noyaux.
À moins que l'option -h ou --help ne soit indiquée, une des commandes ci-dessous doit être précisée pour
invoquer explicitement une fonction. Si aucune commande n'est précisée ou n'est valide et que l'outil
dialog est disponible, une interface graphique simple apparaîtra et vous indiquera les fonctionnalités
disponibles.
NOTE : ne pensez même pas à utiliser un paquet kernel-source-x.y.z pris au hasard (ou le tarball linux-
x.y.z récupéré sur Internet) pour les faire passer pour les sources du noyau actuellement utilisé. Ne le
faites pas ! Ces sources ne sont pas exactement celles utilisées pour construire le noyau actuellement
exécuté et leur configuration ne correspond sans doute pas à la vôtre. Vous avez besoin du répertoire
contenant les sources du noyau configurées, ou au moins du paquet dérivé linux-headers-... contenant la
configuration du noyau pour la version exacte du noyau (l'ensemble de la chaîne de version est pris en
compte). Si vous ne comprenez rien au texte ci-dessus, exécutez m-a prepare et/ou regardez la description
et le contenu d'un paquet linux-headers-... Veuillez exécuter la commande module-assistant prepare avant
toute autre chose.
Pour certains paquets, les en-têtes du noyau (linux-headers ou sources réduites) ne sont pas suffisants.
Vous avez le choix entre utiliser un noyau complètement personnalisé et recréer les sources utilisées
lors de la construction du noyau actuel. La commande fakesource peut être utile, voir ci-dessous pour les
détails.
Afin de configurer correctement les sources d'un noyau, vous devez vous assurer que le fichier version.h
est généré. Pour l'obtenir, configurez les options comme d'habitude (make menuconfig etc.) et lancez make
dep (pour les noyaux 2.4.x) ou make prepare (pour les plus récents).
COMMANDES
La plupart des commandes nécessitent de préciser le nom des paquets auxquels celles-ci doivent
s'appliquer. Le mot-clé pkg peut être un nom simple (un nom de paquet) ou plusieurs noms. Le mot-clé all
correspond à la liste de tous les paquets disponibles, le mot-clé alli à la liste de tous les paquets
source actuellement installés et le mot-clé allu à la liste des paquets qui semblent installés et
décompressés dans le répertoire de base des sources. Si le nom indiqué ne correspond à aucun paquet
source, module-assistant (abrégé m-a) essaiera les suffixes habituels comme -kernel, -driver, -module,
-source ainsi que les combinaisons de ceux-ci.
Plusieurs commandes peuvent être indiquées en une seule exécution, par ex. « m-a clean,get,build arla
cdfs » est le moyen rapide d'écrire « module-assistant clean arla-modules-source ; module-assistant clean
cdfs-src ; module-assistant get arla-modules-source cdfs-src ; module-assistant build arla-modules-source
cdfs-src ».
Si vous n'aimez pas l'interface dialog/whiptail, utilisez l'option -t pour la désactiver.
update Resynchroniser les fichiers d'index depuis leurs sources. Cela se produit avec certains scripts de
paquets. module-assistant dispose d'une liste de paquets inclue par défaut. D'autres paquets
peuvent cependant être enregistrés par module-assistant si le responsable ajoute le script helper
adéquat.
prepare
Essaie de déterminer le nom du paquet linux-headers requis (celui correspondant soit au noyau
actuel, soit aux versions indiquées avec -l), et si besoin, l'installe et crée le lien symbolique
/usr/src/linux. Installe également le paquet build-essential pour s'assurer qu'un environnement de
compilation convenable est installé.
fakesource
Fonction expérimentale qui essaie de déterminer le nom du paquet kernel-source requis ou
compatible, l'installe, puis modifie le Makefile pour ressembler au source original et lance les
routines de configuration si besoin. Attention : NE VOUS FIEZ PAS AU SOURCE RÉSULTANT. Il peut
être très différent de la version originale.
list | list-available | la
list-available (abrégé la) présente une liste des détails sur les paquets indiqués, dont la
version installée, les versions installables et les paquets binaires récemment construits. Si
aucun nom de paquet n'est indiqué, les détails de tous les paquets seront affichés. L'option -v
affiche les chemins complets des paquets.
list-installed | li
Analogue à list alli. Agit comme list-available mais limite la liste aux paquets source installés.
search Analogue à list -s. Cherche d'abord des paquets compilés localement, puis en cas d'échec cherche
avec apt-cache des candidats alternatifs pour l'installation.
get get suivi d'une liste de paquets installe les paquets source et les télécharge si nécessaire.
build build doit être suivi d'un ou plusieurs paquets source à construire. Les sources du noyau adaptées
au noyau exécuté sont choisies, à moins que des répertoires particuliers aient été indiqués. Si la
construction échoue, examinez le fichier journal le plus récent dans /var/cache/modass (ou dans le
répertoire indiqué par l'utilisateur).
install
install doit être suivi d'un ou plusieurs paquets à installer. Le dernier paquet construit
correspondant au noyau exécuté est choisi.
auto-install | a-i
auto-install doit être suivi d'un ou plusieurs paquets à installer. Cette fonction exécutera
prepare pour faire en sorte que votre système puisse construire des paquets, téléchargera le
paquet source, essaiera de le construire pour le noyau exécuté et l'installera. Vous pouvez
utiliser les raccourcis alli pour sélectionner tous les paquets source de modules installés, ou
allu pour sélectionner uniquement les paquets déjà décompressés (similaire à ce que fait
normalement l'outil make-kpkg, en regardant $MODULE_LOC).
auto-build | a-b
Analogue à auto-install, mais n'installe pas le paquet immédiatement.
clean clean nettoie les répertoires de construction des paquets.
purge purge supprime les informations en cache d'un paquet source et supprime tous les paquets binaires
qui ont été construits localement à partir de ce paquet source (et dont module-assistant a
connaissance). À UTILISER AVEC PRÉCAUTION !
OPTIONS
-t
--text-mode
Afficher les journaux bruts de construction, d'installation et de mise à jour, au lieu d'afficher
des barres de progression.
-k
--kernel-dir
Permet d'indiquer les répertoires de sources du noyau à utiliser lors des constructions. Vous
pouvez indiquer plusieurs répertoires avec plusieurs options, ou séparés par des virgules ou des
séparateurs de ligne (par ex. en utilisant -k "`echo /usr/src/linux-headers-*`"). Les versions des
noyaux détectées dans ces répertoires sont automatiquement ajoutées à la liste des versions de
noyaux cibles (voir --kvers-list pour plus de détails).
-l
--kvers-list
Permet d'indiquer la liste des noms de version des noyaux (comme dans KVERS) à traiter. Si le
paramètre n'est pas précisé, la version du noyau en cours d'utilisation est utilisée. Si d'autres
répertoires de sources sont indiqués après l'option --kernel-dir, les versions des noyaux qui y
sont présents sont également traitées.
Les emplacements des sources ou des en-têtes de ces versions du noyau sont détectées grâce à une
recherche des emplacements habituellement utilisés sur les systèmes Linux, ou doivent être
indiquées à l'aide de l'option --kernel-dir.
-v
--verbose
Affiche un peu plus d'informations, par exemple les chemins complets des paquets binaires.
-n
--no-rebuild
Si un paquet à générer existe déjà dans le répertoire cible (peut-être dans une version plus
ancienne), l'option -n évite de reconstruire le paquet.
Dans le comportement par défaut, le paquet n'est pas reconstruit si un fichier au nom exactement
identique est présent. Le nouveau nom de fichier peut en effet être détecté avant le démarrage du
processus de construction, suivant le paquet source concerné.
-f
--force
Ne vérifie jamais le fichier cible (en cas de version différente) et force la reconstruction. Pour
la commande get, télécharge une nouvelle version du paquet même si celui-ci est déjà installé.
-u
--userdir
Toutes les variables d'environnement pertinentes contenant des chemins sont redirigées vers de
nouveaux répertoires situés en-dessous de celui indiqué par cette option.
-i
--non-inter
En cas d'échec de la construction du paquet, continuer avec d'autres paquets candidats. Par
défaut, module-assistant suggérera d'examiner le journal de construction. Cette option peut
également modifier le comportement de dpkg et d'apt-get afin de réduire le besoin d'interaction
avec l'utilisateur et installer les dépendances de constructions nécessaires.
-o
--unpack-once
Essayer de ne pas décompresser deux fois. Cette option doit être également indiquée lorsque le
paquet est décompressé pour la première fois. Cette option est expérimentale, ne vous y fiez pas.
-O
--not-unpack
Ne jamais décompresser l'archive source. Cette option est utile lorsque les sources d'un module
ont été modifiées par l'utilisateur.
-q
--quiet
Ne pas afficher certains messages bavards au cours du traitement.
-S
--sudo-cmd
Indique la commande à utiliser en remplacement de sudo pour les commandes en tant que
superutilisateur.
-s
--apt-search
Consultez la commande search pour les détails.
-h
--help Affiche un récapitulatif des possibilités d'utilisation.
VARIABLES D'ENVIRONNEMENT
Vous pouvez exporter les variables d'environnement suivantes pour modifier le comportement des scripts de
construction. Certains paquets peuvent les ignorer ou les interpréter diversement.
KPKG_DEST_DIR
KPKG_DEST_DIR indique le répertoire cible où les paquets Debian résultants devraient être
installés. Cependant, de nombreux paquets ignorent cette variable et installent le fichier dans le
répertoire de niveau supérieur à celui des sources du noyau ou à celui du répertoire actuel.
KERNELDIRS
KERNELDIRS indique ou étend la liste des répertoires de sources ou d'en-têtes de noyau pour
lesquels m-a devrait construire les modules. Consultez l'option -k pour les détails.
SIGNCHANGES
Si SIGNCHANGES est positionnée, des fichiers .changes seront générés (en appelant la règle
kdist_image à la place de kdist) et debsign (ou gpg ou pgp) sera exécuté pour signer ces fichiers.
KMAINT | DEBFULLNAME | DEBNAME
Indique le nom réel de la personne qui construit le paquet, concerne uniquement le fichier
.changes.
KEMAIL | DEBEMAIL
Indique l'adresse de courriel de la personne qui construit le paquet, concerne uniquement le
fichier .changes.
MODULE_LOC
Indique un emplacement différent des répertoires des sources des modules. Par défaut
/usr/src/modules.
MA_VARDIR
Indique un emplacement différent des données de cache, utilisé par les scripts helper de module-
assistant. Par défaut /var/cache/modass.
MOD_SRCDIR
Indique un emplacement différent des archives des sources de modules. Par défaut /usr/src.
ROOT_CMD
Commande d'encapsulation pour exécuter des commandes en tant que superutilisateur. Si vous n'êtes
pas superutilisateur, fakeroot est automatiquement choisi. Cette variable est interprétée par les
paquets, qui peuvent néanmoins l'ignorer. Cependant, vous pouvez lancer module-assistant à
l'intérieur de l'encapsuleur ROOT_CMD.
UTILISATION AVEC DES DROITS RESTREINTS
module-assistant peut fonctionner sans être superutilisateur. Cependant, vous ne pouvez pas utiliser apt-
get ou dpkg pour installer les paquets, et ne pouvez pas écrire dans /var/cache/modass sur un système
Debian habituel. Ainsi les commandes get, install, auto-install et prepare ne sont pas accessibles aux
utilisateurs simples. Toutefois, si le programme sudo est installé, il sera appelé lors des opérations
apt-get et dpkg. Toutes les autres commandes exceptée list nécessitent des variables d'environnement
supplémentaires pour indiquer des répertoires cibles dans lesquels l'utilisateur peut écrire. Elles
peuvent être toutes redirigées vers un répertoire accessible en écriture avec l'option -u.
FICHIERS
/usr/share/modass/packages/*
Liste des scripts helper fournis avec le paquet module-assistant.
/usr/share/modass/overrides/*
Scripts helper installés par d'autres paquets.
VOIR AUSSI
make-kpkg (1) ,
/usr/share/doc/module-assistant/README
BOGUES
Consultez la page des bogues de module-assistant <URL:http://bugs.debian.org/src:module-assistant>. Si vous souhaitez signaler un bogue dans module-assistant, veuillez utiliser la commande reportbug (1).
CODES DE RETOUR
0 Succès
1..249 Erreurs diverses lors du processus de construction
254 Problèmes de permissions
255 erreur corrigible sur intervention de l'utilisateur
À FAIRE
Liste rapide (sortie rapide sans détails)
Intégration à APT et/ou au système init
Debianisation « agressive » en utilisant un jeu de gabarits, afin de générer un paquet depuis n'importe
quelle source apparaissant comme compatible avec le système de construction du noyau 2.6.
Transformation automatique des sources du noyau pour générer des paquets .udeb.
AUTEUR
Module-Assistant a été écrit par Eduard Bloch <blade@debian.org> pour la distribution Debian.
TRADUCTION
Cette page de manuel a été traduite par Simon Paillard <simon DOT paillard AT resel DOT enst-bretagne DOT
fr> et les membres de la liste <debian-l10n-french AT lists DOT debian DOT org>.
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 : man -L C
module-assistant
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de
manuel.
14 Octobre 2006 MODULE-ASSISTANT(8)