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.

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 <[email protected]> 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.