APT.CONF(5) APT.CONF(5)
apt.conf - Archivo de configuracin de APT
apt.conf es el fichero principal de configuracin del conjunto de her-
ramientas APT, todas las herramientas hacen uso del fichero de configu-
racin y un analizador comn de sintaxis de la lnea de rdenes para pro-
porcionar un entorno uniforme. Cuando se inicia una utilidad APT, este
leer la configuracin especificada en la variable de entorno APT_CONFIG
(si existe), luego leer los ficheos en Dir::Etc::Parts, entonces leer
el fichero de configuracin principal especificado por Dir::Etc::main,
finalmente aplicar las opciones de la lnea de rdenes para reescribir la
directrices de la configuracin, posiblemente cargando incluso ms
ficheros de configuracin.
El fichero de configuracin est organizado en forma de rbol con las
opciones organizadas en grupos funcionales. Las opciones especificadas
son dadas con dobles dos puntos, por ejemplo APT::Get::Assume-Yes es un
opcin de la funcin GET del conjunto de herramientas APT. Las opciones
no son heredadas de sus grupos padres.
Sintcticamente, el lenguaje de configuracin es modelado como en utili-
dades ISC, como bind y dhcp. Las lneas que comienzan con // se tratan
como comentarios (se ignoran). Cada lnea es de la forma
APT::Get::Assume-Yes "true";
Los espacios entre los dos puntos son obligatorios, y las comillas son
opcionales. Un nuevo mbito puede abrirse con llaves, por ejemplo:
APT {
Get {
Assume-Yes "true";
Fix-Broken "true";
};
};
con nuevas lneas en cada lugar para hacerlo ms legible. Las listas
pueden crearse abriendo un nuevo mbito e incluyendo una nica palabra
acotada entre comillas seguido de un punto y coma. Pueden ser incluidas
mltiples entradas, cada una separada por un punto y coma.
DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
En general, el fichero de configuracin de ejemplo
/usr/share/doc/apt/examples/apt.conf /usr/share/doc/apt/examples/con-
figure-index.gz es una buena gua para entender su aspecto.
Se permiten dos valores especiales, #include y #clear. #include
incluir el fichero dado, a menos que el final del nombre del fichero
acabe en una barra, entonces se incluye el directorio entero. #clear
se usa para suprimir la lista de nombres.
Todas las utilidades APT permiten la opcin -o como una directriz arbi-
traria de configuracin que es especificada en la lnea de rdenes. La
sintaxis es un nombre de opcin completo (APT::Get::Assume-Yes por ejem-
plo) seguido por signos de igualdad y el nuevo valor de la opcin. Las
listas tambin pueden ser aadidas incluyendo :: al final del nombre de
la lista.
Este grupo de opciones controlan la conducta general de APT as como el
mantenimiento de las opciones para todas las utilidades.
Arquitectura
Arquitectura del sistema; ajusta la arquitectura a usar cuando
se obtengan los ficheros y se analicen las listas de paquetes.
El valor por defecto es la arquitectura para la que ha sido com-
pilado apt.
Ignore-Hold
Ignorar paquetes retenidos: Esta opcin global causa que el solu-
cionador de problemas ignore paquetes retenidos cuando tome
decisiones.
Clean-Installed
Activo por defecto. Cuando se activa la funcin de auto-limpieza,
sta eliminar cualquier paquete de la cach que ya no pueda
descargarse. Si se desactiva, entonces los paquetes que estn
localmente instalados son excluidos de la limpieza - ntese que
APT no provee ningn medio directo para reinstalarlos.
Immediate-Configure
Deshabilita la configuracin inmediata: Esta peligrosa opcin
deshabilita algunas partes del cdigo de ordenacin de APT para
inducir a ste a hacer pocas llamadas a dpkg. Hacer esto podra
ser necesario en algn sistema de usuario extremadamente lento,
pero sera muy peligroso y podra causar que los scripts de insta-
lacin del paquete fallaran o algo peor. selo a su cuenta y
riesgo.
Force-LoopBreak
Nunca habilite esta opcin a menos que usted -realmente- conozca
lo que est haciendo. Esto permite a APT eliminar temporalmente
un paquete esencial para romper conflictos o bucles conflic-
tos/pre-dependencias entre dos paquetes esenciales. EL BUCLE NO
DEBERA EXISTIR NUNCA COMO TAL Y ES UN ERROR GRAVE. Esta opcin
trabajar si el paquete esencial no es tar, gzip, libc, dpkg,
bash o cualquier otro del que dependan estos paquetes.
Cache-Limit
APT usa un fichero de cach de memoria mapeada de tamao fijo para
almacenar la informacin disponible. Esto fija el tamao de esa
cach.
Build-Essential
Define que paquete(s) son considerados dependencias de construc-
cin esenciales.
Get La subseccin Get controla la herramienta apt-get(8), por favor,
mire su documentacin para ms informacin sobre esta opcin.
Cache La subseccin Cache controla la herramienta apt-cache(8), por
favor, mire su documentacin para ms informacin sobre esta opcin.
CDROM La subseccin CDROM controla la herramienta apt-cdrom(8), por
favor, mire la documentacin para ms informacin sobre esta opcin.
El grupo de opciones Acquire controla la descarga de paquetes y los
manejadores de URI.
Queue-Mode
Modo de cola; Queue-Mode puede ser host o access que determina
como paralelizar las conexiones salientes de APT. host significa
que se abrir una conexin por puesto de destino, access significa
que ser abierta una conexin por cada tipo de URI.
Retries
Nmero de reintentos. Si es distinto de cero APT volver a inten-
tar obtener los ficheros fallidos el nmero de veces dado.
Source-Symlinks
Usar enlaces simblicos para los archivos fuente. Si es true los
archivos fuente se enlazarn a ser posible, en vez de copiarse.
Por omisin es true.
http HTTP URIs; http::Proxy es el proxy http predeterminado a usar.
Usa el formato general
http://[[usuario][:clave]@]puesto[:puerto]/. Tambin se puede
especificar un proxy por cada puesto usando la forma
http::Proxy::<puesto> con la palabra especial DIRECT queriendo
decir que no se use proxy. La variable de entorno http_proxy
modifica todas las preferencias.
Para los proxies que cumplen con HTTP/1.1 se proporcionan tres
opciones de configuracin. No-Cache dice al proxy que no use su
cach bajo ninguna circunstancia, Max-Age slo se enva para los
ficheros de ndice y le pide a la cach que refresque su copia si
es ms antigua que un determinado nmero de segundos. Debian actu-
aliza sus ficheros de ndices diariamente, debido a esto el valor
predeterminado es 1 da. No-Store especifica que la cach nunca
deber almacenar la peticin, slo est habilitada para los ficheros
de archivo. Puede ser til para prevenir que un proxy se con-
tamine con ficheros .deb muy grandes. Nota: Squid 2.0.2 no
soporta ninguna de estas opciones.
La opcin timeout establece el tiempo mximo de espera del mtodo,
esto se aplica a todo, incluyendo el tiempo de espera para
realizar la conexin y para recibir datos.
Se proporciona una opcin para controlar la profundidad de la
tubera en casos en que el servidor no cumpla con RFC o tenga
fallos (como pasa con Squid 2.0.2). Acquire::http::Pipeline-
Depth puede ser un valor entre 0 y 5 indicando cuantas peti-
ciones sin resolver puede envar APT. DEBE especificarse si el
puesto remoto no demora apropiadamente las conexiones TCP - de
otro modo los datos se corrompern. Los puesto que necesiten esto
violan el RFC 2068.
ftp FTP URIs; ftp::Proxy es el servidor proxy a usar de forma prede-
terminada. Se encuentra en el formato estndar
ftp://[[usuario][:clave]@]puesto[:puerto]/ y se modifica medi-
ante la variable de entorno ftp_proxy. Para usar un proxy ftp es
necesario establecer el script ftp::ProxyLogin en el fichero de
configuracin. Esta entrada especifica rdenes que se mandan al
servidor proxy para decirle a donde debe conectarse. Consulte
/usr/share/doc/apt/examples/configure-index.gz para ver un ejem-
plo de como hacerlo. Las variables de substitucin disponibles
son $(PROXY_USER), $(PROXY_PASS), $(SITE_USER), $(SITE_PASS),
$(SITE), y $(SITE_PORT). Cada una se toma del componete de la
URI correspondiente.
La opcin timeout establece el tiempo mximo de espera del mtodo,
esto se aplica a todo, incluyendo el tiempo de espera para
realizar la conexin y para recibir datos.
Se proporcionan varias opciones para controlar el modo pasivo.
Generalmente es seguro dejar activado el modo pasivo, funciona
en casi todos los entornos. Sin embargo algunas situaciones
requieren desactivar el modo pasivo y usar el modo puerto e su
lugar. Esto se puede hacer globalmente, para conexiones a travs
de proxy o para un puesto especfico (Consulte el fichero de con-
figuracin de muestra para ver ejemplos).
Es posible usar proxy FTP a travs de HTTP estableciendo la vari-
able de entorno ftp_proxy a una direccin http - mire la discusin
del mtodo http de arriba para la sintaxis. No se puede habilitar
en el fichero de configuracin y no se recomienda su uso debido a
su poca eficiencia.
La opcin ForceExtended controla el uso de las rdenes de RFC2428
EPSV y EPRT. Por omisin es false, que quiere decir que slo se
usan si el control de conexin es IPv6. Ponindolo a true fuerza
su uso incluso en conexiones IPv4. Dese cuenta que la mayora de
los servidores FTP no soportan RFC2428.
cdrom CDROM URIs; la nica opcin de configuracin para los CDROM es el
punto de montaje, cdrom::Mount debe ser el punto de montaje de
la unidad de CDROM tal y como se especifica en /etc/fstab. Es
posible proporcionar rdenes mount y unmount alternativas si el
punto de montaje no puede especificarse en fstab (como con SMB y
versiones de mount antiguas). Respecto a la sintaxis se pone
"/cdrom/"::Mount
"tal";
dentro del bloque cdrom. Es importante no tener una barra final.
Las rdenes de unmount pueden especificarse usando UMount.
La seccin Dir::State contiene directorios que pertenecen a informacin
del estado local. lists es el directorio donde se almacenan las listas
de paquetes descargados y status es el nombre del fichero de estado de
dpkg. preferences es el nombre del fichero de preferencias de APT.
Dir::State contiene el directorio que se usar como prefijo por omisin
en todas las opciones restantes en caso de que no empiezen con / o ./.
Dir::Cache contiene lugares pertenecientes a informacin de la cach
local, como las dos cachs de paquetes srcpkgcache y pkgcache o como el
lugar donde se guardan los ficheros descargados, Dir::Cache::archives.
La generacin de cachs puede desactivarse dejando sus nombres en blanco.
sto enlentecer el arranque pero ahorrar espacio. Normalmente se pre-
fiere deshabilitar pkgcache en vez de srcpkgcache. Al igual que con
Dir::State el directorio predeterminado est en Dir::Cache
Dir::Etc contiene el lugar de los ficheros de configuracin, sourcelist
contiene el lugar de sourcelist y main es el fichero de configuracin
predeterminado (esta opcin de configuracin no tiene ningn efecto a
menos que se realice desde el fichero de configuracin especificado por
APT_CONFIG).
La opcin Dir::Parts lee en todos los fragementos de configuracin en
orden lxico desde el directorio especificado. Despus de esto se carga
el fichero principal de configuracin.
Dir::Bin apunta a los programas binarios. Dir::Bin::Methods especifica
la localizacin de los manejadores de los mtodos y gzip, dpkg, apt-get,
dpkg-source, dpkg-buildpackage y apt-cache especifican la localizacin
de los respectivos programas.
Cuando APT se usa como mtodo de dselect(8) varias directivas de config-
uracin controlan el comportamiento predeterminado. Se encuentran en la
seccin DSelect.
Clean Modo de borrado de cach; este valor puede ser always, prompt,
auto, pre-auto y never. always y prompt borrarn todos los paque-
tes de la cach despus de actualizar, prompt (predeterminado)
pregunta primero. auto borra slo aquellos paquetes que ya no se
pueden descargar (han sido reemplazados por otra versin, por
ejemplo). pre-auto realiza esta ltima accin antes de descargar
los paquetes nuevos.
Options
El contenido de esta variable se pasa a apt-get(8) como opciones
de lnea de ordenes cuando se ejecuta en la fase de instalacin.
UpdateOptions
El contenido de esta variable se pasa a apt-get(8) como opciones
de lnea de ordenes cuando se ejecuta en la fase de actualizacin.
PromptAfterUpdate
Si es true la operacin de [U]pdate en dselect(8) preguntar siem-
pre antes de continuar. Por omisin slo pregunta en caso de
error.
Varias directivas de configuracin controlan como APT llama a dpkg(8).
Se encuentran en la seccin DPkg.
Options
Lista de opciones que se pasan a dpkg. Las opciones deben
especificarse usando la notacin de lista y cada elemento de la
lista se pasa a dpkg(8) como un slo argumento.
Pre-Invoke
Post-Invoke
Es una lista de rdenes de shell que se ejecutarn antes de llamar
a dpkg(8). Como Options, debe de especificarse con notacin de
lista. Las rdenes se ejecutan en orden usando /bin/sh, si alguna
falla APT abortar.
Pre-Install-Pkgs
Lista de rdenes de shell que se ejecutarn antes de llamar a
dpkg(8). Como Options, debe de especificarse con notacin de
lista. Las rdenes se ejecutan en orden usando /bin/sh, si alguna
falla APT abortar. APT pasar a los programas los nombres de
fichero de todos los .deb que va ha instalar por la entrada est-
ndar, uno por lnea.
La versin 2 de este protocolo vuelca ms informacin, incluyendo
la versin del protocolo, el espacio de configuracin de APT , los
ficheros y versiones que cambian. La versin 2 se habilita
estableciendo DPkg::Tools::Options::cmd::Version a 2. cmd es una
orden dada a Pre-Install-Pkgs.
Run-Directory
APT hace que ste sea su directorio de trabajo antes de llamar a
dpkg, por omisin es /.
Build-Options
stas opciones se pasan a dpkg-buildpackage(1) cuando compila
paquetes, por omisin se limita a deshabilitar el firmado de
paquetes y producir todos los binarios.
La mayora de las opciones de la seccin debug no son interesantes para
el usuario normal, sin embargo Debug::pkgProblemResolver muestra una
salida interesante acerca de las decisiones que realiza dist-upgrade.
Debug::NoLocking deshabilita el bloqueo de fichero de forma que APT
puede realizar algunas operaciones sin permisos de superusuario y
Debug::pkgDPkgPM mostrar la lnea de rdenes para cada llamada a dpkg.
Debug::IdentCdrom deshabilitar la inclusin de datos de statfs en los
ID's de los CDROM.
/usr/share/doc/apt/examples/configure-index.gz contiene un fichero de
configuracin de ejemplo mostrando los valores predeterminados para
todas las opciones posibles.
/etc/apt/apt.conf
apt-cache(8), apt-config(8), apt_preferences(5).
Vea la pgina de fallos de APT <URL:http://bugs.debian.org/src:apt>. Si
desea avisar de un fallo en APT, vea /usr/share/doc/debian/bug-report-
ing.txt o la orden reportbug(1).
APT fue escrito por el equipo de APT <apt [AT] packages.org>.
Traduccin de Rubn Porras Campo <debian-l10n-spanish [AT] lists.org>
28 May 2008 APT.CONF(5)