Linux Certif

Toute la documentation sur la certification Linux LPI

debconf.conf

NOM

debconf.conf - fichier de configuration de debconf

DESCRIPTION

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.

Champs additionnels qui peuvent �tre ajout�s :

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.

Par exemple, le premier paragraphe d'un fichier devrait ressembler � �a :
  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 �.

Voici un exemple de paragraphe configurant une base de donn�es qui utilise ce pilote :
  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 �.

Voici un exemple de paragraphe configurant une base de donn�es 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 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.

Voici un exemple de paragraphe configurant une base de donn�es qui utilise ce pilote, en supposant que la base de donn�es distante est sur example.com et qu'on peut y acc�der anonymement :
  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.

C'est tout pour les pilotes r�els, nous allons � pr�sent voir les m�ta-pilotes.

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.

Par exemple :
  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.

Backup

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.

Par exemple :
  Name: backup
  Driver: Backup
  Backupdb: mydb
  Backup: mybackupdb

Debug

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 ~/.debconfrc

VOIR AUSSI

debconf(7)

AUTEUR

Joey Hess <joeyh@debian.org>

TRADUCTION

Julien Louis <leonptitlouis@ifrance.com>