Rechercher une page de manuel
debconf.conf
Langue: fr
Version: 11057 (www.delafond.org - 07/08/07)
Section: 5 (Format de fichier)
Sommaire
NOM
debconf.conf - fichier de configuration de debconfDESCRIPTION
Debconf est un syst�me de configuration pour les paquets Debian. /etc/debconf.conf et ~/.debconfrc sont les fichiers de configuration utilis�s pour d�terminer quelle base de donn�es doit �tre utilis�e. Ces bases de donn�es sont utilis�es pour garder deux types d'informations ; la configuration dynamique des donn�es que l'utilisateur a entr�es et les donn�es statiques des questions. Debconf offre une interface souple et extensible pour la gestion des bases de donn�es. De nouveaux pilotes peuvent �tre cr��s sans efforts et les pilotes peuvent �tre combin�s de diff�rentes fa�ons.SYNOPSIS
# This is a sample config file that is
# sufficient to use 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 s�par� par au moins une ligne blanche. Les lignes de commentaires commen�ant par un caract�re di�se (� # �) sont ignor�es. Le premier paragraphe du fichier est sp�cial et est utilis� pour configurer l'ensemble de debconf. Ce premier paragraphe requiert deux champs :-
- Config
- Sp�cifie le nom de la base de donn�es o� prendre les donn�es de configuration.
- Templates
- Sp�cifie le nom de la base de donn�es � utiliser pour le cache des questions.
-
- Frontend
- L'interface utilis�e par debconf, remplace toute interface indiqu�e dans la base de donn�es de debconf.
- Priority
- La priorit� utilis�e par debconf, remplace toute priorit� indiqu�e dans la base de donn�es de debconf.
- Showold
- Fix� � � true � pour que debconf r�affiche les questions d�j� pos�es. Ce n'est probablement pas ce que vous voulez. Cela peut �tre annul� � la vol�e par la variable d'environnement DEBCONF_SHOWOLD.
- Admin-Email
- L'adresse �lectronique � laquelle Debconf envoie un courriel pour s'assurer que l'administrateur a bien vu une remarque importante. Par d�faut � root �, mais ce peut �tre une adresse �lectronique valide o� envoyer le courriel. Si vous pr�f�rez que debconf ne vous envoie pas de courriel, sp�cifiez une adresse vide. Cela peut �tre annul� � la vol�e par la variable d'environnement DEBCONF_ADMIN_EMAIL.
- Debug
- Si ce champ existe, debconf affichera alors les informations de d�bogage sur la sortie d'erreur standard. La valeur fix�e peut �tre quelque chose comme � user �, � developper �, � db � ou encore une expression rationnelle. G�n�ralement, plut�t que de le configurer en permanence dans un fichier de configuration, vous voudrez activer le d�bogage temporairement, la variable d'environnement DEBCONF_DEBUG peut alors �tre utilis�e � la place pour accomplir ce d�bogage.
- NoWarnings
- S'il existe, debconf n'affichera aucun avertissement. Il peut �tre annul� � la vol�e par la variable d'environnement DEBCONF_NOWARNINGS.
- Log
- Debconf enregistre des informations de d�bogage dans le fichier syslog lorsqu'il fonctionne. La valeur donn�e sert � contr�ler ce qui est enregistr� dans le journal. Voir plus haut Debug pour une explication des valeurs qui peuvent �tre choisies pour contr�ler ce qui est enregistr� dans le journal.
- Sigils
- Certaines interfaces de debconf afficheront des � sceaux � -- petits trucs qui indiquent l'importance de la question. Ils sont affich�s par d�faut, pour les d�sactiver, utilisez Sigils: false.
- Smileys
- Quelques interfaces utilisent de gentilles petites binettes comme sceaux. Si c'est trop gentil et que vous voulez les d�sactiver, utilisez Smilies: false. Pour les interfaces ne les montrant pas par d�faut, Smileys: true essaiera de les activer.
- Terse
- S'il est fix� � � true �, certaines interfaces debconf utiliseront un mode d'affichage concis et sp�cial qui affiche le moins possible. Par d�faut � false. Le mode concis peut �tre choisi temporairement par la variable d'environnement DEBCONF_TERSE.
Config: configdb
Templates: templatedb Chaque paragraphe restant dans le fichier configure une base de donn�es. Un paragraphe de base de donn�es commence par nommer la base de donn�es :
Name: configdb Ensuite, cela indique le pilote � utiliser pour cette base de donn�es. Pour avoir des informations sur les pilotes disponibles, voir la section DRIVER plus bas.
Driver: File Vous pouvez indiquer que la base de donn�es n'est pas essentielle au fonctionnement correct de debconf en disant qu'elle n'est pas requise. Cela mettra le d�sordre dans debconf si la base de donn�es �choue pour une raison ou une autre.
Required: false Vous pouvez marquer une base de donn�es comme en lecture seule et debconf n'�crira rien dedans.
Readonly: true Vous pouvez aussi limiter le type de donn�es pouvant aller dans la base de donn�es avec les lignes Accept- et Reject- ; voir la section ACCESS CONTROLS plus bas. Le reste de chaque paragraphe d'une base de donn�es est utilis� pour fournir une configuration sp�cifique � ce pilote. Par exemple, le pilote Text a besoin de conna�tre un r�pertoire pour y mettre la base de donn�es, vous devriez donc dire :
Filename: /var/cache/debconf/config.dat
PILOTES
Il y a de nombreux pilotes disponibles et on peut en �crire d'autres sans grande difficult�. Les pilotes sont r�partis en deux types. Il y a d'abord les pilotes r�els -- pilotes qui lisent et stockent r�ellement les donn�es dans quelque base de donn�es, qui peut �tre sur le syst�me de fichiers local ou sur un syst�me distant. Il y a ensuite les m�ta-pilotes qui associent diff�rents pilotes pour former des syst�mes plus int�ressants. Commen�ons par les premiers.- File
-
- Ce pilote permet � debconf de stocker une base de donn�es compl�te dans un simple fichier texte. Cela facilite l'archivage, le transfert entre les machines et l'�dition. C'est l'un des formats de base de donn�es les plus compacts en terme d'espace disque utilis�. C'est aussi l'un des formats les plus lents. Parmi les inconv�nients, le fichier doit �tre lu en entier � chaque fois que debconf d�marre ; le sauvegarder est aussi lent. Pour ce pilote, les points suivants sont configurables.
-
-
- Filename
- Le fichier � utiliser comme base de donn�es. Ce champ est obligatoire.
- Mode
- Les permissions du fichier � cr�er s'il n'existe pas. Elles sont par d�faut mises � 600 parce que le fichier peut contenir dans certaines circonstances des mots de passe.
- Format
- Le format du fichier. Voir plus bas la section FORMATS. Le format par d�faut est du type d�fini par la rfc-822.
- Backup
- Si une sauvegarde de l'ancien fichier doit �tre faite avant de le changer. Par d�faut � � true �.
Name: mydb
Driver: File
Filename: /var/cache/debconf/mydb.dat -
- DirTree
-
- Ce pilote permet � debconf de stocker les donn�es dans une structure hi�rarchis�e de type r�pertoire. Les noms des diff�rents questionnaires et questions debconf sont utilis�s pour former des r�pertoires contenant les fichiers. Ce format de base de donn�es est le plus facile � consulter et � modifier � la main. Il a une tr�s bonne vitesse de chargement et de sauvegarde. C'est lui qui utilise le plus d'espace, car tous les petits fichiers et sous-r�pertoires occupent beaucoup de place. Pour ce pilote, les points suivants sont configurables.
-
-
- Directory
- Le r�pertoire o� sont d�pos�s les fichiers. Obligatoire.
- Extension
- Une extension pour pr�fixer les fichiers. Elle ne doit pas �tre une cha�ne vide ; Par d�faut � � .dat �
- Format
- Le format du fichier. Voir la section FORMATS plus bas. Par d�faut, il utilise un format semblable au type d�fini par la rfc-822.
- Backup
- Si une sauvegarde de l'ancien fichier doit �tre faite avant de le changer. Par d�faut � � true �.
Name: mydb
Driver: DirTree
Directory: /var/cache/debconf/mydb
Extension: .txt -
- PackageDir
-
- Ce pilote est un compromis entre les bases de donn�es File et DirTree. Il utilise un r�pertoire 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 donn�es File. Ce pilote est configurable de la m�me mani�re que le pilote DirTree, plus :
-
- Mode
- Les permissions des fichiers cr��s. Par d�faut � 600 parce que les fichiers peuvent contenir dans certaines circonstances des mots de passe. Voici un exemple de paragraphe configurant une base de donn�es qui utilise ce pilote :
Name: mydb
Driver: PackageDir
Directory: /var/cache/debconf/mydb
- LDAP
-
- ATTENTION : Ce pilote est actuellement exp�rimental. Utilisez-le avec pr�caution. Ce pilote acc�de � un r�pertoire LDAP pour les donn�es de configuration de debconf. Les r�pertoires LDAP doivent �tre en lecture seule, � cause de la nature de la b�te. C'est parce que plusieurs acc�s peuvent avoir lieu et il vaut mieux, pour la coh�rence des donn�es, que personne n'essaie de les modifier lorsque cela arrive. Bien s�r, on peut donner la possibilit� de modifier ces r�pertoires lorsque vous voulez mettre � jour les donn�es de configuration. Pour plus d'informations � propos de la configuration d'un serveur LDAP pour debconf, lisez /usr/share/doc/debconf-doc/README.LDAP (du paquet debconf-doc). Pour utiliser ce pilote, vous devez avoir install� le paquet libnet-ldap-perl. Debconf sugg�re ce paquet mais ne d�pend pas de lui. Veuillez �tre attentif � ce qu'implique une base de donn�es debconf distante en ce qui concerne la s�curit�. Ce n'est pas une chose tr�s s�re � faire � moins que vous fassiez confiance � la source et au r�seau intervenant. Pour ce pilote, les points suivants sont configurables.
-
-
- server
- Le nom d'h�te ou l'adresse IP d'un serveur LDAP auquel se connecter.
- port
- Le port de connexion au serveur LDAP. Si aucun n'est donn�, le port par d�faut est utilis�, 389 (ou 686 si vous utilisez SSL).
- basedn
- Le DN sous lequel tous les points de la configuration seront stock�s. Chaque point de configuration est suppos� exister dans un DN de cn=<item name>,<Base DN>. Si cette structure n'est pas suivie, rien ne marche.
- binddn
- Le DN � attacher au r�pertoire. Un lien anonyme sera utilis� s'il n'y en a aucun de sp�cifi�.
- bindpasswd
- Le mot de passe � utiliser dans un attachement authentifi� (utilis� avec binddn, ci-dessus). Si ce n'est pas sp�cifi�, un lien anonyme sera utilis�.
- Cette option ne doit pas �tre utilis�e dans le cas g�n�ral. La liaison anonyme devrait �tre suffisante dans la plupart des cas pour un acc�s en lecture seule. Sp�cifier un DN li� � un mot de passe devrait �tre r�serv� pour les cas o� vous souhaitez mettre � jour vos donn�es de configuration de debconf.
Name: ldapdb
Driver: LDAP
Readonly: true
Server: example.com
BaseDN: cn=debconf,dc=example,dc=com Autre exemple, cette fois la base de donn�es LDAP est sur l'h�te local et peut �tre modifi�e :
Name: ldapdb
Driver: LDAP
Server: localhost
BaseDN: cn=debconf,dc=domain,dc=com
BaseDN: cn=debconf,dc=domain,dc=com
BindPasswd: secret -
- Pipe
-
- Ce pilote sp�cial lit et �crit la base de donn�es depuis l'entr�e/sortie standard. �a peut �tre utile pour les personnes qui ont des besoins sp�cifiques. Pour ce pilote, les points suivants sont configurables.
-
-
- Format
- Le format � lire et �crire. Voir la section FORMAT plus bas. Par d�faut, il utilise un format du type d�fini par la rfc-822.
- Infd
- Num�ro du descripteur de fichier � lire. La lecture se fait par d�faut depuis l'entr�e standard. Si elle est fix�e � � none �, la base de donn�es ne lira aucune donn�e au d�marrage
- Outfd
- Num�ro du descripteur de fichier � �crire. L'�criture se fait par d�faut sur la sortie standard.
-
- Stack
-
- Ce pilote superpose plusieurs autres bases de donn�es (de tous types) et permet l'acc�s � celles-ci comme si elles n'en formaient qu'une seule. Lorsque debconf demande une valeur, la premi�re base dans la pile qui contient cette valeur la retourne. Si debconf �crit quelque chose dans la base de donn�es, l'�criture se fait normalement dans le premier pilote de la pile qui contient l'�l�ment modifi� par debconf ; s'il n'y en a pas, le nouvel �l�ment est ajout� � la premi�re base de donn�es de la pile sur laquelle on peut �crire. Les choses deviennent plus int�ressantes si l'une des bases de donn�es de la pile est en lecture seule. Consid�rez une pile des bases de donn�es foo, bar et baz, o� foo et baz sont toutes les deux en lecture seule. Debconf veut changer un �l�ment et cet �l�ment est pr�sent seulement dans baz, qui est en lecture seule. Le pilote de pile est assez malin pour r�aliser que �a ne fonctionne pas, il copiera l'�l�ment de baz vers bar et l'�criture aura lieu dans bar. Maintenant l'�l�ment de baz est cach� par celui de bar et il ne sera plus visible par debconf. Ce genre de cas est particuli�rement utile si vous voulez pointer beaucoup de syst�mes vers une base de donn�es centrale en lecture seule, tout en permettant la r��criture des �l�ments sur chaque syst�me. Si l'on ajoute des contr�les d'acc�s, les piles permettent de faire beaucoup d'autres choses int�ressantes, comme rediriger tous les mots de passe vers une base de donn�es pendant qu'une autre base de donn�es en-dessous s'occupe de tout le reste. Pour configurer une pile, il n'y a besoin que d'un petit bout de configuration :
-
-
- Stack
- C'est l� o� vous sp�cifiez une liste d'autres bases de donn�es, par nom, pour dire de quoi est compos�e la pile.
Name: megadb
Driver: stack
Stack: passworddb, configdb, companydb ATTENTION : Le pilote de piles n'a pas encore �t� vraiment test�. Utilisez-le � vos propres risques. -
- Ce pilote transmet toutes les requ�tes vers un autre pilote. Mais il copie aussi toutes les requ�tes d'�criture vers un pilote de sauvegarde. Pour configurer ce pilote, vous devez sp�cifier les champs suivants :
-
-
- Db
- La base de donn�es � lire et sur laquelle �crire.
- Backupdb
- Le nom de la base de donn�es o� envoyer les copies � �crire.
Name: backup
Driver: Backup
Backupdb: mydb
Backup: mybackupdb -
- Ce pilote transmet toutes les requ�tes vers un autre pilote, affichant toutes les informations de d�bogage � propos des requ�tes et de leurs r�sultats. Pour configurer ce pilote, vous devez sp�cifiez les champs suivants :
-
-
- Db
- La base de donn�es � lire et sur laquelle �crire.
-
CONTR�LE D'ACC�S
Quand vous configurez une base de donn�es, vous pouvez aussi utiliser quelques champs pour indiquer les contr�les d'acc�s. Vous pouvez sp�cifier, par exemple, qu'une base de donn�es n'accepte que les mots de passe ou faire une base de donn�es qui n'accepte que les choses ayant dans leur nom � foo �.- Readonly
- Comme on l'a mentionn�, ce contr�le d'acc�s, s'il est fix� � � true �, rend une base de donn�es accessible qu'en lecture seule. Debconf en lira les valeurs mais n'�crira jamais rien dessus.
- Accept-Name
- Le texte de ce champ est une expression rationnelle compatible avec perl qui s'accorde avec les noms des �l�ments requis de la base de donn�es. La base de donn�es permettra � debconf d'y acc�der ou de la modifier seulement si le nom d'un �l�ment concorde avec l'expression rationnelle.
- Reject-Name
- Comme Accept-Name, except� que tout �l�ment correspondant � cette expression rationnelle sera rejet�.
- Accept-Type
- Une autre expression rationnelle, qui correspond avec le type de l'�l�ment auquel on acc�dera. L'acc�s sera accord� seulement si le type correspond � l'expression rationnelle.
- Reject-Type
- Comme Accept-Type, except� que tout type correspondant � cette expression rationnelle sera rejet�.
FORMATS
Quelques pilotes utilisent des modules de format pour contr�ler le format r�el de stockage des bases de donn�es sur le disque. Ces formats sont actuellement support�s :- 822
- C'est un format de fichier vaguement bas� sur le format de la rfc-822 pour les ent�tes des courriels. Des formats similaires sont utilis�s partout dans Debian ; dans le fichier de statut de dpkg, et d'autres.
EXEMPLE
Voici un exemple de fichier debconf.conf parmi les plus compliqu�s.# Ce paragraphe est utilis� pour la
# configuration g�n�rale de debconf.
Config: stack
Templates: templates
Log-To: syslog
Debug: developer
# Ma base de donn�es locale.
Name: mydb
Driver: DirTree
Directory: /var/cache/debconf/config
# C'est une autre base de donn�es que
# j'utilise pour garder seulement la
# configuration de mon serveur X.
Name: X
Driver: File
Filename: /etc/X11/debconf.dat
Mode: 644
# Il est difficile de savoir quelles
# 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 donn�es g�n�rale de notre
# soci�t�, en lecture seule (pour moi !).
Name: company
Driver: LDAP
Server: debconf.foo.com
BaseDN: cn=debconf,dc=foo,dc=com
BindDN: uid=admin,dc=foo,dc=com
BindPasswd: secret
Readonly: true
# Je ne veux pas que les mots de passe tra�nent par l�.
Reject-Type: password
# Si cette base de donn�es n'est pas disponible
# pour quelque raison que ce soit, on continue.
Required: false
# J'utilise cette base de donn�es pour
# conserver les mots de passe en s�ret�.
Name: passwords
Driver: File
Filename: /etc/debconf/passwords
Mode: 600
Accept-Type: password
# Rassemblons toutes ses bases
# de donn�es dans une pile.
Name: stack
Driver: Stack
Stack: passwords, X, mydb, company
# Donc, tous les mots de passe vont dans la
# base de donn�es passwords. La plupart des objets
# concernant la configuration de X vont dans la
# base de donn�es X, et tout le reste va dans ma
# base de donn�es principale. Les valeurs sont
# recherch�es tour � tour dans chacune de ces bases
# de donn�es et si une valeur particuli�re n'est trouv�e
# nulle part, elle est recherch�e dans la base de
# donn�es LDAP de la compagnie (� moins que ce ne
# soit un mot de passe).
# Une base de donn�es est aussi utilis�e
# pour conserver les questionnaires. Nous
# n'avons pas besoin de le faire � notre go�t.
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 remplac�e par la valeur de la variable d'environnement nomm�e ainsi. La casse des noms des champs (la partie de la ligne avant le deux-points) n'est pas importante. Cependant, pour les valeurs, la casse importe.AM�LIORATIONS PR�VUES
Plus de pilotes et de formats. Voici quelques id�es : Un pilote SQL, avec la possibilit� d'acc�der � une base de donn�es distante. Un pilote DHCP, qui rend disponible certaines choses sp�cifiques comme le nom d'h�te, l'adresse IP et les serveurs DNS. Un pilote qui prend ses valeurs dans les champs TXT des enregistrements DNS publics. Un format qui est compatible avec la sortie de debconf. Un pilote d'annulation, qui peut annuler la valeur d'un champ ou les drapeaux de toutes les requ�tes qui lui sont adress�es.FICHIERS
/etc/debconf.conf ~/.debconfrcVOIR AUSSI
debconf(7)AUTEUR
Joey Hess <joeyh@debian.org>TRADUCTION
Julien Louis <leonptitlouis@ifrance.com>Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre