Provided by: debconf-doc_1.5.42ubuntu1_all bug

NOMBRE

       debconf.conf - Fichero de configuración de debconf

DESCRIPCIÓN

       Debconf   es  un  sistema  de  configuración  de  paquetes  de  Debian.
       «/etc/debconf.conf» y «~/.debconfrc» son los ficheros de  configuración
       que  usa  debconf  para determinar las bases de datos que debería usar.
       Estas bases de datos  guardan  dos  tipos  de  información;  los  datos
       dinámicos  de configuración que el usuario introduce, y datos estáticos
       de plantilla. Debconf ofrece un sistema de base  de  datos  flexible  y
       extensible.  Puede crear controladores nuevos con un esfuerzo mínimo, y
       combinar conjuntos de controladores de varias maneras.

SINOPSIS

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

         Name: configuración-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
       mínimo,  por  una  línea vacía. Se ignoran las líneas de comentario que
       empiezan con «#».

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

              Config Define el nombre de la base de datos desde la cual cargar
                     los datos de configuración.

              Templates
                     Define  el  nombre  de  la  base  de datos a usar para el
                     almacén («caché») de plantillas.

       Los campos adicionales que se pueden usar incluyen:

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

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

              Admin-Email
                     La dirección de correo electrónico al que Debconf debería
                     enviar un correo para asegurar que el administrador ve un
                     mensaje de importancia. El valor predefinido  es  «root»,
                     pero   puede   definir   cualquier  dirección  de  correo
                     electrónico válido al que enviar el correo. Si desea  que
                     debconf  nunca  le  mande  un  correo, deje un espacio en
                     blanco en lugar de una dirección. Esto se puede anular en
                     el     momento     con    la    variable    de    entorno
                     «DEBCONF_ADMIN_EMAIL».

              Debug  Si se define, hará que  debconf  muestre  información  de
                     depuración  a  través  de la salida de error estándar. El
                     valor con el que se define puede ser  algo  como  «user»,
                     «developer», «db» o una expresión regular. Habitualmente,
                     querrá activar la depuración sólo ocasionalmente en lugar
                     de   definirlo   permanentemente   en   el   fichero   de
                     configuración. Para ello puede  definir  la  variable  de
                     entorno «DEBCONF_DEBUG».

              NoWarnings
                     Si   se   define,  evitará  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 información de depuración en
                     el registro del sistema («syslog») durante la  ejecución.
                     El  valor  con el que se define controla qué se registra.
                     Consulte «Debug», más arriba, para una explicación de los
                     valores  que  se  pueden definir para controlar lo que se
                     registra.

              Terse  Si se define con «true»  (verdadero),  hará  que  algunas
                     interfaces  de debconf usen un modo conciso («terse») que
                     muestra en  la  salida  la  mínima  información  posible.
                     «false»  por  omisión.  El  modo conciso se puede activar
                     temporalmente   mediante   la   variable    de    entorno
                     «DEBCONF_TERSE».

       Por  ejemplo,  la  primera  definición  de  un fichero puede tener este
       aspecto:
         Config: configuración-base-de-datos
         Templates: base-de-datos-de-plantillas

       Cada definición restante en el fichero configura una base de datos. Una
       definición de una base de datos empieza denominando la base de datos:
         Name: configuración-base-de-datos

       Después, se indica el controlador que se debería usar para esta base de
       datos. Consulte «CONTROLADORES», más abajo, para información 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  hará
       que debconf prosiga en el caso de que la base de datos falle.
         Required: false

       Puede  marcar  la  base  de  datos  como  de sólo lectura, y debconf no
       escribirá nada en él.
         Readonly: true

       También puede limitar el tipo de datos que pueden entrar en la base  de
       datos  con  las  líneas  «Accept-»  y  «Reject-»; consulte más abajo la
       sección «CONTROLES DE ACCESO».

       El resto de  la  definición  de  cada  base  de  datos  se  usará  para
       proporcionar información específica de ese controlador. Por ejemplo, el
       controlador «Text» necesita conocer el directorio donde alojar la  base
       de datos, así que podría usar:
         Filename: /var/cache/debconf/config.dat

CONTROLADORES

       Dispone  de  un  gran  número  de  controladores  («drivers»),  y puede
       escribir más con poca dificultad. Los controladores son  de  dos  tipos
       generales.  Primero  están  los controladores reales; controladores que
       acceden y guardan datos de forma directa  en  algún  tipo  de  base  de
       datos,  el  cual  puede  estar en el sistema de ficheros actual o en un
       sistema remoto. Después están los metacontroladores, que combinan otros
       controladores para así crear sistemas más 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 único fichero de
              texto simple. Esto facilita su  archivado,  transferencia
              entre  máquinas y edición. Es uno de los formatos de base
              de datos más compacto en términos del  espacio  en  disco
              que usa. También es uno de los más lentos.

              La  desventaja  es  que  el fichero se tiene que leer por
              completo cada vez que  debconf  arranca,  y  el  acto  de
              guardar también 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  omisión  es
                            600,  ya  que  en  algunos casos el fichero
                            puede contener contraseñas.

                     Format El formato del fichero. Consulte «FORMATOS»
                            más  abajo.  El  valor  por  omisión  es un
                            formato tipo rfc-822.

                     Backup Si se debería crear una copia  de  respaldo
                            del  fichero  antiguo antes de modificarlo.
                            «true» por omisión.

              Una definición 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   jerárquica   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 más fácil  de  explorar  y  manipular
              directamente.   Tiene  una  gran  velocidad  de  carga  y
              guardado de datos. Habitualmente, es  el  que  ocupa  más
              espacio, ya que varios ficheros pequeños y subdirectorios
              toman un espacio adicional.

              Puede  configurar  las  siguientes   opciones   de   este
              controlador.

                     Directory
                            El  directorio  donde guardar los ficheros.
                            Obligatorio.

                     Extension
                            La extensión a  añadir  a  los  nombres  de
                            fichero.  Se debe definir con una cadena no
                            vacía: «.dat» por omisión.

                     Format El formato del fichero. Consulte «FORMATOS»
                            más  abajo.  El  valor  por  omisión  es un
                            formato tipo rfc-822.

                     Backup Si se debería crear una copia  de  respaldo
                            del  fichero  antiguo antes de modificarlo.
                            «true» por omisión.

              Una definición 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 rápido, aunque toma más
              espacio que el controlador de base de datos «File».

              Este  controlador  se  puede configurar de la misma forma
              que  el  controlador  «DirTree»,  y  también  acepta   lo
              siguiente:

              Mode   Los  permisos  a  otorgar al fichero. El valor por
                     omisión es  600,  ya  que  en  algunos  casos  los
                     ficheros pueden contener contraseñas.

              Una  definición 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 está aún en  una
              fase experimental. Usar con precaución.

              Este  controlador de base de datos accede a un directorio
              LDAP para los datos de configuración de debconf. Debido a
              la   naturaleza  de  la  bestia,  se  debería  acceder  a
              directorios LDAP en modo de sólo lectura. Esto se debe  a
              que  puede  que acceda varias veces simultáneamente, 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
              configuración en ese directorio.

              Para  más  información  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 él.

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

              Puede  configurar  las  siguientes   opciones   de   este
              controlador.

                     server El  nombre  de sistema o dirección 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 guardarán todos los
                            elementos de configuración. Se supondrá que
                            cada  elemento de configuración se aloja en
                            un DN tipo cn=<elemento nombre>,<Base  DN>.
                            Si  no  sigue  esta estructura, todo estará
                            perdido.

                     binddn El DN con el que  unirse  («bind»)  con  el
                            directorio.  Si  no se define, se usará una
                            unión anónima.

                     bindpasswd
                            La  contraseña  a   usar   en   una   unión
                            identificada (usar con binddn, más arriba).
                            Si  no  se  define,  se  usará  una   unión
                            anónima.

                            No  se debería usar esta opción para el uso
                            general.  La  unión  anónima  debería   ser
                            suficiente  en la mayoría de los casos para
                            el acceso de sólo lectura. Definir un DN de
                            unión y contraseña se debería reservar para
                            el  caso  ocasional   en   el   que   desea
                            actualizar la configuración 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  útil  cuando
                            desea supervisar los registros de LDAP para
                            claves     de      debconf      solicitadas
                            explícitamente.  De  esta  manera,  también
                            puede   escribir    código    de    control
                            personalizado  en  la  parte  del  servidor
                            LDAP.

                            Tenga en cuenta que cuando esta opción está
                            activada,  la conexión con el servidor LDAP
                            se mantiene activa durante la ejecución  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 definición de ejemplo que configura una  base
              de  datos usando este controlador, suponiendo que la base
              de datos remota está en «example.com», y que  permite  el
              acceso anónimo:

                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 está 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  propósito  especial
              permite leer y escribir la base de datos desde la entrada
              y salida estándar. Puede ser útil 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  continuación.  El
                            valor  por  omisión  es  un  formato   tipo
                            rfc-822.

                     Infd   El  número  del descriptor de fichero desde
                            el que leer. Lee la  entrada  estándar  por
                            omisión. Si se define con «none» (ninguno),
                            la base de datos no leerá ningún dato en el
                            arranque.

                     Outfd  El  número del descriptor de fichero al que
                            escribir. Escribe por  la  salida  estándar
                            por   omisión.  Si  se  define  con  «none»
                            (ninguno), la base de datos se desechará al
                            apagar.

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

       Stack
              Este controlador apila un número de  bases  de  datos  de
              cualquier  tipo,  y  permite el acceso como si fuesen una
              única 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  está
              modificando,  y si ninguno lo tiene, el elemento nuevo se
              añade a la primera base de datos en la pila  que  permita
              su escritura.

              La  cosa  se  pone más interesante si una de las bases de
              datos de la pila es de sólo lectura. Suponga una pila  de
              bases  de  datos  foo,  bar y baz, donde foo y baz son de
              sólo lectura. Debconf desea modificar un elemento, y este
              elemento  sólo  está presente en baz, de sólo lectura. El
              controlador «stack» es suficientemente  inteligente  como
              para  darse  cuenta  de  que  no funcionará, y copiará el
              elemento de baz a bar, donde tomará lugar  la  escritura.
              Ahora  el  elemento en baz está oculto por el elemento en
              bar, y ya nunca será visible para debconf.

              Este tipo de  cosas  son  particularmente  útiles  cuando
              desea  que  muchos sistemas se relacionen con una base de
              datos central de sólo lectura, a la vez que  permite  que
              ciertas cosas sean anuladas en cada sistema. Cuando añade
              los controles de acceso al  dibujo,  las  pilas  permiten
              hacer  otras cosas interesantes, como redirigir todas las
              contraseñas a una sola base de datos, mientras  que  otra
              base de datos inferior en la pila gestiona todo lo demás.

              Sólo  se necesita un elemento de configuración para crear
              una pila:

                     Stack  Aquí es donde define la lista de  bases  de
                            datos  por nombre, para indicar qué compone
                            la pila.

              Por ejemplo:

                Name: mega-base-de-datos
                Driver: stack
                Stack:                        contraseña-base-de-datos,
              configuración-base-de-datos compañía-base-de-datos

              AVISO:   El   controlador   «stack»   aún  no  está  bien
              comprobado. Utilice bajo su propio riesgo.

       Backup
              Este controlador introduce todas las  peticiones  a  otro
              controlador  de  base  de datos. Pero también 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  información
              detallada de depuración  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, también puede usar algunos
       campos para definir los controles de acceso. Puede  definir  que
       una  base de datos sólo acepte contraseñas, por ejemplo, o hacer
       que una base de datos sólo acepte  elementos  con  «foo»  en  su
       nombre.

       Readonly
              Tal  y  como se mencionó anteriormente, si se define este
              control de acceso como «true» hará que la base  de  datos
              sea  de  sólo  lectura.  Debconf leerá los valores de él,
              pero nunca escribirá nada.

       Accept-Name
              El  texto  en  este  campo  es  una   expresión   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 sólo permitirá a debconf que lo acceda o
              modifique si el  nombre  del  elemento  coincide  con  la
              expresión regular.

       Reject-Name
              Igual que «Accept-Name», sólo que rechazará todo elemento
              cuyo nombre coincida con esta expresión regular.

       Accept-Type
              Otra expresión  regular.  Se  compara  con  el  tipo  del
              elemento  al  que  se está accediendo. Sólo se permite el
              acceso si el tipo coincide con la expresión regular.

       Reject-Type
              Igual que «Accept-Type», sólo que se rechazará todo  tipo
              que coincida con esta expresión regular.

FORMATOS

       Algunos  de  los  controladores de base de datos usan módulos 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
              electrónico. Se usan formatos similares en Debian; en  el
              fichero de estado de dpkg y más.

EJEMPLO

       Este es un ejemplo más complicado de un fichero «debconf.conf».

         # Esta definición se usa para una configuración 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
         # sólo la configuración del servidor X.
         Name: X
         Driver: File
         Filename: /etc/X11/debconf.dat
         Mode: 644
         # Es algo difícil descubrir qué preguntas pertenecen
         # a X; debería usar una estructura de árbol más
         # profunda para comparar sólo con ^X/
         # Pero bueno.
         Accept-Name: xserver|xfree86|xbase

         # Esta es la base de datos global de debconf de
         # sólo lectura (para mi) de nuestra compañía.
         Name: compañía
         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 contraseña dando vueltas
         # por aquí.
         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
         # contraseñas de forma segura.
         Name: contraseñas
         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: contraseñas, X, mi-base-de-datos, compañía
         # Por ello, todas las contraseñas van a la base de datos
         # de contraseñas. La mayoría de la configuración de
         # X está en la base de datos de X, y todo lo demás 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 compañía
         # (a menos que sea una contraseña).

         # También 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 reemplazará
       con el valor de la variable de entorno nombrada.

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

       Los  nombres de campo (la sección de la línea anterior a los dos
       puntos) no son sensibles a las mayúsculas y  minúsculas.  Sí  lo
       son, sin embargo, los valores.

MEJORAS PREVISTAS

       Más   controladores  y  formatos.  Algunas  ideas  incluyen:  un
       controlador SQL, con la capacidad de acceder a una base de datos
       remota.  Un  controlador  DHCP,  que  dé  acceso a algunas cosas
       especiales como el nombre de sistema («hostname»), la  dirección
       IP  y  servidores  DNS. Un controlador que obtenga valores de un
       registro público DNS con campos  con  formato  TXT.  Un  formato
       compatible   con  la  salida  de  cdebconf.  Un  controlador  de
       anulación, que pueda anular el campo del  valor  u  opciones  de
       todas las peticiones que pasan a través de él.

FICHEROS

       /etc/debconf.conf

       ~/.debconfrc

VÉASE TAMBIÉN

       debconf(7)

AUTOR

       Joey Hess <joeyh@debian.org>

TRADUCCIÓN

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

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

                                                               DEBCONF.CONF(5)