Provided by:
debconf-doc_1.5.40ubuntu1_all 
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)