<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

<!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.3 del CVS de
/cvs/debian-doc/manpages/english/apt/apt.conf.5.xml
-->

<refentry lang="es">
 <refentryinfo>
  &apt-author.jgunthorpe;
  &apt-author.team;
  &apt-email;
  &apt-product;
  <!-- The last update date -->
  <date>29 February 2004</date>
 </refentryinfo>
 
 <refmeta>
   <refentrytitle>apt.conf</refentrytitle>
   <manvolnum>5</manvolnum>
 </refmeta>
 
 <!-- Man page title -->
 <refnamediv>
    <refname>apt.conf</refname>
    <refpurpose>Archivo de configuración de APT</refpurpose>
 </refnamediv>
 
 <refsect1><title>Descripción</title>
   <para>
   <filename>apt.conf</filename> 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</envar> (si existe), luego leerá los ficheos en
   <literal>Dir::Etc::Parts</literal>, entonces leerá el fichero de
   configuración principal especificado por <literal>Dir::Etc::main</literal>,
   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>
   <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</literal> es un opción de la función GET del
   conjunto de herramientas APT.  Las opciones no son heredadas de sus grupos
   padres.</para>
   <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>
   <para>
   En general, el fichero de configuración de ejemplo
   <filename>&docdir;examples/apt.conf</filename> &configureindex; es una buena
   guía para entender su aspecto.</para>
   <para>
   Se permiten dos valores especiales, <literal>#include</literal> y
   <literal>#clear</literal>.  <literal>#include</literal> 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</literal> se usa
   para suprimir la lista de nombres.</para>
   <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</literal> 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.</para>
   </refsect1>

 <refsect1><title>El grupo APT</title>
   <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.</para></listitem>
     </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.</para></listitem>
     </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.</para></listitem>
     </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.</para></listitem>
     </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.</para></listitem>
     </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é (en
     bytes).</para></listitem>
     </varlistentry>

     <varlistentry><term>Build-Essential</term>
     <listitem><para>
     Define que paquete(s) son considerados dependencias de construcción
     esenciales.</para></listitem>
     </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.</para></listitem>
     </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.</para></listitem>
     </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.</para></listitem>
     </varlistentry>
   </variablelist></para>
 </refsect1>

 <refsect1><title>El grupo Acquire</title>
   <para>   
   El grupo de opciones <literal>Acquire</literal> controla la descarga de
   paquetes y los manejadores de URI.
   <variablelist>
     <varlistentry><term>Queue-Mode</term>
     <listitem><para>
     Modo de cola; <literal>Queue-Mode</literal> puede ser
     <literal>host</literal> o <literal>access</literal> que determina como
     paralelizar las conexiones salientes de APT. <literal>host</literal>
     significa que se abrirá una conexión por puesto de destino,
     <literal>access</literal> significa que será abierta una conexión por cada
     tipo de URI.</para></listitem>
     </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.</para></listitem>
     </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.</para></listitem>
     </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]/</literal>.  También se
     puede especificar un proxy por cada puesto usando la forma
     <literal>http::Proxy::&lt;puesto&gt;</literal> con la palabra especial
     <literal>DIRECT</literal> queriendo decir que no se use proxy. La variable
     de entorno <envar>http_proxy</envar> modifica todas las
     preferencias.</para>
     <para>
     Para los proxies que cumplen con HTTP/1.1 se proporcionan tres opciones de
     configuración. <literal>No-Cache</literal> dice al proxy que no use su
     caché bajo ninguna circunstancia, <literal>Max-Age</literal> 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</literal> 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>
     <para>
     La opción <literal>timeout</literal> 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>
     <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</literal> 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.</para></listitem>
     </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]/</literal> y se modifica
     mediante la variable de entorno <envar>ftp_proxy</envar>. Para usar un
     proxy ftp es necesario establecer el script
     <literal>ftp::ProxyLogin</literal> 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>, <literal>$(PROXY_PASS)</literal>,
     <literal>$(SITE_USER)</literal>, <literal>$(SITE_PASS)</literal>,
     <literal>$(SITE)</literal>, y <literal>$(SITE_PORT)</literal>. Cada una se
     toma del componete de la URI correspondiente.</para>
     <para>
     La opción <literal>timeout</literal> 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>
     <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>
     <para>
     Es posible usar proxy FTP a través de HTTP estableciendo la variable de
     entorno <envar>ftp_proxy</envar> 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>
     <para>
     La opción <literal>ForceExtended</literal> controla el uso de las órdenes
     de RFC2428 <literal>EPSV</literal> y <literal>EPRT</literal>. 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.</para></listitem>
     </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</literal> debe ser el punto de montaje de la
     unidad de CDROM tal y como se especifica en
     <filename>/etc/fstab</filename>. 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.</para></listitem>
     </varlistentry>
   </variablelist></para>
 </refsect1>

 <refsect1><title>Directorios</title>
   <para>   
   La sección <literal>Dir::State</literal> contiene directorios que pertenecen
   a información del estado local. <literal>lists</literal> es el directorio
   donde se almacenan las listas de paquetes descargados y
   <literal>status</literal> es el nombre del fichero de estado de dpkg.
   <literal>preferences</literal> es el nombre del fichero de preferencias de
   APT.  <literal>Dir::State</literal> contiene el directorio que se usará como
   prefijo por omisión en todas las opciones restantes en caso de que no
   empiezen con <filename>/</filename> o <filename>./</filename>.</para>
   <para>
   <literal>Dir::Cache</literal> contiene lugares pertenecientes a información
   de la caché local, como las dos cachés de paquetes
   <literal>srcpkgcache</literal> y <literal>pkgcache</literal> o como el lugar
   donde se guardan los ficheros descargados,
   <literal>Dir::Cache::archives</literal>. 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</literal> el directorio
   predeterminado está en <literal>Dir::Cache</literal></para>
   <para>
   <literal>Dir::Etc</literal> contiene el lugar de los ficheros de
   configuración, <literal>sourcelist</literal> contiene el lugar de sourcelist
   y <literal>main</literal> 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</envar>).</para>
   <para>
   La opción <literal>Dir::Parts</literal> 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>
   <para>
   <literal>Dir::Bin</literal> apunta a los programas
   binarios. <literal>Dir::Bin::Methods</literal> especifica la localización de
   los manejadores de los métodos y <literal>gzip</literal>,
   <literal>dpkg</literal>, <literal>apt-get</literal>,
   <literal>dpkg-source</literal>, <literal>dpkg-buildpackage</literal> y
   <literal>apt-cache</literal> especifican la localización de los respectivos
   programas.</para>
 </refsect1>
 
 <refsect1><title>APT con DSelect</title>
   <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</literal>.
   
   <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.</para></listitem>
     </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.</para></listitem>
     </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.</para></listitem>
     </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.</para></listitem>
     </varlistentry>
   </variablelist></para>
 </refsect1>
 
  <refsect1><title>Como APT llama a dpkg</title>
   <para>   
   Varias directivas de configuración controlan como APT llama a &dpkg;. Se
   encuentran en la sección <literal>DPkg</literal>.

   <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.</para></listitem>
     </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</literal>, debe de especificarse con notación
     de lista. Las órdenes se ejecutan en orden usando
     <filename>/bin/sh</filename>, si alguna falla APT
     abortará.</para></listitem>
     </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</literal>, debe de especificarse con notación de
     lista. Las órdenes se ejecutan en orden usando
     <filename>/bin/sh</filename>, 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>
     <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</literal> a
     2. <literal>cmd</literal> es una orden dada a
     <literal>Pre-Install-Pkgs</literal>.</para></listitem>
     </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>/</filename>.</para></listitem>
     </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.</para></listitem>
     </varlistentry>
   </variablelist></para>
 </refsect1>

 <refsect1><title>Opciones de depuración</title>
   <para>   
   La mayoría de las opciones de la sección <literal>debug</literal> no son
   interesantes para el usuario normal, sin embargo
   <literal>Debug::pkgProblemResolver</literal> muestra una salida interesante
   acerca de las decisiones que realiza
   dist-upgrade. <literal>Debug::NoLocking</literal> deshabilita el bloqueo de
   fichero de forma que APT puede realizar algunas operaciones sin permisos de
   superusuario y <literal>Debug::pkgDPkgPM</literal> mostrará la línea de
   órdenes para cada llamada a dpkg. <literal>Debug::IdentCdrom</literal>
   deshabilitará la inclusión de datos de statfs <!--¿ésto es correcto-->en los
   ID's de los CDROM.</para>
 </refsect1>
 
 <refsect1><title>Ejemplos</title>
   <para>
   &configureindex; es un fichero de configuración mostrando valores de ejemplo
   para todas las opciones posibles.</para>
 </refsect1>
 
 <refsect1><title>Ficheros</title>
   <para>
   <filename>/etc/apt/apt.conf</filename></para>
 </refsect1>
 
 <refsect1><title>Véase también</title>
   <para>
   &apt-cache;, &apt-config;<!-- ? reading apt.conf -->, &apt-preferences;.</para>
 </refsect1>

 &manbugs;

  <refsect1><title>Traductor</title>
    <para>
       &apt-translator.cmestre;&apt-translator.email;
    </para>
  </refsect1>

</refentry>
