Provided by: apt_1.0.1ubuntu2_amd64 bug

NOMBRE

       apt.conf - Fichero de configuración de APT

DESCRIPCIÓN

       /etc/apt/apt.conf es el fichero de configuración principal, compartido por todas las
       herramientas del conjunto APT, aunque no es la única ubicación donde se pueden definir
       opciones. El conjunto de herramientas también comparte el mismo analizador de línea de
       órdenes para ofrecer un entorno homogéneo.

       Cuando se inicia una herramienta de APT, leerá los ficheros de configuración en el
       siguiente orden:

        1. El fichero definido por la variable de entorno APT_CONFIG (de existir).

        2. Todos los ficheros en Dir::Etc::Parts en orden alfanumérico ascendente cuya extensión
           de fichero no es «conf» y que solo contenga caracteres alfanuméricos, guión (-), guión
           bajo (_) y punto (.). De no ser así, APT informa de que ha ignorado un fichero si este
           no coincide con el patrón en la lista de configuración Dir::Ignore-Files-Silently. Si
           coincide, se ignora de forma silenciosa.

        3. El fichero de configuración principal definido por Dir::Etc::main.

        4. Las opciones de línea de órdenes se aplican para anular directivas de configuración o
           para cargar más ficheros de configuración.

SINTAXIS

       El fichero de configuración está organizado en forma de árbol con las opciones organizadas
       en grupos funcionales. Las opciones se proporcionan con dos puntos dobles; por ejemplo
       APT::Get::Assume-Yes es una opción de la herramienta Get, dentro del conjunto de
       herramientas de APT. Las opciones no se heredan de sus grupos paternos.

       Sintácticamente, el modelo del lenguaje de configuración es similar a las herramientas de
       ISC como pueden ser «bind» y «dhcp». Las líneas que comienzan con // se tratan como
       comentarios (se ignoran), así como todo el texto que haya entre /* y */, igual que en los
       comentarios de C/C++. Cada línea tiene la forma APT::Get::Assume-Yes "true";. Es necesario
       utilizar comillas y un punto y coma final. El valor debe estar en una única línea y no se
       permite concatenar cadenas. No se pueden incluir barras inversas «\» o comillas
       adicionales. Un nombre de opción se compone de caracteres alfanuméricos y los caracteres
       «/-:._+». Un nuevo ámbito se puede abrir con llaves, como:

           APT {
             Get {
               Assume-Yes "true";
               Fix-Broken "true";
             };
           };

       con nuevas líneas ubicadas para hacerlo más legible. Las listas pueden crearse abriendo un
       nuevo ámbito e incluyendo una única cadena acotada entre comillas seguida de un punto y
       coma. Se pueden incluir varias entradas separadas por punto y coma.

           DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};

       En general, el fichero de configuración de ejemplo
       /usr/share/doc/apt/examples/configure-index.gz es una buena guía para entender su aspecto.

       El uso de las mayúsculas no afecta a los nombres de opciones de configuración, y por ello,
       en el ejemplo anterior, puede utilizar dpkg::pre-install-pkgs.

       Los nombres de las opciones de configuración son opcionales si se define una lista como
       muestra el ejemplo anterior de DPkg::Pre-Install-Pkgs. Si no se define un nombre,
       simplemente se añade una nueva opción a la lista. Si se define un nombre, se puede
       redefinir la opción como cualquier otra opción reasignando un nuevo valor a la opción.

       Se definen dos órdenes especiales, #include (ya obsoleto y no es compatible en
       implementaciones alternativas) y #clear.  #include incluirá el fichero proporcionado, a
       menos que el final del nombre del fichero acabe en una barra, en cuyo caso se incluye el
       directorio entero.  #clear se usa para borrar parte del árbol de configuración. El
       elemento especificado y sus descendientes se eliminarán. (Tenga en cuenta que estas líneas
       también deben acabar con punto y coma).

       La orden #clear ofrece la única forma de eliminar una lista o un ámbito completo. Reabrir
       un ámbito (o utilizar la sintaxis de adición de :: que se describe a continuación) no
       redefinirá las entradas escritas anteriormente. Sólo se pueden redefinir las opciones
       asignándolas un nuevo valor; las listas y los ámbitos no se pueden redefinir, sólo
       eliminar.

       Todas las herramientas de APT aceptan la opción «-o» que permite definir una directriz
       arbitraria de configuración que se define en la línea de órdenes. La sintaxis es un nombre
       de opción completo (por ejemplo, APT::Get::Assume-Yes) seguido por signos de igualdad y el
       nuevo valor de la opción. Para añadir un nuevo elemento a lista, añada :: al final del
       nombre de la lista. (Como puede imaginar, no puede usar la sintaxis de ámbitos en la línea
       de órdenes).

       Tenga en cuenta que añadir elementos a la lista mediante :: solo funciona para un elemento
       por línea, y no se debe utilizar con la sintaxis de ámbitos (que añade :: de forma
       implícita). Utilizar las dos sintaxis combinadas provocaría un fallo del que
       lamentablemente dependen algunos usuarios: una opción con el nombre no habitual «::» que
       actúa como cualquier otra opción con un nombre. Esto presenta varios problemas; por
       ejemplo, los usuarios que escriban varias líneas con esta sintaxis errónea esperando que
       se añada a una lista obtendrían lo contrario, ya que solo se utilizaría la última
       asignación para la opción «::». Las versiones futuras de APT mostrarán los fallos y
       detendrán el funcionamiento si encuentran algún uso inadecuado, y por ello debe corregir
       tales declaraciones ahora que APT no muestra fallos de forma explícita.

EL GRUPO APT

       Este grupo de opciones controla el comportamiento general de APT así como mantiene las
       opciones para todas las herramientas.

       Architecture
           La arquitectura del sistema, define la arquitectura a usar al obtener los ficheros y
           analizar las listas de paquetes. El valor predeterminado es la arquitectura para la
           que apt se compiló.

       Architectures
           Todas las arquitecturas que el sistema permite. Por ejemplo, los procesadores que
           incorporan el conjunto de instrucciones amd64 (también llamado x86-64) permiten
           ejecutar binarios compilados para el conjunto de instrucciones i386 (x86). Esta lista
           se utiliza al obtener paquetes y analizar las listas de paquetes. El valor
           predeterminado es la arquitectura nativa del sistema (APT::Architecture), y las
           arquitecturas externas se añaden al registro mediante dpkg --add-architecture.

       Build-Profiles
           List of all build profiles enabled for build-dependency resolution, without the
           "profile." namespace prefix. By default this list is empty. The DEB_BUILD_PROFILES as
           used by dpkg-buildpackage(1) overrides the list notation.

       Default-Release
           La versión predeterminada de la que se instalarán los paquetes, si hay más de una
           versión disponible. Contiene el nombre de la versión, ya sea el nombre en código o el
           número de la versión. Por ejemplo: «stable», «testing», «unstable», «wheezy»,
           «jessie», «4.0», «5.0*». Consulte también apt_preferences(5).

       Ignore-Hold
           Ignora paquetes retenidos. Esta opción global provoca que el solucionador de problemas
           ignore los paquetes retenidos en la toma de decisiones.

       Clean-Installed
           Activo de forma predeterminada. Cuando se activa la función «autoclean», ésta
           eliminará cualquier paquete del almacén que ya no se pueda descargar. Si se desactiva,
           entonces los paquetes que están localmente instalados son excluidos de la limpieza -
           tenga en cuenta que APT no proporciona ningún mecanismo directo para reinstalarlos.

       Immediate-Configure
           Activo de forma predeterminada, lo que provoca que APT instale paquetes esenciales e
           importantes en la siguiente acción de instalación/actualización para así limitar el
           efecto de un fallo de invocación a dpkg(1). Si se desactiva esta opción, APT trata un
           paquete importante de la misma forma que un paquete extra: entre el desempaquetado del
           paquete A y su configuración se pueden dar otros desempaquetados o invocaciones de
           configuración para otros paquete no relacionados, como B, C, etc. Si esto último
           provoca un fallo en la invocación a dpkg(1) (por ejemplo, porque los scripts de
           desarrollador del paquete B provocan un error), el resultado es un estado del sistema
           en el que el paquete A está desempaquetado pero no configurado, lo que puede afectar
           al correcto funcionamiento de los paquetes dependientes del paquete A, ya que no se
           satisface la dependencia sobre éste.

           El marcador de configuración inmediata también se aplica en los casos problemáticos de
           dependencias circulares, ya que una dependencia con el marcador de configuración
           inmediata equivale a una predependencia. En teoría, esto permite que APT reconozca un
           caso en el que no puede realizar una configuración inmediata, interrumpa la operación,
           y sugiera al usuario la desactivación temporal de la opción para poder completar la
           operación. Tenga en cuenta el uso de la palabra «teoría»; el uso real ha provocado
           este problema muy pocas veces, en versiones de publicaciones no estables, y provocado
           por las dependencias erróneas de un paquete específico o en un sistema con un estado
           previo de dependencias rotas. No desactive esta opción sin reflexionar antes, ya que
           evita otros problemas además del caso descrito anteriormente.

           Antes de ejecutar una operación profunda como dist-upgrade con esta opción
           desactivada, debería intentar ejecutar install para el paquete que APT es incapaz de
           configurar inmediatamente; cerciórese de informar de su problema a su distribución y
           al equipo de APT mediante el enlace de informe de fallo al final del documento, para
           que así pueden mejorar y corregir el proceso de actualización.

       Force-LoopBreak
           Nunca active esta opción a menos que realmente sepa lo que hace. Permite a APT
           eliminar un paquete esencial de forma temporal para interrumpir un bucle
           «Conflicto/Conflicto» o «Conflicto/Predepende» entre dos paquetes esenciales.  Un
           buble así no debería existir y es un fallo serio. Esta opción funciona si los paquetes
           esenciales no son tar, gzip, libc, dpkg, dash o cualquier cosa sobre la que estos
           paquetes dependen.

       Cache-Start, Cache-Grow, Cache-Limit
           A partir de la versión 0.7.26, APT utiliza un fichero de caché mapeado en memoria para
           almacenar la información de paquetes disponibles.  Cache-Start actúa como una
           indicación del tamaño máximo de la caché, y por ello es la cantidad de memoria que APT
           solicita al iniciarse. El valor predeterminado es 20971520 bytes (aprox. 20 MB). Tenga
           en cuanta que esta cantidad de espacio debe estar disponible para APT; de lo
           contrario, fallará posiblemente, y por ello se debe reducir este valor para
           dispositivos con restricciones de memoria, mientras que se debe aumentar para sistemas
           con varias fuentes configuradas.  Cache-Grow define en bytes con un valor
           predeterminado de 1048576 (aprox. 1 MB) cuánto puede aumentar como máximo el tamaño de
           la caché si no basta con el espacio definido con Cache-Start. Este valor se aplica
           repetidas veces hasta que la caché puede almacenar toda la información, o el tamaño de
           la caché alcance el valor definido con Cache-Limit. El valor predeterminado de
           Cache-Limit es cero, sin límite. Si se define Cache-Grow con un valor de cero, se
           desactiva el crecimiento automático de la caché.

       Build-Essential
           Define los paquetes que se consideran dependencias de construcción esenciales.

       Get
           La subsección «Get» controla la herramienta apt-get(8); consulte la documentación para
           más información sobre esta opción.

       Cache
           La subsección Cache controla la herramienta apt-cache(8); consulte la documentación
           para más información sobre esta opción.

       CDROM
           La subsección CDROM controla la herramienta apt-cdrom(8); consulte la documentación
           para más información sobre esta opción.

EL GRUPO ACQUIRE

       El grupo de opciones Acquire controla la descarga de paquetes y los distintos métodos de
       obtención responsable de la descarga en sí mismo (consulte también sources.list(5)).

       Check-Valid-Until
           Opción relacionada con la seguridad, cuyo valor predeterminado es «true», ya que una
           validación con fecha de vencimiento para un fichero «Release» evita ataques replay de
           larga duración y puede, por ejemplo, ayudar a identificar las réplicas no
           actualizadas, aunque esta función depende de la corrección de la hora del sistema del
           usuario. Se recomienda a los responsables de archivos que creen ficheros «Release» con
           la cabecera Valid-Until, pero si no se hace o se desea un valor más estricto, se puede
           utilizar la opción Max-ValidTime a continuación.

       Max-ValidTime
           El periodo (en segundos) a partir de la creación del fichero «Release» (indicado en la
           cabecera Date) durante el cual se considerará válida. Si el fichero «Release» incluye
           una cabecera Valid-Until, la fecha más temprana se utilizará como la fecha de
           vencimiento. El valor predefinido es 0, esto es, sin límite de tiempo. Las opciones de
           configuración específicas al archivo se pueden realizar añadiendo la etiqueta del
           archivo al nombre de opción.

       Min-ValidTime
           El tiempo mínimo en segundos a partir de la creación del fichero Release (indicado en
           la cabecera Date) durante los cuales se considerará válido .Utilícelo si necesita
           utilizar una réplica (local) raramente actualizada que es copia de un archivo
           actualizado regularmente con una cabecera calida Valid-Until en lugar de desactivar la
           comprobación de la fecha de vencimiento. Las opciones de configuración específicas del
           archivo se pueden y deben utilizar añadiendo la etiqueta del archivo al nombre de
           opción.

       PDiffs
           Intenta descargar deltas llamados PDiffs para los índices (como ficheros Packages) en
           lugar de descargarlos enteros. Su valor predeterminado es «true».

           Se ofrecen dos opciones secundarias para limitar el uso de «PDiffs»: FileLimit permite
           definir el número máximo de ficheros «PDiff» que se descargarán para actualizar un
           fichero. Por otra parte, SizeLimit es el porcentaje máximo del tamaño de todos los
           parches en comparación con el tamaño del fichero de destino. Si se supera uno de estos
           límites, se descargará el fichero completo en lugar de los parches.

       Queue-Mode
           Modo de cola, Queue-Mode puede ser host o access, que determina cómo paralelizará APT
           las conexiones salientes.  host significa que se abrirá una conexión por máquina de
           destino, access significa que se abrirá una conexión por cada tipo de URI.

       Retries
           El número de reintentos a realizar. Si es distinto de cero APT volverá a intentar
           obtener los ficheros fallidos el número de veces proporcionado.

       Source-Symlinks
           Utiliza enlaces simbólicos para los archivos fuente. Si es «true» los archivos fuente
           se enlazarán cuando sea posible, en vez de copiarse. Es «true» de forma
           predeterminada.

       http
           http::Proxy define el proxy predeterminado que utilizar para direcciones HTTP URI.
           Utiliza el formato estándar http://[[usuario][:contraseña]@]máquina[:puerto]/. También
           se puede especificar un proxy por cada máquina usando la forma http::Proxy::<máquina>
           con la palabra especial DIRECT que significa que no se use ningún proxy. La variable
           de entorno http_proxy se usará en caso de no definir ninguna de las opciones
           anteriores.

           Se proporcionan tres opciones de configuración para el control de la caché con proxy
           cachés conformes a HTTP/1.1.  No-Cache indica al proxy que nunca utilice la respuesta
           cacheada.  Max-Age define la máxima antigüedad permitida (en segundos) de un fichero
           de índice en la caché de un proxy.  No-Store define que el proxy no debe almacenar
           ficheros del archivo en su caché, que se puede utilizar para impedir que el proxy
           contamine la caché con ficheros «.deb» (de gran tamaño).

           La opción timeout define el tiempo máximo de espera utilizado por el método; este
           valor se aplica al establecimiento de conexión y a la recepción de datos.

           La opción Acquire::http::Pipeline-Depth se puede utilizar para activar HTTP pipelining
           (RFC 2616 sección 8.1.2.2), que puede facilitar, por ejemplo, las conexiones de
           latencia alta. También define el número de solicitudes que se envían en cada pipeline.
           El valor predeterminado para esta opción con versiones anteriores de APT era 10, pero
           ahora el valor predeterminado es cero (= desactivado) para evitar problemas con la
           siempre creciente cantidad de servidores web y proxies que escogen no cumplir la
           especificación HTTP/1.1.

           Acquire::http::AllowRedirect controla si APT respeta una redirección; activado por
           omisión.

           The used bandwidth can be limited with Acquire::http::Dl-Limit which accepts integer
           values in kilobytes per second. The default value is 0 which deactivates the limit and
           tries to use all available bandwidth. Note that this option implicitly disables
           downloading from multiple servers at the same time.

           Acquire::http::User-Agent se puede usar para definir un «User-Agent» distinto para la
           descarga http ya que algunos proxys sólo permiten el acceso para clientes que usan un
           identificador conocido.

           Acquire::http::Proxy-Auto-Detect can be used to specify an external command to
           discover the http proxy to use. Apt expects the command to output the proxy on stdout
           in the style http://proxy:port/. This will override the generic Acquire::http::Proxy
           but not any specific host proxy configuration set via Acquire::http::Proxy::$HOST. See
           the squid-deb-proxy-client(1) package for an example implementation that uses avahi.
           This option takes precedence over the legacy option name ProxyAutoDetect.

       https
           Las opciones Cache-control, Timeout, AllowRedirect, Dl-Limit y proxy funcionan con
           direcciones HTTPS URI de la misma forma que con el método http, y utiliza los mismos
           valores predeterminados si no se define. Aún no se permite la opción Pipeline-Depth.

           La subopción CaInfo define la ubicación del fichero que guarda la información sobre
           certificados de confianza.  <host>::CaInfo es la opción correspondiente para cada
           servidor. La subopción booleana Verify-Peer define si se debe comprobar el certificado
           del servidor con certificados de confianza.  <host>::Verify-Peer es la opción
           correspondiente para cada servidor. La subopción booleana Verify-Host define si se
           debe comprobar el «hostname» del servidor.  <host>::Verify-Host es la opción
           correspondiente para cada servidor.  SslCert define el certificado que utilizar para
           la autenticación del cliente.  <host>::SslCert es la opción correspondiente para cada
           servidor.  SslKey define la clave privada que utilizar para la autenticación del
           cliente.  <host>::SslKey es la opción correspondiente para cada servidor.
           SslForceVersion sustituye la versión predeterminada de SSL que utilizar. Se admiten
           las cadenas «TLSv1» o «SSLv3».  <host>::SslForceVersion es la opción correspondiente
           para cada servidor.

       ftp
           ftp::Proxy define el proxy predeterminado que utilizar para los URI de FTP. Utiliza el
           formato estándar ftp://[[usuario][:contraseña]@]máquina[:puerto]/. También se puede
           especificar un proxy por cada máquina usando la forma ftp::Proxy::<máquina> con la
           palabra especial DIRECT, que significa que no se use ningún proxy. La variable de
           entorno ftp_proxy se usará en caso de no definir ninguna de las opciones anteriores.
           Para usar un proxy FTP debe configurar el script ftp::ProxyLogin en el fichero de
           configuración. Esta entrada define las órdenes a enviar para decirle al servidor del
           proxy a qué conectarse. Consulte /usr/share/doc/apt/examples/configure-index.gz para
           un ejemplo de uso. Las variables de sustitución que representan el componente URI son
           $(PROXY_USER)$(PROXY_PASS)$(SITE_USER)$(SITE_PASS)$(SITE) y $(SITE_PORT).

           La opción timeout define el tiempo máximo de espera utilizado por el método; este
           valor se aplica al establecimiento de conexión y a la recepción de datos.

           Puede controlar el modo pasivo a través de varias opciones. Habitualmente, es seguro
           dejar activado el modo pasivo, y funciona en casi todos los entornos. Sin embargo
           algunas situaciones requieren desactivar el modo pasivo y usar el modo puerto de FTP
           en su lugar. Esto se puede hacer globalmente, para conexiones a través de un proxy o
           para una máquina en concreto (consulte el ejemplo de fichero de configuración para ver
           algunos ejemplos).

           Es posible usar un proxy FTP a través de HTTP definiendo la variable de entorno
           ftp_proxy con un HTTP URL. Para la sintaxis consulte la explicación anterior del
           método http. Esto no puede definir en el fichero de configuración y no se recomienda
           el uso de FTP por encima de HTTP debido a su poca eficiencia.

           La opción ForceExtended controla el uso de las órdenes de RFC 2428 EPSV y EPRT. De
           forma predeterminada es «false», que significa que sólo se usa si el control de
           conexión es IPv6. Cambiándolo a «true» fuerza su uso incluso en conexiones IPv4. Tenga
           en cuenta que la mayoría de los servidores de FTP no son compatibles con la RFC 2428.

       cdrom
           Para los URI que utilizan el método cdrom, la única opción configurable es el punto de
           montaje, cdrom::Mount, que debe ser el punto de montaje del dispositivo de CD-ROM (o
           DVD u otro) tal y como se define en /etc/fstab. Se pueden proporcionar órdenes «mount»
           y «unmount» alternativas si el punto de montaje no se puede definir en el fichero
           «fstab». La sintaxis consiste en insertar

               /cdrom/::Mount "algo";

           dentro del bloque cdrom. Es importante dejar una barra al final. Puede especificar
           órdenes para desmontar mediante UMount.

       gpgv
           Para direcciones GPGV URI, la única opción configurable es gpgv::Options, que
           introduce parámetros adicionales a gpgv.

       CompressionTypes
           Lista de los tipos de compresión que se pueden usar en los métodos de «acquire». Los
           ficheros como Packages pueden estar disponibles en varios formatos de compresión. De
           forma predeterminada los métodos de «acquire» pueden descomprimir los ficheros
           comprimidos en bzip2, lzma y gzip, y con esta opción se pueden añadir más formatos en
           el momento, o cambiar el método usado. La sintaxis para esto es:

               Acquire::CompressionTypes::extensión-del-fichero "nombre-del-método";

           El subgrupo Order también se puede usar para definir en qué orden el sistema de
           «acquire» intentará descargar los ficheros comprimidos. El sistema de «acquire»
           intentará el primero y, en caso de error, procederá con el siguiente tipo de
           compresión de la lista, por lo que si prefiere un tipo antes que otro sólo tiene que
           añadirlo a la lista el primero (los tipos predeterminados que no se han añadido lo
           hacen de forma implícita al final de la lista; por ejemplo,

               Acquire::CompressionTypes::Order:: "gz";

           se puede usar cuando se prefieran los ficheros comprimidos con gzip antes que con
           bzip2 y lzma. Si se prefiere lzma antes que gzip y bzip2, la opción de configuración
           debería parecerse a esto

               Acquire::CompressionTypes::Order { "lzma"; "gz"; };

           No es necesario añadir bz2 a la lista de forma explícita ya que se añadirá de forma
           automática.

           Tenga en cuenta que Dir::Bin::método se comprueba en tiempo de ejecución. Si se define
           esta opción, el método se usará solo si este fichero existe; por ejemplo, la opción
           para el método bzip2 (integrado) es:

               Dir::Bin::bzip2 "/bin/bzip2";

           . Tenga en cuenta que las entradas para la lista definidas en la línea de órdenes se
           añadirán al final de la lista definida en los ficheros de configuración, pero antes
           que las entradas predefinidas. Si prefiere un tipo sobre otro definido en los ficheros
           de configuración, defina la opción directamente, no en estilo de lista. Esto no omite
           la lista definida, simplemente prefija la lista con este tipo.

           El tipo especial uncompressed se puede utilizar para establecer una preferencia por
           los ficheros descomprimidos, pero tenga en cuenta que la mayoría de archivos no
           proporcionan ficheros descomprimidos, así que habitualmente esto solo sirve con
           réplicas locales.

       GzipIndexes
           Al descargar ficheros de índice comprimidos con gzip, («Packages», «Sources», o
           «Translations»), los mantiene comprimidos localmente en lugar de desempaquetarlos.
           Esto ahorra mucho espacio en disco a costa de mayores requerimientos del procesador al
           generar los almacenes de paquetes locales. El valor predeterminado es «false».

       Languages
           La subsección «Languages» controla qué ficheros Translation se descargan y en qué
           orden APT intentará mostrar las traducciones de la descripción. APT intentará mostrar
           la primera descripción en el idioma que esté primero en la lista. Los idiomas se
           pueden especificar con sus códigos de idioma cortos o largos. Tenga en cuenta que no
           todos los archivos de paquetes proporcionan ficheros Translation para cada idioma
           (especialmente para los códigos de idioma largos).

           La lista predeterminada incluye «environment» y «en». «environment» tiene aquí un
           significado especial: se sustituye en tiempo de ejecución con los códigos de idioma
           extraídos de la variable de entorno LC_MESSAGES. También comprueba que estos códigos
           no se incluyen por duplicado. Si se define LC_MESSAGES como «C», solo se utiliza el
           fichero Translation-en (si está disponible). Para obligar a que APT no utilice ningún
           fichero «Translation» utilice la configuración Acquire::Languages=none. «none» es otro
           código con significado especial que detiene la búsqueda de un fichero Translation
           adecuado. Indica a APT que también descargue estas traducciones, sin utilizarlas
           amenos que el entorno defina el idioma. Por ello, el siguiente ejemplo de
           configuración en el orden «en, de» para una configuración local en inglés, o «de, en»
           para una en alemán. Tenga en cuenta que se descarga «fr», pero no se utiliza a menos
           que se utilice APT bajo una configuración local en francés (donde el orden sería «fr,
           de, en»).

               Acquire::Languages { "environment"; "de"; "en"; "none"; "fr"; }

           Nota: para impedir problemas derivados de ejecutar APT en distintos entornos (por
           ejemplo, por distintos usuarios u otros programas), todos los ficheros «Translation»
           que se encuentran en /var/lib/apt/lists/ se añaden al final de la lista (después de un
           «none» implícito).

       ForceIPv4
           When downloading, force to use only the IPv4 protocol.

       ForceIPv6
           When downloading, force to use only the IPv6 protocol.

DIRECTORIOS

       La sección Dir::State contiene directorios que afectan a la información de estado local.
       lists es el directorio en el que se almacenan las listas de los paquetes descargados y
       status es el nombre del fichero de estado de dpkg(1).  preferences es el nombre del
       fichero preferences (preferencias) de APT.  Dir::State contiene el directorio que se usará
       como prefijo predeterminado en todos los elementos subordinados en caso de que no empiecen
       con / ó ./.

       Dir::Cache contiene las ubicaciones que afectan a la información de la caché local, como
       los dos cachés de paquetes srcpkgcache y pkgcache, así como a la ubicación dónde se
       guardan los ficheros descargados, Dir::Cache::archives. La generación de cachés se puede
       desactivar dejando sus nombres como una cadena vacía. Ésto hará que el arranque sea más
       lento, pero ahorrará espacio. Habitualmente, es preferible deshabilitar pkgcache en lugar
       de srcpkgcache. Al igual que con Dir::State el directorio predeterminado está en
       Dir::Cache

       Dir::Etc contiene la ubicación de los ficheros de configuración, sourcelist proporciona la
       ubicación de sourcelist y 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 definido en APT_CONFIG).

       La opción Dir::Parts lee en todos los fragmentos de ficheros de configuración en orden
       léxico desde el directorio especificado. Al finalizar este proceso carga el fichero de
       configuración principal.

       Dir::Bin apunta a los programas binarios.  Dir::Bin::Methods define la ubicación de los
       gestores de los métodos y gzip, bzip2, lzma, dpkg, apt-get, dpkg-source, dpkg-buildpackage
       y apt-cache especifican la ubicación de sus respectivos programas.

       La opción de configuración RootDir tiene un significado especial. Si se define, todas las
       rutas de Dir:: serán relativas a RootDir, incluso las rutas que se especifiquen de forma
       absoluta. De modo que, por ejemplo, si RootDir se define como /tmp/staging y
       Dir::State::status se define como /var/lib/dpkg/status, entonces el fichero de estado será
       /tmp/staging/var/lib/dpkg/status.

       La lista Ignore-Files-Silently se puede usar para definir qué fichero debería ignorar APT
       silenciosamente al analizar ficheros en los directorios de fragmentos. Por omisión, se
       ignora silenciosamente un fichero que termina con .disabled, ~, .bak o .dpkg-[a-z]+. Como
       se puede ver con el último valor predeterminado, estos patrones pueden usar la sintaxis de
       expresiones regulares.

APT CON DSELECT

       Varias directivas de configuración controlan el comportamiento predeterminado cuando APT
       se usa como método de dselect(1). Éstas se encuentran en la sección DSelect.

       Clean
           Modo de limpieza del almacén de paquetes. Este valor puede ser always, prompt, auto,
           pre-auto y never.  always y prompt eliminan todos los paquetes del almacén después de
           una actualización, aunque prompt (predeterminado) solicita una confirmación.  auto
           solo elimina los paquetes que ya no se pueden descargar (por ejemplo, sustituidos por
           una versión más reciente).  pre-auto realiza esta acción antes de descargar paquetes
           nuevos.

       options
           Los contenidos de esta variable se introducen a apt-get(8) como opciones de la línea
           de ordenes al ejecutar la fase de instalación.

       Updateoptions
           Los contenidos de esta variable se introducen a apt-get(8) como opciones de la línea
           de ordenes al ejecutar la fase de actualización.

       PromptAfterUpdate
           Si es «true», la operación de «[U]pdate» (actualización) en dselect(1) preguntará
           siempre antes de continuar. De forma predeterminada, sólo preguntará en caso de error.

INVOCACIÓN DE APT A DPKG

       Varias directivas de configuración controlan cómo invoca APT a dpkg(1). Éstas se
       encuentran en la sección DPkg.

       options
           Es una lista de opciones que se introducen a dpkg(1). Las opciones se deben
           especificar usando la notación de lista, y cada elemento de la lista se introduce a
           dpkg(1) como un sólo argumento.

       Pre-Invoke, Post-Invoke
           Es una lista de órdenes de la consola que se ejecutarán antes y/o después de invocar a
           dpkg(1). Como options, se debe especificar con notación de lista. Las órdenes se
           ejecutarán en orden usando /bin/sh; en caso de fallo, APT cancela la acción.

       Pre-Install-Pkgs
           This is a list of shell commands to run before invoking dpkg(1). Like options this
           must be specified in list notation. The commands are invoked in order using /bin/sh;
           should any fail APT will abort. APT will pass the filenames of all .deb files it is
           going to install to the commands, one per line on the requested file descriptor,
           defaulting to standard input.

           Version 2 of this protocol dumps more information, including the protocol version, the
           APT configuration space and the packages, files and versions being changed. Version 3
           adds the architecture and MultiArch flag to each version being dumped.

           The version of the protocol to be used for the command cmd can be chosen by setting
           DPkg::Tools::options::cmd::Version accordingly, the default being version 1. If APT
           isn't supporting the requested version it will send the information in the highest
           version it has support for instead.

           The file descriptor to be used to send the information can be requested with
           DPkg::Tools::options::cmd::InfoFD which defaults to 0 for standard input and is
           available since version 0.9.11. Support for the option can be detected by looking for
           the environment variable APT_HOOK_INFO_FD which contains the number of the used file
           descriptor as a confirmation.

       Run-Directory
           APT cambia a este directorio antes de invocar a dpkg(1), el valor predeterminado es /.

       Build-options
           Estas opciones se introducen a dpkg-buildpackage(1) cuando compila paquetes; el
           comportamiento predeterminado se limita a deshabilitar el firmado de paquetes y a
           producir todos los binarios.

   Uso del disparador de dpkg (y de las opciones relacionadas)
       APT puede invocar dpkg(1) de forma que pueda hacer un uso agresivo de los disparadores
       («triggers») mediante varias invocaciones a dpkg(1). Sin no se definen más opciones,
       dpkg(1) utilizará los disparadores una durante su ejecución. Si se activan estas opciones,
       se puede reducir el tiempo necesario para realizar la instalación o la actualización.
       Tenga en cuenta que está diseñado para que estas opciones se activen de forma
       predeterminada en un futuro, pero debido a los cambios drásticos en la manera en que APT
       invoca a dpkg(1), necesita más pruebas.  Actualmente, estas opciones son experimentales, y
       no se deberían usar en entornos de producción.  También provoca un fallo en el informe de
       progreso, con lo que todas las interfaces muestran un progreso del 100% durante la mitad
       del tiempo (o más) durante la configuración de todos los paquetes.

       Tenga en cuenta que no se garantiza que APT permitirá usar estas opciones o que estas
       opciones no causen un (gran) problema en el futuro. Si ha entendido los riesgos y los
       problemas actuales con estas opciones pero es lo suficientemente valiente para ayudar a
       probarlas, cree un nuevo fichero de configuración y pruebe una combinación de las
       opciones. Por favor, informe de cualquier error, problema o mejora que encuentre y
       asegúrese de apuntar en sus informes qué opciones ha usado. Pedir ayuda a dpkg(1) también
       puede ser útil por motivos de depuración, véase por ejemplo: dpkg --audit. Una combinación
       de opciones defensivas sería

           DPkg::NoTriggers "true";
           PackageManager::Configure "smart";
           DPkg::ConfigurePending "true";
           DPkg::TriggersPending "true";

       DPkg::NoTriggers
           Añade a todas las invocaciones a dpkg(1) la opción sin disparadores («no triggers»),
           excepto a la invocación a «ConfigurePending». Consulte dpkg(1) si está interesado en
           saber qué significa esto. De forma breve: dpkg(1) no ejecuta los disparadores cuando
           está opción está presente a menos que se ejecute explícitamente con una invocación
           adicional. Tenga en cuenta que esta opción también existe en versiones antiguas de APT
           (aunque sin documentar) con un significado diferente. Anteriormente sólo se añadía la
           opción «--no-triggers» a las invocaciones de la configuración para dpkg(1), ahora APT
           también añade esta opción a las invocaciones de desempaquetado y eliminación.

       PackageManager::Configure
           Los valores válidos son «all», «smart» y «no». El valor predeterminado es «all», que
           hace que APT configure todos los paquetes. El valor «smart» sólo configura los
           paquetes que requieren ser configurados antes de que se desempaquete otro paquete
           (predependencia) y permite que dpkg(1) configure los restantes con una invocación
           generada por la opción «ConfigurePending» (más abajo). El valor «no» no configura nada
           y depende por completo de dpkg(1) para la configuración (que fallará si se encuentra
           una pre-dependencia). Si se define esta opción con un valor distinto a «all» activa
           implícitamente la siguiente opción de forma predeterminada, ya que de otro modo el
           sistema podría terminar en un estado mal configurado qué podría derivar en la
           imposibilidad de arrancar el sistema.

       DPkg::ConfigurePending
           Si define esta opción, APT ejecutará dpkg --configure --pending para permitir a dpkg
           manejar todas las configuraciones necesarias y todos los disparadores. Esta opción se
           activa automáticamente de forma predeterminada si la opción anterior no está definida
           como all, pero desactivarla podría ser útil si se quiere ejecutar APT varias veces
           seguidas, por ejemplo: en un instalador. En estas situaciones podría desactivar esta
           opción en todas las ejecuciones menos la última.

       DPkg::TriggersPending
           Útil para una configuración smart en la que un paquete que tiene disparadores
           pendientes no se considera como instalado y que dpkg lo trata como desempaquetado, lo
           cual entra en conflicto con el sistema de pre-dependencias (véase debbugs #526774).
           Tenga en cuenta que esto procesará todos los disparadores, no sólo los disparadores
           necesarios para configurar este paquete.

       OrderList::Score::Immediate
           Los paquetes esenciales (y sus dependencias) se deberían configurar inmediatamente
           después de desempaquetarlos. Se recomienda realizarlo lo más pronto posible en el
           proceso de actualización ya que actualmente estas invocaciones de configuración
           también necesitan DPkg::TriggersPending, que ejecuta varios disparadores (que puede
           que no sean necesarios). Los esenciales tienen, de forma predeterminada, una
           puntuación alta pero la opción inmediata es relativamente baja (un paquete que tenga
           pre-dependencias tiene una puntuación más alta). Puede cambiar la puntuación mediante
           esta opción y las otras del mismo grupo. El siguiente ejemplo muestra la configuración
           con los valores predeterminados.

               OrderList::Score {
                    Delete 500;
                    Essential 200;
                    Immediate 10;
                    PreDepends 50;
               };

LAS OPCIONES «PERIODIC» Y «ARCHIVES»

       Los grupos de opciones APT::Periodic y APT::Archives configuran el comportamiento de las
       actualizaciones periódicas de apt, que se hacen mediante el script /etc/cron.daily/apt.
       Consulte la cabecera de este script para una breve documentación de estas opciones.

OPCIONES DE DEPURACIÓN

       Activar las opciones de la sección Debug:: provocará que la información de depuración se
       envíe a la salida estándar del programa que esté utilizando las bibliotecas de apt, o
       activar los modos especiales del programa que son útiles para depurar el comportamiento de
       apt. La mayoría de estas opciones no son interesantes para un usuario normal, aunque unas
       cuantas sí son:

       ·   Debug::pkgProblemResolver activa la salida de las decisiones tomadas por dist-upgrade,
           upgrade, install, remove, purge.

       ·   Debug::NoLocking desactiva todos los cerrojos de los ficheros. Esto se puede usar para
           ejecutar algunas operaciones (por ejemplo, apt-get -s install) como un usuario normal.

       ·   Debug::pkgDPkgPM muestra la línea de órdenes actual cada vez que apt invoca a dpkg(1).

       ·   Debug::IdentCdrom desactiva la inclusión de los datos de statfs en los identificadores
           de los discos ópticos.

       A continuación, se muestra la lista completa de las opciones de depuración de apt.

       Debug::Acquire::cdrom
           Muestra la información relacionada al acceso de las fuentes de cdrom://

       Debug::Acquire::ftp
           Muestra la información relacionada con la descarga de paquetes mediante FTP.

       Debug::Acquire::http
           Muestra la información relacionada con la descarga de paquetes mediante HTTP.

       Debug::Acquire::https
           Muestra la información relacionada con la descarga de paquetes mediante HTTPS.

       Debug::Acquire::gpgv
           Muestra la información relacionada con la comprobación de las firmas criptográficas
           mediante gpg.

       Debug::aptcdrom
           Muestra la información sobre el proceso de acceso a las colecciones de paquetes
           almacenadas en CD-ROM.

       Debug::BuildDeps
           Describe el proceso de resolución de dependencias de compilación en apt-get(8).

       Debug::Hashes
           Muestra los «hashes» criptográficos que generan las bibliotecas de apt.

       Debug::IdentCDROM
           No incluye la información de statfs, el número de bloques libres y usados del sistema
           de ficheros del CD-ROM, cuando se genera un identificador de un CD-ROM.

       Debug::NoLocking
           Desactiva todos los cerrojos de los ficheros. Por ejemplo, esto permitirá ejecutar dos
           instancias de “apt-get update” a la vez.

       Debug::pkgAcquire
           Registra los elementos que se añaden o se borran de la cola de descarga global.

       Debug::pkgAcquire::Auth
           Muestra los mensajes de estado y los errores relacionados con la comprobación de las
           sumas de verificación y las firmas criptográficas de los ficheros descargados.

       Debug::pkgAcquire::Diffs
           Muestra la información de la descarga y la aplicación de los diffs de la lista de
           índices de paquetes, y los errores relacionados con éstos.

       Debug::pkgAcquire::RRed
           Muestra la información relacionada con el parcheado de las listas de paquetes de apt
           cuando se descargan los diffs de los índices en lugar de los índices completos.

       Debug::pkgAcquire::Worker
           Registra todas las interacciones de los sub-procesos que están realizando descargas.

       Debug::pkgAutoRemove
           Registra los eventos relacionados con el estado «instalado automáticamente» de los
           paquetes y con la eliminación de los paquetes sin usar.

       Debug::pkgDepCache::AutoInstall
           Genera los mensajes de depuración que describen qué paquetes se están instalando
           automáticamente para resolver las dependencias. Esto corresponde al paso inicial de
           instalación automática, por ejemplo: apt-get install y no el solucionador completo de
           dependencias de apt. Consulte Debug::pkgProblemResolver.

       Debug::pkgDepCache::Marker
           Genera los mensajes de depuración que describen qué paquete se marcará como
           mantener/instalar/borrar mientras el solucionador de problemas («ProblemResolver»)
           realiza su trabajo. Cada adición o borrado puede iniciar acciones adicionales; éstas
           se muestran sangradas con dos espacios bajo la entrada original. El formato de cada
           línea es MarkKeep, MarkDelete o MarkInstall seguido de package-name <a.b.c -> d.e.f |
           x.y.z> (sección) siendo a.b.c la versión actual del paquete, d.e.f la versión
           considerada para instalar y x.y.z una versión nueva, pero no considerada para la
           instalación (por una puntuación baja). Las dos últimas se pueden omitir si no hay o si
           es la misma versión que la instalada.  sección es el nombre de la sección en la que
           aparece el paquete.

       Debug::pkgDPkgPM
           Cuando se invoca a dpkg(1) muestra la línea de órdenes exacta con la que se invocó,
           con los argumentos separados por un espacio.

       Debug::pkgDPkgProgressReporting
           Muestra todos los datos recibidos de dpkg(1) en el descriptor del fichero de estado y
           cualquier error encontrado durante el análisis.

       Debug::pkgOrderList
           Genera una traza del algoritmo que decide el orden en el que apt debería entregar los
           paquetes a dpkg(1).

       Debug::pkgPackageManager
           Muestra los mensajes de estado siguiendo los pasos realizados al invocar a dpkg(1).

       Debug::pkgPolicy
           Muestra la prioridad de cada lista de paquetes al iniciarse.

       Debug::pkgProblemResolver
           Muestra la ejecución del solucionador de dependencias (esto se aplica sólo a lo que
           ocurre cuando se encuentra un problema de dependencias complejo).

       Debug::pkgProblemResolver::ShowScores
           Muestra una lista de todos los paquetes instalados con sus puntuaciones calculadas y
           usadas por pkgProblemResolver. La descripción del paquete es la misma que la descrita
           en Debug::pkgDepCache::Marker.

       Debug::sourceList
           Muestra la información de los proveedores extraída de /etc/apt/vendors.list.

       Debug::RunScripts
           Display the external commands that are called by apt hooks. This includes e.g. the
           config options DPkg::{Pre,Post}-Invoke or APT::Update::{Pre,Post}-Invoke.

EJEMPLOS

       /usr/share/doc/apt/examples/configure-index.gz es un fichero de configuración de ejemplo
       que muestra valores de ejemplo para todas las opciones posibles.

FICHEROS

       /etc/apt/apt.conf
           Fichero de configuración de APT. Opción de configuración: Dir::Etc::Main.

       /etc/apt/apt.conf.d/
           Fragmentos del fichero de configuración de APT. Opción de configuración:
           Dir::Etc::Parts.

VÉASE TAMBIÉN

       apt-cache(8), apt-config(8), apt_preferences(5).

BUGS

       Página de errores de APT[1]. Si quiere informar de un error en APT, consulte
       /usr/share/doc/debian/bug-reporting.txt o use la orden reportbug(1).

TRADUCCIÓN

       La traducción al español la realizaron Ismael Fanlo, Carlos Mestre, Rudy Godoy, Gustavo
       Saldumbide, Javier Fernández-Sanguino y Rubén Porras Campo entre los años 2003 y 2004. La
       traducción fue actualizada por Francisco Javier Cuadrado y Omar Campagne Polaino entre los
       años 2009 y 2012 .

       Tenga en cuenta que este documento puede contener secciones sin traducir. Esto es
       intencionado para evitar perder contenido cuando la traducción no está actualizada con
       respecto al documento original.

AUTORES

       Jason Gunthorpe

       Equipo de APT

       Daniel Burrows <dburrows@debian.org>
           Documentación inicial de Debug::*.

NOTAS

        1. Página de errores de APT
           http://bugs.debian.org/src:apt