Provided by:
debconf-doc_1.5.40ubuntu1_all 
NOM
debconf.conf - fichier de configuration de debconf
DESCRIPTION
Debconf est un systeme de configuration pour les paquets Debian.
/etc/debconf.conf et ~/.debconfrc sont les fichiers de configuration
utilises pour determiner la base de donnees qui doit etre utilisee. Ces
bases de donnees sont utilisees pour garder deux types d'informations ;
les donnees dynamiques de configuration que l'utilisateur a definies et
les donnees statiques des questions. Debconf offre une interface souple
et extensible pour la gestion des bases de donnees. De nouveaux pilotes
peuvent etre crees sans effort et les pilotes peuvent etre combines de
differentes facons.
SYNOPSIS
# Ceci est un exemple de fichier de configuration
# suffisant pour utiliser debconf.
Config: configdb
Templates: templatedb
Name: configdb
Driver: File
Filename: /var/cache/debconf/config.dat
Name: templatedb
Driver: File
Mode: 644
Filename: /var/cache/debconf/templates.dat
FORMAT DE FICHIER
Le format de ce fichier est une suite de paragraphes, chacun d'eux
separe par au moins une ligne blanche. Les lignes de commentaires,
commencant par un caractere diese (<< # >>), sont ignorees.
Le premier paragraphe du fichier est special et est utilise pour
configurer l'ensemble de debconf. Ce premier paragraphe requiert deux
champs :
Config Indique le nom de la base de donnees ou prendre les
donnees de configuration.
Templates
Indiquer le nom de la base de donnees a utiliser pour le
cache des questions.
Champs additionnels pouvant etre ajoutes :
Frontend
L'interface utilisee par debconf, remplace toute
interface indiquee dans la base de donnees de debconf.
Priority
La priorite utilisee par debconf, remplace toute priorite
indiquee dans la base de donnees de debconf.
Admin-Email
L'adresse electronique a laquelle Debconf envoie un
courriel pour s'assurer que l'administrateur a bien vu
une remarque importante. Par defaut << root >>, mais ce
peut etre une adresse electronique valable ou envoyer le
courriel. Si vous preferez que debconf ne vous envoie pas
de courriel, specifiez une adresse vide. Cela peut etre
annule a la volee par la variable d'environnement
DEBCONF_ADMIN_EMAIL.
Debug Si ce champ existe, debconf affichera alors les
informations de debogage sur la sortie d'erreur standard.
La valeur fixee peut etre quelque chose comme << user >>,
<< developer >>, << db >> ou encore une expression
rationnelle. Generalement, plutot que de le configurer de
maniere figee dans un fichier de configuration, vous
voudrez activer le debogage temporairement, la variable
d'environnement DEBCONF_DEBUG peut alors etre utilisee a
la place pour accomplir ce debogage.
NoWarnings
S'il existe, debconf n'affichera aucun avertissement. Il
peut etre annule a la volee par la variable
d'environnement DEBCONF_NOWARNINGS.
Log Debconf enregistre des informations de debogage lors de
son fonctionnement, dans le fichier syslog. La valeur
donnee sert a controler ce qui est enregistre dans le
journal. Voir plus haut Debug pour une explication des
valeurs qui peuvent etre choisies pour controler ce qui
est enregistre dans le journal.
Terse S'il est fixe a << true >>, certaines interfaces debconf
utiliseront un mode d'affichage concis et special qui
affiche le moins d'informations possible. Par defaut a
<< false >>. Le mode concis peut etre choisi
temporairement grace a la variable d'environnement
DEBCONF_TERSE.
Par exemple, le premier paragraphe d'un fichier devrait ressembler a
ca :
Config: configdb
Templates: templatedb
Chaque paragraphe restant dans le fichier configure une base de
donnees. Un paragraphe de base de donnees commence par nommer la base
de donnees :
Name: configdb
Ensuite, on indique le pilote a utiliser pour cette base de donnees.
Pour avoir des informations sur les pilotes disponibles, voir la
section DRIVER plus bas.
Driver: File
Vous pouvez indiquer que la base de donnees n'est pas essentielle au
fonctionnement correct de debconf en specifiant qu'elle n'est pas
requise. Cela mettra le desordre dans debconf en cas de defaillance
quelconque de la base de donnees.
Required: false
Vous pouvez marquer une base de donnees comme etant en lecture seule,
debconf n'y ecrira alors rien.
Readonly: true
Vous pouvez aussi limiter le type de donnees pouvant aller dans la base
de donnees avec les lignes Accept- et Reject- ; voir la section
CONTROLES D'ACCES plus bas.
Le reste de chaque paragraphe d'une base de donnees est utilise pour
fournir une configuration specifique a ce pilote. Par exemple, le
pilote Text a besoin de savoir dans quel repertoire mettre la base de
donnees, vous devriez donc entrer :
Filename: /var/cache/debconf/config.dat
PILOTES
Il y a de nombreux pilotes disponibles et on peut en ecrire d'autres
sans grande difficulte. Les pilotes sont repartis en deux types. Il y a
d'abord les pilotes reels -- pilotes qui lisent et stockent reellement
les donnees dans quelque sorte de base de donnees, qui peut se trouver
sur le systeme de fichiers local ou sur un systeme distant. Il y a
ensuite les meta-pilotes qui associent differents pilotes pour former
des systemes plus interessants. Commencons par les premiers.
File
Ce pilote permet a debconf de stocker une base de donnees
complete dans un simple fichier texte. Cela facilite
l'archivage, le transfert entre les machines et
l'edition. C'est l'un des formats de base de donnees les
plus compacts en terme d'espace disque utilise. C'est
aussi l'un des formats les plus lents.
Parmi les inconvenients, le fichier doit etre lu en
entier a chaque fois que debconf demarre ; de meme, le
sauvegarder est lent.
Pour ce pilote, les points suivants sont configurables.
Filename
Fichier a utiliser comme base de donnees.
Ce champ est obligatoire.
Mode Les permissions du fichier a creer s'il
n'existe pas. Elles sont par defaut mises a
600 parce que, dans certains circonstances,
le fichier peut contenir des mots de passe.
Format Format du fichier. Voir plus bas la section
FORMATS. Le format par defaut est du type
defini par la RFC-822.
Backup Indique si une sauvegarde de l'ancien
fichier doit etre effectuee avant de le
modifier. Par defaut a << true >> (vrai).
Voici un exemple de paragraphe configurant une base de
donnees qui utilise ce pilote :
Name: mydb
Driver: File
Filename: /var/cache/debconf/mydb.dat
DirTree
Ce pilote permet a debconf de stocker les donnees dans
une structure hierarchisee de type repertoire. Les noms
des differents questionnaires et questions debconf sont
utilises pour former des repertoires contenant les
fichiers. Ce format de base de donnees est le plus facile
a consulter et a modifier a la main. Il a une tres bonne
vitesse de chargement et de sauvegarde. C'est lui qui
utilise le plus d'espace, car tous les petits fichiers et
sous-repertoires occupent beaucoup de place.
Pour ce pilote, les points suivants sont configurables.
Directory
Repertoire ou sont deposes les fichiers.
Obligatoire.
Extension
Extension a ajouter aux noms de fichiers.
Ce doit etre une chaine de caracteres non
vide ; par defaut, sa valeur est << .dat >>
Format Format du fichier. Voir plus bas la section
FORMATS. Le format par defaut est du type
defini par la RFC-822.
Backup Indique si une sauvegarde de l'ancien
fichier doit etre effectuee avant de le
modifier. Par defaut a << true >> (vrai).
Voici un exemple de paragraphe configurant une base de
donnees qui utilise ce pilote :
Name: mydb
Driver: DirTree
Directory: /var/cache/debconf/mydb
Extension: .txt
PackageDir
Ce pilote est un compromis entre les bases de donnees
File et DirTree. Il utilise un repertoire dans lequel il
y a (approximativement) un fichier par paquet qui utilise
debconf. C'est assez rapide, bien qu'utilisant un peu
plus d'espace que le pilote de base de donnees File.
Ce pilote est configurable de la meme maniere que le
pilote DirTree, plus :
Mode Les permissions des fichiers crees. Par defaut a
600 parce que les fichiers peuvent, dans certaines
circonstances, contenir des mots de passe.
Voici un exemple de paragraphe configurant une base de
donnees qui utilise ce pilote :
Name: mydb
Driver: PackageDir
Directory: /var/cache/debconf/mydb
LDAP
ATTENTION : Ce pilote est actuellement experimental.
Utilisez-le avec precaution.
Ce pilote accede a un repertoire LDAP pour les donnees de
configuration de debconf. Les repertoires LDAP doivent
etre en lecture seule, a cause de la nature de la bete.
C'est parce que plusieurs acces peuvent avoir lieu et il
vaut mieux, pour la coherence des donnees, que personne
n'essaie de les modifier lorsque cela arrive. Bien sur,
on peut donner la possibilite de modifier ces repertoires
lorsque vous voulez mettre a jour les donnees de
configuration.
Pour plus d'informations a propos de la configuration
d'un serveur LDAP pour debconf, veuillez lire
/usr/share/doc/debconf-doc/README.LDAP (du paquet
debconf-doc).
Pour utiliser ce pilote, vous devez avoir installe le
paquet libnet-ldap-perl. Debconf suggere ce paquet mais
ne depend pas de lui.
Veuillez etre attentif a ce qu'implique une base de
donnees debconf distante en ce qui concerne la securite.
Ce n'est pas une chose tres sure a faire a moins que vous
fassiez confiance a la source et au reseau intervenant.
Pour ce pilote, les points suivants sont configurables.
server Nom d'hote ou adresse IP d'un serveur LDAP
auquel se connecter.
port Port de connexion au serveur LDAP. Si aucun
n'est donne, le port par defaut est
utilise.
basedn Le DN sous lequel tous les points de la
configuration seront stockes. Chaque point
de configuration est suppose exister dans
un DN de cn=<item name>,<Base DN>. Si cette
structure n'est pas respectee, rien ne
fonctionne.
binddn DN a attacher au repertoire. Un lien
anonyme sera utilise s'il n'y en a aucun de
specifie.
bindpasswd
Mot de passe a utiliser dans un attachement
authentifie (utilise avec binddn,
ci-dessus). Si ce n'est pas specifie, un
lien anonyme sera utilise.
Cette option ne doit pas etre utilisee dans
le cas general. La liaison anonyme devrait
etre suffisante dans la plupart des cas
pour un acces en lecture seule. Specifier
un DN lie a un mot de passe devrait etre
reserve pour les cas ou vous souhaitez
mettre a jour vos donnees de configuration
de debconf.
keybykey
Activer l'acces aux entrees individuelles
de l'annuaire LDAP au lieu de toutes les
telecharger au debut. Cela est tres utile
si vous voulez analyser des requetes
debconf depuis les journaux de LDAP. Cette
option permet aussi d'ecrire du code de
gestion sur le serveur LDAP.
Notez que lorsque cette option est activee,
la connexion au serveur LDAP reste active
durant toute l'execution de debconf. Ce
comportement est different lorsque vous
telecharger toutes les donnees d'un seul
bloc car deux connexions au serveur LDAP
sont realisees ; une au debut pour
recuperer toutes les donnees et une a la
fin pour sauvegarder les eventuelles
modifications.
Voici un exemple de paragraphe configurant une base de
donnees qui utilise ce pilote, en supposant que la base
de donnees distante est sur exemple.com et qu'on peut y
acceder anonymement :
Name: ldapdb
Driver: LDAP
Readonly: true
Server: example.com
BaseDN: cn=debconf,dc=example,dc=com
KeyByKey: 0
Autre exemple, cette fois la base de donnees LDAP est sur
l'hote local et peut etre modifiee :
Name: ldapdb
Driver: LDAP
Server: localhost
BaseDN: cn=debconf,dc=domain,dc=com
BindPasswd: secret
KeyByKey: 1
Pipe
Ce pilote special lit et ecrit la base de donnees depuis
l'entree/sortie standard. Ca peut etre utile pour les
personnes qui ont des besoins specifiques.
Pour ce pilote, les points suivants sont configurables.
Format Format a lire et ecrire. Voir la section
FORMATS plus bas. Par defaut, il utilise un
format du type defini par la RFC-822.
Infd Numero du descripteur de fichier a lire. La
lecture se fait par defaut depuis l'entree
standard. S'il est fixe a << none >>, la
base de donnees ne lira aucune donnee au
demarrage.
Outfd Numero du descripteur de fichier a ecrire.
L'ecriture se fait par defaut sur la sortie
standard. S'il est fixe a << none >>, la
base de donnees va etre detruite lors de
l'arret.
C'est tout pour les pilotes reels, nous allons a present voir
les meta-pilotes.
Stack
Ce pilote superpose plusieurs autres bases de donnees (de
tout type) et permet l'acces a celles-ci comme si elles
n'en formaient qu'une seule. Lorsque debconf demande une
valeur, la premiere base dans la pile qui contient cette
valeur la retourne. Si debconf ecrit quelque chose dans
la base de donnees, l'ecriture se fait normalement dans
le premier pilote de la pile qui contient l'element
modifie par debconf ; s'il n'y en a pas, le nouvel
element est ajoute a la premiere base de donnees de la
pile sur laquelle on peut ecrire.
Les choses deviennent plus interessantes si l'une des
bases de donnees de la pile est en lecture seule.
Considerez une pile des bases de donnees toto, titi et
tata, ou toto et tata sont toutes les deux en lecture
seule. Debconf veut changer un element et cet element
n'est present que dans tata, qui est en lecture seule. Le
pilote de pile est assez malin pour realiser que ca ne
fonctionne pas, il copiera l'element de tata vers titi et
l'ecriture aura lieu dans titi. Maintenant l'element de
tata est cache par celui de titi et il ne sera plus
visible de debconf.
Ce genre de choses est particulierement utile si vous
voulez faire pointer beaucoup de systemes vers une base
de donnees centrale en lecture seule, tout en permettant
la reecriture des elements sur chaque systeme. Si l'on
ajoute des controles d'acces, les piles permettent de
faire beaucoup d'autres choses interessantes, comme
rediriger tous les mots de passe vers une base de donnees
pendant qu'une autre base de donnees en dessous s'occupe
de tout le reste.
Un seul element de configuration est necessaire pour
configurer une pile :
Stack C'est la que vous specifiez une liste
d'autres bases de donnees, par nom, pour
dire de quoi est composee la pile.
Par exemple :
Name: megadb
Driver: stack
Stack: passworddb, configdb, companydb
ATTENTION : le pilote de piles n'a pas encore ete
vraiment teste. Utilisez-le a vos risques et perils.
Backup
Ce pilote transmet toutes les requetes vers un autre
pilote. Mais il copie aussi toutes les requetes
d'ecriture vers un pilote de sauvegarde.
Pour configurer ce pilote, vous devez specifier les
champs suivants :
Db Base de donnees a lire et dans laquelle
ecrire.
Backupdb
Nom de la base de donnees ou envoyer les
copies a ecrire.
Par exemple :
Name: backup
Driver: Backup
Db: mydb
Backupdb: mybackupdb
Debug
Ce pilote transmet toutes les requetes vers un autre
pilote, affichant toutes les informations de debogage a
propos des requetes et de leurs resultats.
Pour configurer ce pilote, vous devez specifier les
champs suivants :
Db Base de donnees a lire et dans laquelle
ecrire.
CONTR^OLES D'ACC`ES
Quand vous configurez une base de donnees, vous pouvez aussi
utiliser des champs pour indiquer les controles d'acces. Vous
pouvez specifier, par exemple, qu'une base de donnees n'accepte
que les mots de passe ou faire qu'une base de donnees n'accepte
que les choses ayant dans leur nom << toto >>.
Readonly
Comme on l'a mentionne, ce controle d'acces, s'il est
fixe a << true >>, rend une base de donnees accessible
uniquement en lecture seule. Debconf en lira les valeurs
mais n'y ecrira jamais rien.
Accept-Name
Le texte de ce champ est une expression rationnelle
compatible Perl (<< PCRE >>) qui correspond aux noms des
elements requis de la base de donnees. La base de donnees
ne permettra a debconf d'y acceder ou de la modifier que
si le nom d'un element concorde avec l'expression
rationnelle.
Reject-Name
Comme Accept-Name, excepte que tout element correspondant
a cette expression rationnelle sera rejete.
Accept-Type
Autre expression rationnelle, correspondant au type de
l'element auquel on accedera. L'acces ne sera accorde que
si le type correspond a l'expression rationnelle.
Reject-Type
Comme Accept-Type, excepte que tout type correspondant a
cette expression rationnelle sera rejete.
FORMATS
Quelques pilotes utilisent des modules de format pour controler
le format reel d'enregistrement des bases de donnees sur le
disque. Ces formats sont actuellement geres :
822 C'est un format de fichier vaguement base sur le format
de la RFC-822 pour les entetes de courriel. Des formats
similaires sont utilises partout dans Debian ; dans le
fichier d'etat de dpkg, et autres.
EXEMPLE
Voici un exemple de fichier debconf.conf parmi les plus
compliques.
# Ce paragraphe est utilise pour la
# configuration generale de debconf.
Config: stack
Templates: templates
Log: developer
Debug: developer
# Ma base de donnees locale.
Name: mydb
Driver: DirTree
Directory: /var/cache/debconf/config
# C'est une autre base de donnees que
# j'utilise pour ne garder que la
# configuration de mon serveur X.
Name: X
Driver: File
Filename: /etc/X11/debconf.dat
Mode: 644
# Il est difficile de savoir quelles
# sont le questions concernent X ; il faudrait
# utiliser une arborescence plus profonde
# pour que je puisse n'accepter que les
# correspondances avec ^X/
# Passons.
Accept-Name: xserver|xfree86|xbase
# C'est la base de donnees generale de notre
# societe, en lecture seule (pour moi !).
Name: company
Driver: LDAP
Server: debconf.toto.com
BaseDN: cn=debconf,dc=toto,dc=com
BindDN: uid=admin,dc=toto,dc=com
BindPasswd: secret
Readonly: true
# Je ne veux pas que les mots de passe trainent par la.
Reject-Type: password
# Si cette base de donnees n'est pas disponible
# pour quelque raison que ce soit, on continue.
Required: false
# J'utilise cette base de donnees pour
# conserver les mots de passe en surete.
Name: passwords
Driver: File
Filename: /etc/debconf/passwords
Mode: 600
Accept-Type: password
# Rassemblons toutes ces bases
# de donnees dans une pile.
Name: stack
Driver: Stack
Stack: passwords, X, mydb, company
# Donc, tous les mots de passe vont dans la
# base de donnees passwords. La plupart des objets
# concernant la configuration de X vont dans la
# base de donnees X, et tout le reste va dans ma
# base de donnees principale. Les valeurs sont
# recherchees tour a tour dans chacune de ces bases
# de donnees et si une valeur particuliere n'est trouvee
# nulle part, elle est recherchee dans la base de
# donnees LDAP au niveau de la societe (a moins que ce ne
# soit un mot de passe).
# Une base de donnees est aussi utilisee
# pour conserver les questionnaires. Nous
# n'avons pas besoin d'y mettre autant de fantaisie.
Name: templates
Driver: File
Mode: 644
Format: 822
Filename: /var/cache/debconf/templates
NOTES
Si vous utilisez dans ce fichier quelque chose comme ${HOME},
cette variable sera remplacee par la valeur de la variable
d'environnement nommee ainsi.
Les variables d'environnement peuvent aussi etre utilisees pour
remplacer a la volee les bases de donnees utilisees, voir
debconf(7).
Il n'est pas tenu compte de la casse des noms des champs (la
partie de la ligne avant le deux-points). Cependant, les valeurs
sont sensibles a la casse.
AM'ELIORATIONS PR'EVUES
Autres pilotes et formats. Voici quelques idees : un pilote SQL,
avec la possibilite d'acceder a une base de donnees distante ;
un pilote DHCP, qui rend disponible certaines choses specifiques
comme le nom d'hote, l'adresse IP et les serveurs DNS ; un
pilote qui prend ses valeurs dans les champs TXT des
enregistrements DNS publics ; un format compatible avec la
sortie de cdebconf ; un pilote d'annulation, qui peut annuler la
valeur d'un champ ou les drapeaux de toutes les requetes qui lui
sont adressees.
FICHIERS
/etc/debconf.conf
~/.debconfrc
VOIR AUSSI
debconf(7)
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 ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue
sur le paquet debconf.
DEBCONF.CONF(5)