Provided by: debconf-doc_1.5.73_all 
NOM
debconf - système de configuration des paquets Debian
DESCRIPTION
Debconf est un système de configuration pour les paquets Debian. Il existe une commande
rarement utilisée nommée debconf, documentée dans debconf(1)
Debconf fournit une interface cohérente pour la configuration des paquets et donne à
l'utilisateur le choix entre plusieurs interfaces. Il peut configurer des paquets avant
qu'ils ne soient installés, ce qui permet à des installations et des mises à niveau
importantes de demander toutes les informations nécessaires au préalable, et de vous
laisser faire ce que vous voulez pendant que les paquets s'installent. Debconf vous
permet, si vous êtes pressé, de sauter les questions les moins importantes au moment de
l'installation d'un paquet (en y revenant plus tard).
Préconfiguration des paquets
Debconf peut configurer les paquets avant même qu'ils ne soient installés sur votre
système. Ainsi, toutes les questions des paquets vous seront posées au début de
l'installation ce qui permettra à l'installation de continuer pendant que vous êtes en
train de prendre un café.
Si vous utilisez apt (version 0.5 ou supérieure) et que vous avez installé apt-utils,
chaque paquet installé par apt sera automatiquement préconfiguré. Ceci est contrôlé via
/etc/apt/apt.conf.d/70debconf
Quelquefois vous voudrez préconfigurer un paquet vous-même, quand vous l'installez sans
apt. Vous pouvez utiliser dpkg-preconfigure(8) pour ce faire. Donnez-lui seulement le nom
du paquet que vous voulez préconfigurer. Vous aurez besoin d'installer apt-utils pour que
cela fonctionne.
Reconfiguration des paquets
Supposons que vous ayez installé un paquet et que vous ayez répondu aux questions de
debconf, mais maintenant que vous l'utilisez de temps en temps, vous réalisiez que vous
voulez revenir sur quelques-unes de vos réponses et les changer. Autrefois, il fallait
faire une réinstallation quand vous étiez dans cette situation ; mais quand vous
réinstallez le paquet, debconf semble se souvenir que vous avez déjà répondu aux questions
et ne vous les pose pas à nouveau (c'est voulu).
Heureusement, debconf facilite la reconfiguration des paquets qui l'utilisent. Supposez
que vous voulez reconfigurer debconf lui-même. Exécutez simplement, en tant que
superutilisateur :
dpkg-reconfigure debconf
Il vous posera toutes les questions que vous avez vues lors de la première installation de
debconf. Il peut aussi vous poser d'autres questions, puisqu'il vous pose même les
questions de priorité basse qui ont pu être sautées quand le paquet a été installé. Vous
pouvez aussi bien l'utiliser avec n'importe quel autre paquet utilisant debconf.
Interfaces
Une fonctionnalité remarquable de debconf est qu'il possède plusieurs interfaces et l'on
peut en changer à loisir. Voici les interfaces disponibles :
dialog Interface par défaut : elle utilise les programmes whiptail(1) ou dialog(1) pour
afficher les questions. Elle fonctionne en mode texte.
readline
C'est l'interface la plus traditionnelle. Elle ressemble à la configuration Debian
classique : une série de questions, imprimées sur la console en mode texte et des
invites affichées avec la bibliothèque readline. Elle reconnaît même le
complètement avec « tab ». Le paquet libterm-readline-gnu-perl est fortement
recommandé si vous choisissez d'utiliser cette interface ; le module readline par
défaut ne gère pas les invites de saisie avec des valeurs par défaut. Pour utiliser
cette interface, vous aurez besoin d'installer le paquet perl-modules.
Cette interface a quelques commandes spéciales. « Page préc. » (ou ctrl-u)
reviendra à la question précédente (si cela est géré par le paquet utilisant
debconf) et « Page suiv. » (ou ctrl-v) passera à la question suivante.
C'est la meilleure interface pour les administrateurs à distance travaillant par
une connexion lente, ou pour ceux qui sont à l'aise avec Unix.
noninteractive
C'est l'anti-interface. Elle n'interagit jamais avec vous et utilise les réponses
par défaut pour toutes les questions. Elle enverra parfois un courriel à root avec
les messages que le paquet voulait afficher, mais c'est tout ! À part ça, elle est
silencieuse et discrète, c'est une interface parfaite pour des installations
automatiques. Si vous utilisez cette interface et si vous voulez que les réponses
aux questions ne soient pas celles par défaut, vous aurez besoin de renseigner
d'abord la base de données de debconf ; pour plus de détails, consultez la section
ci-dessous sur l'installation de paquets sans surveillance.
gnome C'est une interface graphique moderne utilisant les bibliothèques de gtk et de
GNOME. Bien sûr, elle nécessite une variable DISPLAY valable pour fonctionner ; si
elle ne peut pas fonctionner, debconf se rabattra sur d'autres interfaces.
Remarquez que cette interface nécessite que vous ayez installé le paquet
libgtk3-perl.
kde Cette interface fournit un outil graphique moderne basé sur la plateforme KDE. Vous
aurez bien sûr besoin d'une variable DISPLAY pour utiliser cette interface et vous
devez installer le paquet debconf-kde-helper. L'interface se rabattra sur
l'interface dialog si un des prérequis est absent.
editor C'est pour ces fanatiques qui veulent tout faire à l'aide d'un éditeur de texte.
Elle lance votre éditeur sur un fichier qui ressemble à un fichier de configuration
Unix, et vous modifiez le fichier qui sert à communiquer avec debconf. L'auteur de
debconf préfère ne pas commenter les circonstances qui ont conduit à l'écriture de
cette interface.
web
Cette interface agit comme un serveur web auquel vous vous connectez avec votre
navigateur web, pour parcourir les questions et y répondre. Elle est très
prometteuse, mais un peu rugueuse pour l'instant. Quand cette interface se met en
route, elle indiquera le lieu où vous devrez pointer votre navigateur web. Pour des
raisons de sécurité, vous devez exécuter votre navigateur web sur la machine que
vous configurez.
Gardez à l'esprit que ce n'est pas une interface sécurisée. Tous ceux qui ont accès
à l'ordinateur en cours de configuration peuvent aussi accéder au serveur web et
configurer certaines choses alors que cette interface tourne. C'est plus une preuve
de concept qu'autre chose.
Vous pouvez changer l'interface par défaut qu'utilise debconf en le reconfigurant. D'un
autre côté, si vous voulez juste changer l'interface pour un instant, vous pouvez
positionner la variable d'environnement DEBIAN_FRONTEND avec le nom de l'interface à
utiliser. Par exemple :
DEBIAN_FRONTEND=readline apt-get install slrn
Les commandes dpkg-reconfigure(8) et dpkg-preconfigure(8) permettent aussi de leur passer
--frontend= en paramètre, suivi de l'interface que vous voulez qu'elles utilisent.
Notez que toutes les interfaces ne fonctionneront pas en toute circonstance. Si le
démarrage d'une interface échoue pour quelque raison que ce soit, debconf affichera un
message expliquant pourquoi et se rabattra sur l'interface la plus proche.
Priorités
Pouvoir donner des priorités aux questions que vous pose debconf est une fonctionnalité
agréable. Si vous ne voulez pas être ennuyé par les questions sans importance, vous pouvez
configurer debconf pour qu'il ne vous pose que les questions les plus importantes. D'un
autre côté, si vous aimez tout contrôler, vous pouvez lui faire afficher toutes les
questions. Chaque question a une priorité. Par ordre croissant d'importance :
low Questions peu importantes dont les valeurs par défaut suffisent dans la majorité
des cas.
medium Questions normales avec des valeurs par défaut raisonnables.
high Questions qui n'ont pas de valeurs par défaut convenables.
critical
Questions que vous avez vraiment besoin de voir (ou autre).
Seules les questions avec une priorité supérieure ou égale à la priorité que vous avez
choisie seront affichées. Vous pouvez fixer la valeur de la priorité en reconfigurant
debconf, ou temporairement en passant l'option --priority= suivie de la valeur voulue aux
commandes dpkg-reconfigure(8) et dpkg-preconfigure(8), ou en positionnant la variable
d'environnement DEBIAN_PRIORITY.
Base de données principale
Debconf utilise une base de données sous-jacente plutôt flexible et potentiellement
compliquée pour sauvegarder les réponses déjà données aux questions. Le fichier
/etc/debconf.conf est utilisé pour configurer cette base de données. Si vous avez besoin
de configurer quelque chose de compliqué, comme utiliser une base de données distante pour
obtenir les valeurs par défaut, annulées par des variables locales, lisez la page de
manuel debconf.conf(5) pour tous les détails croustillants. La base de données principale
se trouve généralement dans /var/cache/debconf/.
Installation des paquets sans surveillance
Si vous avez beaucoup de machines à gérer, vous aurez sûrement besoin de faire une
installation ou une mise à niveau sans surveillance, alors que les réponses par défaut à
certaines questions de configuration ne sont pas acceptables. Il y a beaucoup de manières
pour faire cela ; toutes impliquent la configuration d'une base de données que debconf
utilisera pour obtenir les réponses par défaut que vous voulez.
Avant de lire cette section, vous devriez vraiment lire debconf.conf(5) car vous avez
besoin de comprendre le fonctionnement de la base de données de debconf.
Le plus simple pour configurer la base de données est d'installer les paquets sur une
machine et de répondre aux questions. Vous pouvez aussi utiliser dpkg-preconfigure(8) pour
configurer un ensemble de paquets sans réellement les installer. Vous pouvez même décider
d'écrire une base de données debconf à la main, comme un simple texte...
Une fois que vous avez la base de données, vous devez trouver comment faire pour que les
systèmes distants l'utilisent. Cela dépend bien sûr de la configuration de ces systèmes et
de la base de données qu'ils doivent utiliser.
Si vous utilisez la base de données LDAP de debconf, un seul serveur LDAP peut répondre à
toutes les questions d'installation des paquets d'un réseau complet de machines Debian.
Mais peut-être utilisez-vous quelque chose d'un peu plus facile à configurer, comme par
exemple, la base de données de configuration de debconf par défaut, ou ne voulez-vous tout
simplement pas que vos systèmes distants utilisent LDAP continuellement. Dans ce cas, la
meilleure approche est de configurer temporairement les systèmes distants pour qu'ils
ajoutent votre base de données sous leurs propres bases, de manière à ce qu'ils obtiennent
les valeurs par défaut de celle-ci. Debconf offre deux variables d'environnement,
DEBCONF_DB_FALLBACK et DEBCONF_DB_OVERRIDE, pour le faire à la volée et simplement. Ici,
un exemple d'utilisation :
cat /var/cache/debconf/config.dat | \
ssh root@cible "DEBIAN_FRONTEND=noninteractive \
DEBCONF_DB_FALLBACK=Pipe apt-get upgrade"
Cela fait que debconf sur l'hôte distant lit les données passées dans le tube à travers la
connexion SSH et les interprète comme une base de données debconf en mode texte. Il
n'utilise cette base de données qu'en dernier lieu -- c'est une base de données en lecture
seule, où l'on cherche les réponses que la base principale du système ne peut fournir.
Une autre manière d'utiliser la variable d'environnement DEBCONF_DB_FALLBACK :
ssh -R 389:ldap:389 root@cible \
"DEBCONF_DB_FALLBACK='LDAP{host:localhost}' apt-get upgrade"
ssh est utilisé ici pour configurer une connexion LDAP dans un tunnel et lancer debconf.
On indique à debconf d'utiliser le serveur LDAP comme base de données de secours.
Remarquez l'utilisation de « {host:localhost} » pour configurer l'accès de debconf à la
base de données LDAP fournissant le champ « host » avec la valeur « localhost ».
Encore une autre méthode :
scp config.dat root@cible:
ssh root@cible "DEBCONF_DB_FALLBACK='File{/root/config.dat}' apt-get upgrade
Ici, vous copiez la base de données avec scp, puis ssh, et vous faites utiliser à debconf
la base de données que vous avez copiée. Cela illustre un raccourci que vous pouvez
utiliser dans les paramètres de DEBCONF_DB_FALLBACK -- si le nom n'est pas indiqué, celui
par défaut est « filename ».
Il y a un problème avec l'utilisation des paramètres de DEBCONF_DB_FALLBACK : alors que la
base de données de secours peut fournir des réponses à des questions que les autres bases
de données debconf n'ont jamais vues, on ne l'interroge qu'en dernier lieu : après les
autres bases de données. Si vous avez besoin d'annuler temporairement une valeur existante
sur l'hôte distant, vous devriez plutôt utiliser la variable DEBCONF_DB_OVERRIDE. Comme
DEBCONF_DB_FALLBACK, elle configure une base de données temporaire, mais cette base de
données est consultée avant les autres et peut être utilisée pour remplacer les valeurs
existantes.
Développer pour debconf
Les développeurs de paquet et ceux qui veulent développer des paquets qui utilisent
debconf devraient lire debconf-devel(7).
Brièvement, debconf communique avec des scripts de maintenance ou d'autres programmes via
les entrée et sortie standard, en utilisant un langage orienté ligne de commandes
semblable à ce qui est utilisé par les protocoles usuels de l'internet comme SMTP. Les
programmes utilisent ce protocole pour demander à debconf d'afficher les questions et de
récupérer les réponses de l'utilisateur. Les questions elles-mêmes sont définies dans des
fichiers séparés, appelés « questionnaires », dont le format n'est pas très différent de
celui d'un fichier de contrôle de Debian.
Les paquets Debian qui utilisent debconf fournissent généralement un questionnaire et un
script de « configuration » (exécuté pour préconfigurer le paquet) dans la partie
métadonnées du paquet.
ENVIRONNEMENT
DEBIAN_FRONTEND
Utilisée pour changer temporairement l'interface debconf utilisée. Voir plus haut.
DEBIAN_PRIORITY
Utilisée pour changer temporairement la priorité que les questions doivent avoir
(au minimum) pour être affichées par debconf. Voir plus haut.
DEBCONF_DEBUG
Active l'affichage du débogage sur la sortie standard d'erreur. Elle peut être
fixée par le nom d'un mécanisme ou par une expression rationnelle qui correspond au
nom d'un mécanisme (comme « .* » pour afficher toutes les informations de
débogage). Les noms de mécanisme incluent :
user Informations de débogage intéressantes pour un utilisateur de debconf.
developer
Informations de débogage intéressantes pour un développeur de paquet.
db Informations de débogage concernant la base de données sous-jacente.
DEBCONF_NOWARNINGS
Positionnez-la à « yes » pour désactiver certains avertissements que debconf
pourrait afficher. Elle ne supprime pas l'affichage des erreurs fatales.
DEBCONF_TERSE
Positionnez-la à « yes » pour activer le mode concis dans lequel les interfaces
debconf suppriment autant que possible le bavardage.
DEBCONF_DB_FALLBACK
Ajouter une base de données en plus de celles utilisées habituellement, elle est
donc utilisée en secours pour obtenir les informations de configuration. Voir la
section « Installation des paquets sans surveillance » plus haut. Si la valeur de
la variable est le nom d'une base de données existante dans debconf.conf, la base
de données sera alors utilisée. Néanmoins, la variable d'environnement peut être
utilisée pour configurer une base de données à la volée, en donnant le type de la
base de données et des paramètres optionnels (champ:valeur) après le type et entre
accolades. Les espaces sont utilisées pour séparer les champs, vous ne pourrez donc
pas spécifier de valeur de champ contenant des espaces.
La ligne suivante demande l'utilisation de fallbackdb dans debconf.conf :
DEBCONF_DB_FALLBACK=fallbackdb
Alors que cette ligne configure une nouvelle base de données de type fichier, donne un nom
de fichier à utiliser et désactive toute sauvegarde :
DEBCONF_DB_FALLBACK=File{Filename:/root/config.dat Backup:no}
En résumé, cette ligne configure une base de données de type Fichier avec un nom de
fichier :
DEBCONF_DB_FALLBACK=File{/root/config.dat}
Remarquez que si la base de données de secours est configurée à la volée, elle sera
utilisable en lecture seule par défaut.
DEBCONF_DB_OVERRIDE
Ajouter une base de données avant celles utilisées normalement, elle peut donc
remplacer les valeurs des autres. La valeur de la variable fonctionne de la même
manière que pour DEBCONF_DB_FALLBACK.
DEBCONF_DB_REPLACE
Utiliser une base de données particulière au lieu des bases de données utilisées
normalement. Cela peut être utile pour des tests avec une base de données séparée
sans avoir à créer de fichier debconf.conf séparé, ou pour éviter de verrouiller
les bases de données normales.
DEBCONF_SYSTEMRC
Si cette variable d'environnement est définie, debconf ignorera le fichier
~/.debconfrc de l'utilisateur et utilisera à la place le fichier de configuration
du système.
DEBCONF_FORCE_DIALOG
Si cette variable d'environnement est définie, debconf utilisera de préférence
dialog à whiptail pour l'interface dialog.
DEBCONF_FORCE_XDIALOG
Si cette variable d'environnement est définie, debconf utilisera de préférence
Xdialog à whiptail pour l'interface dialog.
DEBCONF_NONINTERACTIVE_SEEN
Positionné à "true", cela positionne le drapeau « seen » pour les questions posées
dans l'interface non interactive.
BOGUES
Probablement beaucoup, il y a beaucoup de code ici.
Si vous présentez un rapport de bogue, assurez-vous d'inclure les informations suivantes :
* l'interface debconf que vous utilisiez lorsque le problème est survenu ;
* ce que vous avez fait pour déclencher le problème ;
* le texte complet des messages d'erreur. Si vous pouvez reproduire le bogue,
faites-le avec DEBCONF_DEBUG='.*' définie et exportée. Cela accélère beaucoup le
débogage.
VOIR AUSSI
debconf.conf(5), debconf-devel(7), dpkg-preconfigure(8), dpkg-reconfigure(8), debconf(1),
AUTEUR
Joey Hess <joeyh@debian.org>
TRADUCTION
Julien Louis <ptitlouis@sysif.net>, 2005
Cyril Brulebois <kibi@debian.org>, 2006
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le paquet debconf.
DEBCONF(7)