<!-- -*- mode: sgml; mode: fold -*- --> <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ <!ENTITY % aptent SYSTEM "apt.ent.es"> %aptent; ]> <!-- (c) 2003 Software in the Public Interest Esta traducci�n ha sido realizada por Carlos Mestre <faraox@gulic.org> y Rub�n Porras Campo <nahoo@inicia.es>. Est� basada en la p�gina de manual original: versi�n 1.6 del CVS de /cvs/debian-doc/manpages/english/apt/apt.conf.5.sgml --> <refentry lang=es> &apt-docinfo; <refmeta> <refentrytitle>apt.conf</> <manvolnum>5</> </refmeta> <!-- Man page title --> <refnamediv> <refname>apt.conf</> <refpurpose>Archivo de configuraci�n de APT</> </refnamediv> <RefSect1><Title>Descripci�n</> <para> <filename/apt.conf/ es el fichero principal de configuraci�n del conjunto de herramientas APT, todas las herramientas hacen uso del fichero de configuraci�n y un analizador com�n de sintaxis de la l�nea de �rdenes para proporcionar un entorno uniforme. Cuando se inicia una utilidad APT, este leer� la configuraci�n especificada en la variable de entorno <envar/APT_CONFIG/ (si existe), luego leer� los ficheos en <literal/Dir::Etc::Parts/, entonces leer� el fichero de configuraci�n principal especificado por <literal/Dir::Etc::main/, finalmente aplicar� las opciones de la l�nea de �rdenes para reescribir la directrices de la configuraci�n, posiblemente cargando incluso m�s ficheros de configuraci�n. <para> El fichero de configuraci�n est� organizado en forma de �rbol con las opciones organizadas en grupos funcionales. Las opciones especificadas son dadas con dobles dos puntos, por ejemplo <literal/APT::Get::Assume-Yes/ es un opci�n de la funci�n GET del conjunto de herramientas APT. Las opciones no son heredadas de sus grupos padres. <para> Sint�cticamente, el lenguaje de configuraci�n es modelado como en utilidades ISC, como bind y dhcp. Las l�neas que comienzan con <literal>//</literal> se tratan como comentarios (se ignoran). Cada l�nea es de la forma <literallayout>APT::Get::Assume-Yes "true";</literallayout> Los espacios entre los dos puntos son obligatorios, y las comillas son opcionales. Un nuevo �mbito puede abrirse con llaves, por ejemplo: <informalexample><programlisting> APT { Get { Assume-Yes "true"; Fix-Broken "true"; }; }; </programlisting></informalexample> con nuevas l�neas en cada lugar para hacerlo m�s 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 m�ltiples entradas, cada una separada por un punto y coma. <informalexample><programlisting> DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; </programlisting></informalexample> <para> En general, el fichero de configuraci�n de ejemplo <filename>&docdir;examples/apt.conf</> &configureindex; es una buena gu�a para entender su aspecto. <para> Se permiten dos valores especiales, <literal/#include/ y <literal/#clear/. <literal/#include/ incluir� el fichero dado, a menos que el final del nombre del fichero acabe en una barra, entonces se incluye el directorio entero. <literal/#clear/ se usa para suprimir la lista de nombres. <para> Todas las utilidades APT permiten la opci�n -o como una directriz arbitraria de configuraci�n que es especificada en la l�nea de �rdenes. La sintaxis es un nombre de opci�n completo (<literal/APT::Get::Assume-Yes/ por ejemplo) seguido por signos de igualdad y el nuevo valor de la opci�n. Las listas tambi�n pueden ser a�adidas incluyendo :: al final del nombre de la lista. </RefSect1> <RefSect1><Title>El grupo APT</> <para> Este grupo de opciones controlan la conducta general de APT as� como el mantenimiento de las opciones para todas las utilidades. <VariableList> <VarListEntry><Term>Arquitectura</Term> <ListItem><Para> 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 compilado apt. </VarListEntry> <VarListEntry><Term>Ignore-Hold</Term> <ListItem><Para> Ignorar paquetes retenidos: Esta opci�n global causa que el solucionador de problemas ignore paquetes retenidos cuando tome decisiones. </VarListEntry> <VarListEntry><Term>Clean-Installed</Term> <ListItem><Para> Activo por defecto. Cuando se activa la funci�n de auto-limpieza, �sta eliminar� cualquier paquete de la cach� que ya no pueda descargarse. Si se desactiva, entonces los paquetes que est�n localmente instalados son excluidos de la limpieza - n�tese que APT no provee ning�n medio directo para reinstalarlos. </VarListEntry> <VarListEntry><Term>Immediate-Configure</Term> <ListItem><Para> Deshabilita la configuraci�n inmediata: Esta peligrosa opci�n deshabilita algunas partes del c�digo de ordenaci�n de APT para inducir a �ste a hacer pocas llamadas a dpkg. Hacer esto podr�a ser necesario en alg�n sistema de usuario extremadamente lento, pero ser�a muy peligroso y podr�a causar que los scripts de instalaci�n del paquete fallaran o algo peor. �selo a su cuenta y riesgo. </VarListEntry> <VarListEntry><Term>Force-LoopBreak</Term> <ListItem><Para> Nunca habilite esta opci�n a menos que usted -realmente- conozca lo que est� haciendo. Esto permite a APT eliminar temporalmente un paquete esencial para romper conflictos o bucles conflictos/pre-dependencias entre dos paquetes esenciales. EL BUCLE NO DEBER�A EXISTIR NUNCA COMO TAL Y ES UN ERROR GRAVE. Esta opci�n trabajar� si el paquete esencial no es tar, gzip, libc, dpkg, bash o cualquier otro del que dependan estos paquetes. </VarListEntry> <VarListEntry><Term>Cache-Limit</Term> <ListItem><Para> APT usa un fichero de cach� de memoria mapeada de tama�o fijo para almacenar la informaci�n disponible. Esto fija el tama�o de esa cach�. </VarListEntry> <VarListEntry><Term>Build-Essential</Term> <ListItem><Para> Define que paquete(s) son considerados dependencias de construcci�n esenciales. </VarListEntry> <VarListEntry><Term>Get</Term> <ListItem><Para> La subsecci�n Get controla la herramienta &apt-get;, por favor, mire su documentaci�n para m�s informaci�n sobre esta opci�n. </VarListEntry> <VarListEntry><Term>Cache</Term> <ListItem><Para> La subsecci�n Cache controla la herramienta &apt-cache;, por favor, mire su documentaci�n para m�s informaci�n sobre esta opci�n. </VarListEntry> <VarListEntry><Term>CDROM</Term> <ListItem><Para> La subsecci�n CDROM controla la herramienta &apt-cdrom;, por favor, mire la documentaci�n para m�s informaci�n sobre esta opci�n. </VarListEntry> </VariableList> </RefSect1> <RefSect1><Title>El grupo Acquire</> <para> El grupo de opciones <literal/Acquire/ controla la descarga de paquetes y los manejadores de URI. <VariableList> <VarListEntry><Term>Queue-Mode</Term> <ListItem><Para> Modo de cola; <literal/Queue-Mode/ puede ser <literal/host/ o <literal/access/ que determina como paralelizar las conexiones salientes de APT. <literal/host/ significa que se abrir� una conexi�n por puesto de destino, <literal/access/ significa que ser� abierta una conexi�n por cada tipo de URI. </VarListEntry> <VarListEntry><Term>Retries</Term> <ListItem><Para> N�mero de reintentos. Si es distinto de cero APT volver� a intentar obtener los ficheros fallidos el n�mero de veces dado. </VarListEntry> <VarListEntry><Term>Source-Symlinks</Term> <ListItem><Para> Usar enlaces simb�licos para los archivos fuente. Si es true los archivos fuente se enlazar�n a ser posible, en vez de copiarse. Por omisi�n es true. </VarListEntry> <VarListEntry><Term>http</Term> <ListItem><Para> HTTP URIs; http::Proxy es el proxy http predeterminado a usar. Usa el formato general <literal>http://[[usuario][:clave]@]puesto[:puerto]/</>. Tambi�n se puede especificar un proxy por cada puesto usando la forma <literal/http::Proxy::<puesto>/ con la palabra especial <literal/DIRECT/ queriendo decir que no se use proxy. La variable de entorno <envar/http_proxy/ modifica todas las preferencias. <para> Para los proxies que cumplen con HTTP/1.1 se proporcionan tres opciones de configuraci�n. <literal/No-Cache/ dice al proxy que no use su cach� bajo ninguna circunstancia, <literal/Max-Age/ s�lo se env�a para los ficheros de �ndice y le pide a la cach� que refresque su copia si es m�s antigua que un determinado n�mero de segundos. Debian actualiza sus ficheros de �ndices diariamente, debido a esto el valor predeterminado es 1 d�a. <literal/No-Store/ especifica que la cach� nunca deber� almacenar la petici�n, s�lo est� habilitada para los ficheros de archivo. Puede ser �til para prevenir que un proxy se contamine con ficheros .deb muy grandes. Nota: Squid 2.0.2 no soporta ninguna de estas opciones. <para> La opci�n <literal/timeout/ establece el tiempo m�ximo de espera del m�todo, esto se aplica a todo, incluyendo el tiempo de espera para realizar la conexi�n y para recibir datos. <para> Se proporciona una opci�n para controlar la profundidad de la tuber�a en casos en que el servidor no cumpla con RFC o tenga fallos (como pasa con Squid 2.0.2). <literal/Acquire::http::Pipeline-Depth/ puede ser un valor entre 0 y 5 indicando cuantas peticiones sin resolver puede env�ar APT. DEBE especificarse si el puesto remoto no demora apropiadamente las conexiones TCP - de otro modo los datos se corromper�n. Los puesto que necesiten esto violan el RFC 2068. </VarListEntry> <VarListEntry><Term>ftp</Term> <ListItem><Para> FTP URIs; ftp::Proxy es el servidor proxy a usar de forma predeterminada. Se encuentra en el formato est�ndar <literal>ftp://[[usuario][:clave]@]puesto[:puerto]/</> y se modifica mediante la variable de entorno <envar/ftp_proxy/. Para usar un proxy ftp es necesario establecer el script <literal/ftp::ProxyLogin/ en el fichero de configuraci�n. Esta entrada especifica �rdenes que se mandan al servidor proxy para decirle a donde debe conectarse. Consulte &configureindex; para ver un ejemplo de como hacerlo. Las variables de substituci�n disponibles son <literal/$(PROXY_USER)/, <literal/$(PROXY_PASS)/, <literal/$(SITE_USER)/, <literal/$(SITE_PASS)/, <literal/$(SITE)/, y <literal/$(SITE_PORT)/. Cada una se toma del componete de la URI correspondiente. <para> La opci�n <literal/timeout/ establece el tiempo m�ximo de espera del m�todo, esto se aplica a todo, incluyendo el tiempo de espera para realizar la conexi�n y para recibir datos. <para> 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 trav�s de proxy o para un puesto espec�fico (Consulte el fichero de configuraci�n de muestra para ver ejemplos). <para> Es posible usar proxy FTP a trav�s de HTTP estableciendo la variable de entorno <envar/ftp_proxy/ a una direcci�n http - mire la discusi�n del m�todo http de arriba para la sintaxis. No se puede habilitar en el fichero de configuraci�n y no se recomienda su uso debido a su poca eficiencia. <para> La opci�n <literal/ForceExtended/ controla el uso de las �rdenes de RFC2428 <literal/EPSV/ y <literal/EPRT/. Por omisi�n es false, que quiere decir que s�lo se usan si el control de conexi�n es IPv6. Poni�ndolo a true fuerza su uso incluso en conexiones IPv4. Dese cuenta que la mayor�a de los servidores FTP no soportan RFC2428. </VarListEntry> <VarListEntry><Term>cdrom</Term> <ListItem><Para> CDROM URIs; la �nica opci�n de configuraci�n para los CDROM es el punto de montaje, <literal/cdrom::Mount/ debe ser el punto de montaje de la unidad de CDROM tal y como se especifica en <filename>/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 <literallayout>"/cdrom/"::Mount "tal";</literallayout> dentro del bloque cdrom. Es importante no tener una barra final. Las �rdenes de unmount pueden especificarse usando UMount. </VarListEntry> </VariableList> </RefSect1> <RefSect1><Title>Directorios</> <para> La secci�n <literal/Dir::State/ contiene directorios que pertenecen a informaci�n del estado local. <literal/lists/ es el directorio donde se almacenan las listas de paquetes descargados y <literal/status/ es el nombre del fichero de estado de dpkg. <literal/preferences/ es el nombre del fichero de preferencias de APT. <literal/Dir::State/ contiene el directorio que se usar� como prefijo por omisi�n en todas las opciones restantes en caso de que no empiezen con <filename>/</> o <filename>./</>. <para> <literal/Dir::Cache/ contiene lugares pertenecientes a informaci�n de la cach� local, como las dos cach�s de paquetes <literal/srcpkgcache/ y <literal/pkgcache/ o como el lugar donde se guardan los ficheros descargados, <literal/Dir::Cache::archives/. La generaci�n de cach�s puede desactivarse dejando sus nombres en blanco. �sto enlentecer� el arranque pero ahorrar� espacio. Normalmente se prefiere deshabilitar pkgcache en vez de srcpkgcache. Al igual que con <literal/Dir::State/ el directorio predeterminado est� en <literal/Dir::Cache/ <para> <literal/Dir::Etc/ contiene el lugar de los ficheros de configuraci�n, <literal/sourcelist/ contiene el lugar de sourcelist y <literal/main/ es el fichero de configuraci�n predeterminado (esta opci�n de configuraci�n no tiene ning�n efecto a menos que se realice desde el fichero de configuraci�n especificado por <envar/APT_CONFIG/). <para> La opci�n <literal/Dir::Parts/ lee en todos los fragementos de configuraci�n en orden l�xico <!--�Y esto qu� es?--> desde el directorio especificado. Despu�s de esto se carga el fichero principal de configuraci�n. <para> <literal/Dir::Bin/ apunta a los programas binarios. <literal/Dir::Bin::Methods/ especifica la localizaci�n de los manejadores de los m�todos y <literal/gzip/, <literal/dpkg/, <literal/apt-get/, <literal/dpkg-source/, <literal/dpkg-buildpackage/ y <literal/apt-cache/ especifican la localizaci�n de los respectivos programas. </RefSect1> <RefSect1><Title>APT con DSelect</> <para> Cuando APT se usa como m�todo de &dselect; varias directivas de configuraci�n controlan el comportamiento predeterminado. Se encuentran en la secci�n <literal/DSelect/. <VariableList> <VarListEntry><Term>Clean</Term> <ListItem><Para> Modo de borrado de cach�; este valor puede ser always, prompt, auto, pre-auto y never. always y prompt borrar�n todos los paquetes de la cach� despu�s de actualizar, prompt (predeterminado) pregunta primero. auto borra s�lo aquellos paquetes que ya no se pueden descargar (han sido reemplazados por otra versi�n, por ejemplo). pre-auto realiza esta �ltima acci�n antes de descargar los paquetes nuevos. </VarListEntry> <VarListEntry><Term>Options</Term> <ListItem><Para> El contenido de esta variable se pasa a &apt-get; como opciones de l�nea de ordenes cuando se ejecuta en la fase de instalaci�n. </VarListEntry> <VarListEntry><Term>UpdateOptions</Term> <ListItem><Para> El contenido de esta variable se pasa a &apt-get; como opciones de l�nea de ordenes cuando se ejecuta en la fase de actualizaci�n. </VarListEntry> <VarListEntry><Term>PromptAfterUpdate</Term> <ListItem><Para> Si es true la operaci�n de [U]pdate en &dselect; preguntar� siempre antes de continuar. Por omisi�n s�lo pregunta en caso de error. </VarListEntry> </VariableList> </RefSect1> <RefSect1><Title>Como APT llama a dpkg</> <para> Varias directivas de configuraci�n controlan como APT llama a &dpkg;. Se encuentran en la secci�n <literal/DPkg/. <VariableList> <VarListEntry><Term>Options</Term> <ListItem><Para> Lista de opciones que se pasan a dpkg. Las opciones deben especificarse usando la notaci�n de lista y cada elemento de la lista se pasa a &dpkg; como un s�lo argumento. </VarListEntry> <VarListEntry><Term>Pre-Invoke</Term><Term>Post-Invoke</Term> <ListItem><Para> Es una lista de �rdenes de shell que se ejecutar�n antes de llamar a &dpkg;. Como <literal/Options/, debe de especificarse con notaci�n de lista. Las �rdenes se ejecutan en orden usando <filename>/bin/sh</>, si alguna falla APT abortar�. </VarListEntry> <VarListEntry><Term>Pre-Install-Pkgs</Term> <ListItem><Para> Lista de �rdenes de shell que se ejecutar�n antes de llamar a &dpkg;. Como <literal/Options/, debe de especificarse con notaci�n de lista. Las �rdenes se ejecutan en orden usando <filename>/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 l�nea. <para> La versi�n 2 de este protocolo vuelca m�s informaci�n, incluyendo la versi�n del protocolo, el espacio de configuraci�n de APT <!--Esto suena raro-->, los ficheros y versiones que cambian. La versi�n 2 se habilita estableciendo <literal/DPkg::Tools::Options::cmd::Version/ a 2. <literal/cmd/ es una orden dada a <literal/Pre-Install-Pkgs/. </VarListEntry> <VarListEntry><Term>Run-Directory</Term> <ListItem><Para> APT hace que �ste sea su directorio de trabajo antes de llamar a dpkg, por omisi�n es <filename>/</>. </VarListEntry> <VarListEntry><Term>Build-Options</Term> <ListItem><Para> �stas opciones se pasan a &dpkg-buildpackage; cuando compila paquetes, por omisi�n se limita a deshabilitar el firmado de paquetes y producir todos los binarios. </VarListEntry> </VariableList> </RefSect1> <RefSect1><Title>Opciones de depuraci�n</> <para> La mayor�a de las opciones de la secci�n <literal/debug/ no son interesantes para el usuario normal, sin embargo <literal/Debug::pkgProblemResolver/ muestra una salida interesante acerca de las decisiones que realiza dist-upgrade. <literal/Debug::NoLocking/ deshabilita el bloqueo de fichero de forma que APT puede realizar algunas operaciones sin permisos de superusuario y <literal/Debug::pkgDPkgPM/ mostrar� la l�nea de �rdenes para cada llamada a dpkg. <literal/Debug::IdentCdrom/ deshabilitar� la inclusi�n de datos de statfs <!--��sto es correcto-->en los ID's de los CDROM. </RefSect1> <RefSect1><Title>Ejemplos</> <para> &configureindex; contiene un fichero de configuraci�n de ejemplo mostrando los valores predeterminados para todas las opciones posibles. </RefSect1> <RefSect1><Title>Ficheros</> <para> <filename>/etc/apt/apt.conf</> </RefSect1> <RefSect1><Title>V�ase tambi�n</> <para> &apt-cache;, &apt-config;<!-- ? reading apt.conf -->, &apt-preferences;. </RefSect1> &manbugs; &manauthor; <refsect1> <title>TRADUCTOR</title> <para> Traducci�n de Rub�n Porras Campo <debian-l10n-spanish@lists.debian.org> </para> </refsect1> </refentry>