Provided by: debconf-doc_1.5.40ubuntu1_all bug

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)