Provided by: debconf-doc_1.5.40ubuntu1_all bug

NOMBRE

       debconf.conf - Fichero de configuracion de debconf

DESCRIPCI'ON

       Debconf   es  un  sistema  de  configuracion  de  paquetes  de  Debian.
       <</etc/debconf.conf>>  y   <<~/.debconfrc>>   son   los   ficheros   de
       configuracion  que  usa  debconf para determinar las bases de datos que
       deberia usar. Estas bases de datos guardan dos  tipos  de  informacion;
       los  datos dinamicos de configuracion que el usuario introduce, y datos
       estaticos de plantilla. Debconf ofrece un  sistema  de  base  de  datos
       flexible y extensible. Puede crear controladores nuevos con un esfuerzo
       minimo, y combinar conjuntos de controladores de varias maneras.

SINOPSIS

         # Este es un fichero de configuracion de
         # ejemplo suficiente para usar debconf.
         Config: configdb
         Templates: templatedb

         Name: configuracion-base-de-datos
         Driver: File
         Filename: /var/cache/debconf/config.dat

         Name: base-de-datos-de-plantillas
         Driver: File
         Mode: 644
         Filename: /var/cache/debconf/templates.dat

FORMATO DEL FICHERO

       El formato de este fichero es una serie de definiciones separadas, como
       minimo,  por  una  linea vacia. Se ignoran las lineas de comentario que
       empiezan con <<#>>.

       La primera definicion del fichero es especial, y se usa para configurar
       debconf  al  completo.  Es  necesario que haya dos campos en la primera
       definicion:

              Config Define el nombre de la base de datos desde la cual cargar
                     los datos de configuracion.

              Templates
                     Define  el  nombre  de  la  base  de datos a usar para el
                     almacen (<<cache>>) de plantillas.

       Los campos adicionales que se pueden usar incluyen:

              Frontend
                     La interfaz que Debconf deberia usar, anulando  cualquier
                     interfaz definida en la base de datos de debconf.

              Priority
                     La prioridad que Debconf deberia usar, anulando cualquier
                     prioridad definida en la base de datos de debconf.

              Admin-Email
                     La direccion de correo electronico al que Debconf deberia
                     enviar un correo para asegurar que el administrador ve un
                     mensaje de importancia. El valor predefinido es <<root>>,
                     pero   puede   definir   cualquier  direccion  de  correo
                     electronico valido al que enviar el correo. Si desea  que
                     debconf  nunca  le  mande  un  correo, deje un espacio en
                     blanco en lugar de una direccion. Esto se puede anular en
                     el     momento     con    la    variable    de    entorno
                     <<DEBCONF_ADMIN_EMAIL>>.

              Debug  Si se define, hara que  debconf  muestre  informacion  de
                     depuracion  a  traves  de la salida de error estandar. El
                     valor con el que se define puede ser algo como  <<user>>,
                     <<developer>>,    <<db>>   o   una   expresion   regular.
                     Habitualmente,  querra   activar   la   depuracion   solo
                     ocasionalmente  en  lugar de definirlo permanentemente en
                     el fichero de configuracion. Para ello puede  definir  la
                     variable de entorno <<DEBCONF_DEBUG>>.

              NoWarnings
                     Si   se   define,  evitara  que  debconf  muestre  avisos
                     relacionados con varios eventos. Puede anular esto en  el
                     momento      con      la      variable     de     entorno
                     <<DEBCONF_NOWARNINGS>>.

              Log    Hace que debconf registre la informacion de depuracion en
                     el   registro   del   sistema   (<<syslog>>)  durante  la
                     ejecucion. El valor con el que se define controla que  se
                     registra.   Consulte  <<Debug>>,  mas  arriba,  para  una
                     explicacion de los valores que  se  pueden  definir  para
                     controlar lo que se registra.

              Terse  Si  se  define con <<true>> (verdadero), hara que algunas
                     interfaces de debconf usen un  modo  conciso  (<<terse>>)
                     que  muestra  en la salida la minima informacion posible.
                     <<false>> por omision. El modo conciso se  puede  activar
                     temporalmente    mediante    la   variable   de   entorno
                     <<DEBCONF_TERSE>>.

       Por ejemplo, la primera definicion  de  un  fichero  puede  tener  este
       aspecto:
         Config: configuracion-base-de-datos
         Templates: base-de-datos-de-plantillas

       Cada definicion restante en el fichero configura una base de datos. Una
       definicion de una base de datos empieza denominando la base de datos:
         Name: configuracion-base-de-datos

       Despues, se indica el controlador que se deberia usar para esta base de
       datos.  Consulte  <<CONTROLADORES>>, mas abajo, para informacion acerca
       de los controladores disponibles.
         Driver: File

       Puede indicar que la base de datos no  es  esencial  para  el  correcto
       funcionamiento  de  debconf  indicando que no es obligatorio. Esto hara
       que debconf prosiga en el caso de que la base de datos falle.
         Required: false

       Puede marcar la base de datos  como  de  solo  lectura,  y  debconf  no
       escribira nada en el.
         Readonly: true

       Tambien  puede limitar el tipo de datos que pueden entrar en la base de
       datos con las lineas <<Accept->> y <<Reject->>; consulte mas  abajo  la
       seccion <<CONTROLES DE ACCESO>>.

       El  resto  de  la  definicion  de  cada  base  de  datos  se usara para
       proporcionar informacion especifica de ese controlador. Por ejemplo, el
       controlador  <<Text>>  necesita  conocer  el directorio donde alojar la
       base de datos, asi que podria usar:
         Filename: /var/cache/debconf/config.dat

CONTROLADORES

       Dispone de un gran  numero  de  controladores  (<<drivers>>),  y  puede
       escribir  mas  con  poca dificultad. Los controladores son de dos tipos
       generales. Primero estan los controladores  reales;  controladores  que
       acceden  y  guardan  datos  de  forma  directa en algun tipo de base de
       datos, el cual puede estar en el sistema de ficheros  actual  o  en  un
       sistema remoto. Despues estan los metacontroladores, que combinan otros
       controladores para asi crear sistemas mas interesantes. Vamos a empezar
       con el primero.

       File
              Este  controlador  de  base  de datos permite que debconf
              guarde una base de datos completa en un unico fichero  de
              texto  simple.  Esto facilita su archivado, transferencia
              entre maquinas y edicion. Es uno de los formatos de  base
              de  datos  mas  compacto en terminos del espacio en disco
              que usa. Tambien es uno de los mas lentos.

              La desventaja es que el fichero se  tiene  que  leer  por
              completo  cada  vez  que  debconf  arranca,  y el acto de
              guardar tambien es lento.

              Puede  configurar  las  siguientes   opciones   de   este
              controlador.

                     Filename
                            El  fichero a usar como base de datos. Este
                            campo es obligatorio.

                     Mode   Los permisos a otorgar al fichero  en  caso
                            de  que  no existe. El valor por omision es
                            600, ya que en  algunos  casos  el  fichero
                            puede contener contrasenas.

                     Format El    formato    del    fichero.   Consulte
                            <<FORMATOS>>  mas  abajo.  El   valor   por
                            omision es un formato tipo rfc-822.

                     Backup Si  se  deberia crear una copia de respaldo
                            del fichero antiguo antes  de  modificarlo.
                            <<true>> por omision.

              Una  definicion de ejemplo configurando una base de datos
              con este controlador:

                Name: mi-base-de-datos
                Driver: File
                Filename: /var/cache/debconf/mydb.dat

       DirTree
              Este controlador de  base  de  datos  permite  a  debconf
              guardar   datos   en   una   estructura   jerarquica   de
              directorios. Los nombres de las diferentes plantillas  de
              debconf  y  preguntas se usan literalmente para crear los
              directorios que contienen ficheros. El  formato  de  esta
              base  de  datos  es  la mas facil de explorar y manipular
              directamente.  Tiene  una  gran  velocidad  de  carga   y
              guardado  de  datos.  Habitualmente,  es el que ocupa mas
              espacio, ya que varios ficheros pequenos y subdirectorios
              toman un espacio adicional.

              Puede   configurar   las   siguientes  opciones  de  este
              controlador.

                     Directory
                            El directorio donde guardar  los  ficheros.
                            Obligatorio.

                     Extension
                            La  extension  a  anadir  a  los nombres de
                            fichero. Se debe definir con una cadena  no
                            vacia: <<.dat>> por omision.

                     Format El    formato    del    fichero.   Consulte
                            <<FORMATOS>>  mas  abajo.  El   valor   por
                            omision es un formato tipo rfc-822.

                     Backup Si  se  deberia crear una copia de respaldo
                            del fichero antiguo antes  de  modificarlo.
                            <<true>> por omision.

              Una  definicion de ejemplo configurando una base de datos
              con este controlador:

                Name: mi-base-de-datos
                Driver: DirTree
                Directory: /var/cache/debconf/mydb
                Extension: .txt

       PackageDir
              Este controlador de base de datos es un arreglo entre las
              bases  de datos <<File>> y <<DirTree>>. Usa un directorio
              en el que  hay,  aproximadamente,  un  fichero  por  cada
              paquete  que usa debconf. Es habitualmente rapido, aunque
              toma mas espacio que el  controlador  de  base  de  datos
              <<File>>.

              Este  controlador  se  puede configurar de la misma forma
              que el  controlador  <<DirTree>>,  y  tambien  acepta  lo
              siguiente:

              Mode   Los  permisos  a  otorgar al fichero. El valor por
                     omision es  600,  ya  que  en  algunos  casos  los
                     ficheros pueden contener contrasenas.

              Una  definicion de ejemplo configurando una base de datos
              con este controlador:

                Name: mi-base-de-datos
                Driver: PackageDir
                Directory: /var/cache/debconf/mydb

       LDAP
              AVISO: Este controlador de base de datos esta aun en  una
              fase experimental. Usar con precaucion.

              Este  controlador de base de datos accede a un directorio
              LDAP para los datos de configuracion de debconf. Debido a
              la   naturaleza  de  la  bestia,  se  deberia  acceder  a
              directorios LDAP en modo de solo lectura. Esto se debe  a
              que  puede  que acceda varias veces simultaneamente, y es
              generalmente beneficioso  para  la  consistencia  de  los
              datos si nadie intenta modificarlos mientras esto ocurre.
              Por supuesto, se permite el acceso para la  escritura  en
              aquellos  casos  en los que desea actualizar los datos de
              configuracion en ese directorio.

              Para  mas  informacion  acerca  de  como  configurar   un
              servidor       LDAP      para      debconf,      consulte
              <</usr/share/doc/debconf-doc/README.LDAP>>, en el paquete
              debconf-doc.

              Necesita  instalar  el paquete libnet-ldap-perl para usar
              este controlador de base de datos.  Debconf  sugiere  ese
              paquete, pero no depende de el.

              Considere  cuidadosamente  las implicaciones de seguridad
              de usar una base de datos remota de debconf. No  es  algo
              muy  seguro  a  menos  que  confie  en la fuente y la red
              mediadora.

              Puede  configurar  las  siguientes   opciones   de   este
              controlador.

                     server El  nombre  de sistema o direccion IP de un
                            servidor LDAP al que conectarse.

                     port   El puerto con el que conectarse al servidor
                            LDAP.  Si no se proporciona ninguno, se usa
                            el puerto predefinido.

                     basedn El nombre distinitivo (DN,  <<Distinguished
                            name>>) bajo el cual se guardaran todos los
                            elementos de configuracion. Se supondra que
                            cada  elemento de configuracion se aloja en
                            un DN tipo cn=<elemento nombre>,<Base  DN>.
                            Si  no  sigue  esta estructura, todo estara
                            perdido.

                     binddn El DN con el que unirse (<<bind>>)  con  el
                            directorio.  Si  no se define, se usara una
                            union anonima.

                     bindpasswd
                            La  contrasena  a   usar   en   una   union
                            identificada (usar con binddn, mas arriba).
                            Si  no  se  define,  se  usara  una   union
                            anonima.

                            No  se deberia usar esta opcion para el uso
                            general.  La  union  anonima  deberia   ser
                            suficiente  en la mayoria de los casos para
                            el acceso de solo lectura. Definir un DN de
                            union y contrasena se deberia reservar para
                            el  caso  ocasional   en   el   que   desea
                            actualizar la configuracion de los datos de
                            debconf.

                     keybykey
                            Activa   el   acceso   a   entradas    LDAP
                            individuales,  en lugar de obtenerlos todos
                            a la vez al inicio.  Esto  es  util  cuando
                            desea supervisar los registros de LDAP para
                            claves     de      debconf      solicitadas
                            explicitamente.  De  esta  manera,  tambien
                            puede   escribir    codigo    de    control
                            personalizado  en  la  parte  del  servidor
                            LDAP.

                            Tenga en cuenta que cuando esta opcion esta
                            activada,  la conexion con el servidor LDAP
                            se mantiene activa durante la ejecucion  de
                            Debconf.   Es   un   poco   diferente   del
                            comportamiento <<all-in-one>> (todo en uno)
                            en el que se realizan dos breves conexiones
                            a LDAP; una al principio para obtener todas
                            las  entradas, y otra al final para guardar
                            cambios eventuales.

              Esta es una definicion de ejemplo que configura una  base
              de  datos usando este controlador, suponiendo que la base
              de datos remota esta en <<example.com>>, y que permite el
              acceso anonimo:

                Name: base-de-datos-ldap
                Driver: LDAP
                Readonly: true
                Server: example.com
                BaseDN: cn=debconf,dc=example,dc=com
                KeyByKey: 0

              Otro  ejemplo,  esta vez la base de datos LDAP esta en el
              sistema  local  (<<localhost>>),   y   que   permite   su
              escritura:

                Name: base-de-datos-ldap
                Driver: LDAP
                Server: localhost
                BaseDN: cn=debconf,dc=domain,dc=com
                BindPasswd: secret
                KeyByKey: 1

       Pipe
              Este  controlador  de base de datos de proposito especial
              permite leer y escribir la base de datos desde la entrada
              y  salida  estandar. Puede ser util para las personas con
              necesidades especiales.

              Puede  configurar  las  siguientes   opciones   de   este
              controlador.

                     Format El  formato  en  el  que  leer  y escribir.
                            Consulte <<FORMATOS>>  a  continuacion.  El
                            valor   por  omision  es  un  formato  tipo
                            rfc-822.

                     Infd   El numero del descriptor de  fichero  desde
                            el  que  leer.  Lee la entrada estandar por
                            omision.  Si   se   define   con   <<none>>
                            (ninguno), la base de datos no leera ningun
                            dato en el arranque.

                     Outfd  El numero del descriptor de fichero al  que
                            escribir.  Escribe  por  la salida estandar
                            por omision.  Si  se  define  con  <<none>>
                            (ninguno), la base de datos se desechara al
                            apagar.

       Estos son todos los controladores reales, pasemos  ahora  a  los
       metacontroladores.

       Stack
              Este  controlador  apila  un  numero de bases de datos de
              cualquier tipo, y permite el acceso como  si  fuesen  una
              unica base de datos. Cuando debconf solicita un valor, la
              primera base de datos en la pila que contiene el valor lo
              devuelve.  Si  debconf  escribe  en  la base de datos, lo
              escrito, generalmente, se guarda en el primer controlador
              de  la  pila  que  contiene  el elemento que debconf esta
              modificando, y si ninguno lo tiene, el elemento nuevo  se
              anade  a  la primera base de datos en la pila que permita
              su escritura.

              La cosa se pone mas interesante si una de  las  bases  de
              datos  de la pila es de solo lectura. Suponga una pila de
              bases de datos foo, bar y baz, donde foo  y  baz  son  de
              solo lectura. Debconf desea modificar un elemento, y este
              elemento solo esta presente en baz, de solo  lectura.  El
              controlador <<stack>> es suficientemente inteligente como
              para darse cuenta de que  no  funcionara,  y  copiara  el
              elemento  de  baz a bar, donde tomara lugar la escritura.
              Ahora el elemento en baz esta oculto por el  elemento  en
              bar, y ya nunca sera visible para debconf.

              Este  tipo  de  cosas  son  particularmente utiles cuando
              desea que muchos sistemas se relacionen con una  base  de
              datos  central  de solo lectura, a la vez que permite que
              ciertas cosas sean anuladas en cada sistema. Cuando anade
              los  controles  de  acceso  al dibujo, las pilas permiten
              hacer otras cosas interesantes, como redirigir todas  las
              contrasenas  a  una sola base de datos, mientras que otra
              base de datos inferior en la pila gestiona todo lo demas.

              Solo se necesita un elemento de configuracion para  crear
              una pila:

                     Stack  Aqui  es  donde define la lista de bases de
                            datos por nombre, para indicar que  compone
                            la pila.

              Por ejemplo:

                Name: mega-base-de-datos
                Driver: stack
                Stack:                        contrasena-base-de-datos,
              configuracion-base-de-datos compania-base-de-datos

              AVISO:  El  controlador  <<stack>>  aun  no   esta   bien
              comprobado. Utilice bajo su propio riesgo.

       Backup
              Este  controlador  introduce  todas las peticiones a otro
              controlador de base de datos. Pero  tambien  copia  todas
              las  peticiones  de escritura a un controlador de base de
              datos de respaldo.

              Debe definir los siguientes campos para  configurar  este
              controlador:

                     Db     La  base  de  datos  desde  la  que  leer y
                            escribir.

                     Backupdb
                            El nombre de la base  de  datos  a  la  que
                            enviar copias de los datos escritos.

              Por ejemplo:

                Name: respaldo
                Driver: Backup
                Db: mi-base-de-datos
                Backupdb: mi-base-de-datos-de-respaldo

       Debug
              Este  controlador  introduce  todas las peticiones a otro
              controlador  de  base  de  datos,  mostrando  informacion
              detallada  de  depuracion  acerca  de  la  solicitud y el
              resultado.

              Debe definir los siguientes campos para  configurar  este
              controlador:

                     Db     La  base  de  datos  desde  la  que  leer y
                            escribir.

CONTROLES DE ACCESO

       Cuando configura una base de datos, tambien puede  usar  algunos
       campos  para  definir los controles de acceso. Puede definir que
       una base de datos solo acepte contrasenas, por ejemplo, o  hacer
       que  una  base  de datos solo acepte elementos con <<foo>> en su
       nombre.

       Readonly
              Tal y como se menciono anteriormente, si se  define  este
              control de acceso como <<true>> hara que la base de datos
              sea de solo lectura. Debconf leera  los  valores  de  el,
              pero nunca escribira nada.

       Accept-Name
              El   texto   en  este  campo  es  una  expresion  regular
              compatible con Perl que se compara  con  los  nombres  de
              elementos  de la base de datos a medida que se solicitan.
              La base de datos solo permitira a debconf que lo acceda o
              modifique  si  el  nombre  del  elemento  coincide con la
              expresion regular.

       Reject-Name
              Igual  que  <<Accept-Name>>,  solo  que  rechazara   todo
              elemento cuyo nombre coincida con esta expresion regular.

       Accept-Type
              Otra  expresion  regular.  Se  compara  con  el  tipo del
              elemento al que se esta accediendo. Solo  se  permite  el
              acceso si el tipo coincide con la expresion regular.

       Reject-Type
              Igual  que  <<Accept-Type>>,  solo  que se rechazara todo
              tipo que coincida con esta expresion regular.

FORMATOS

       Algunos de los controladores de base de datos  usan  modulos  de
       formato  para  controlar  el  formato  real en el que la base de
       datos se guarda en el disco. Estos son  los  formatos  aceptados
       actualmente.

       822    Este  es  un  formato  de  fichero vagamente basado en el
              formato rfc-822 para  cabeceras  de  mensajes  de  correo
              electronico.  Se usan formatos similares en Debian; en el
              fichero de estado de dpkg y mas.

EJEMPLO

       Este   es   un   ejemplo   mas   complicado   de   un    fichero
       <<debconf.conf>>.

         # Esta definicion se usa para una configuracion general
         # de debconf.
         Config: stack
         Templates: templates
         Log: developer
         Debug: developer

         # Esta es mi propia base de datos.
         Name: mi-base-de-datos
         Driver: DirTree
         Directory: /var/cache/debconf/config

         # Esta es otra base de datos que uso para contener
         # solo la configuracion del servidor X.
         Name: X
         Driver: File
         Filename: /etc/X11/debconf.dat
         Mode: 644
         # Es algo dificil descubrir que preguntas pertenecen
         # a X; deberia usar una estructura de arbol mas
         # profunda para comparar solo con ^X/
         # Pero bueno.
         Accept-Name: xserver|xfree86|xbase

         # Esta es la base de datos global de debconf de
         # solo lectura (para mi) de nuestra compania.
         Name: compania
         Driver: LDAP
         Server: debconf.foo.com
         BaseDN: cn=debconf,dc=foo,dc=com
         BindDN: uid=admin,dc=foo,dc=com
         BindPasswd: secret
         Readonly: true
         # No deseo ninguna contrasena dando vueltas
         # por aqui.
         Reject-Type: password
         # Si no se puede acceder a esta base de datos,
         # continuar de todas formas.
         Required: false

         # Uso esta base de datos para guardar
         # contrasenas de forma segura.
         Name: contrasenas
         Driver: File
         Filename: /etc/debconf/passwords
         Mode: 600
         Accept-Type: password

         # Vamos a guardarlas todas en una
         # pila de bases de datos.
         Name: stack
         Driver: Stack
         Stack: contrasenas, X, mi-base-de-datos, compania
         # Por ello, todas las contrasenas van a la base de datos
         # de contrasenas. La mayoria de la configuracion de
         # X esta en la base de datos de X, y todo lo demas va a mi
         # base de datos principal. Los valores se buscan en cada
         # uno de estos, y si ninguno tiene un valor particular,
         # se comprueba en la base de datos LDAP de la compania
         # (a menos que sea una contrasena).

         # Tambien se usa una base de datos para
         # guardar plantillas. Esto no tiene que ser muy complejo.
         Name: plantillas
         Driver: File
         Mode: 644
         Format: 822
         Filename: /var/cache/debconf/templates

NOTAS

       Si   en  este  fichero  usa  algo  parecido  a  <<${HOME}>>,  se
       reemplazara con el valor de la variable de entorno nombrada.

       Tambien puede usar  variables  de  entorno  para  anular  en  el
       momento algo en las bases de datos, consulte debconf(7)

       Los  nombres de campo (la seccion de la linea anterior a los dos
       puntos) no son sensibles a las mayusculas y  minusculas.  Si  lo
       son, sin embargo, los valores.

MEJORAS PREVISTAS

       Mas   controladores  y  formatos.  Algunas  ideas  incluyen:  un
       controlador SQL, con la capacidad de acceder a una base de datos
       remota.  Un  controlador  DHCP,  que  de  acceso a algunas cosas
       especiales  como  el  nombre  de  sistema   (<<hostname>>),   la
       direccion  IP  y  servidores  DNS.  Un  controlador  que obtenga
       valores de un registro publico DNS con campos con  formato  TXT.
       Un  formato compatible con la salida de cdebconf. Un controlador
       de anulacion, que pueda anular el campo del valor u opciones  de
       todas las peticiones que pasan a traves de el.

FICHEROS

       /etc/debconf.conf

       ~/.debconfrc

V'EASE TAMBI'EN

       debconf(7)

AUTOR

       Joey Hess <joeyh@debian.org>

TRADUCCI'ON

       Omar Campagne Polaino <ocampagne@gmail.com>, 2010

       Si  encuentra  un  fallo en la traduccion, por favor, informe de
       ello       en        la        lista        de        traduccion
       <debian-l10n-spanish@lists.debian.org>.

                                                               DEBCONF.CONF(5)