<!-- -*- 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::&lt;puesto&gt;/ 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
      &lt;debian-l10n-spanish@lists.debian.org&gt;
    </para>
  </refsect1>
 
</refentry>