APT.CONF(5)

NAME
apt.conf - Fichero de configuración de APT

DESCRIPCIóN

apt.conf es el fichero de configuración principal del conjunto de herramientas APT, pero no es ni mucho menos donde se pueden ubicar cambios a las opciones. Por ello, todas las herramientas comparten los ficheros de configuración y también usan un analizador de línea de órdenes común para ofrecer un entorno uniforme.

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 que no tienen extensión o la extensión «conf», y que sólo contiene caracteres alfanuméricos, guiones (-), y guión bajo (_) y punto (.). De otra forma, se ignorarán silenciosamente.

    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";. El punto y coma del final y las comillas son necesarias. El valor debe estar en única línea y no hay posibilidad de concatenar cadenas. No puede incluir comillas internas. El comportamiento de barras inversas «\» y caracteres de escape dentro de un valor no está definido y no se debería usar. Un nombre de una opción debería incluir 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, cada una separada por un 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/apt.conf /usr/share/doc/apt/examples/configure-index.gz es una buena guía para entender su aspecto.

Los nombres de las opciones de configuración no diferencian mayúsculas de minúsculas. De modo que en el ejemplo anterior se podría haber usado dpkg::pre-install-pkgs.

Los nombres de las opciones de configuración son opcionales, si se define una lista como se puede ver en el ejemplo anterior de DPkg::Pre-Install-Pkgs. Si no se define un nombre, simplemente se añadirá 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 permiten dos valores 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 este caso se incluirá 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 necesitan acabar con punto y coma).

La orden #clear ofrece la única manera de borrar una lista o un ámbito completo. Reabrir un ámbito o el estilo de dos puntos dobles («::») descrito a continuación no redefinirá las entradas escritas anteriormente. Sólo las opciones se pueden redefinir asignándolas un nuevo valor, las listas y los ámbitos no se pueden redefinir, sólo eliminar.

Todas las herramientas de APT permiten la opción -o como 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. También puede añadir listas añadiendo dos puntos dobles («::») al final del nombre de la lista. (Como ya podía imaginar, no puede usar la sintaxis de los ámbitos en la línea de órdenes).

Tenga en cuenta que puede usar los dos puntos dobles («::») sólo para añadir un elemento por línea a una lista, y que no debería usarlo en combinación con la sintaxis de los ámbitos. (La sintaxis de los ámbitos inserta de forma implícita los dos puntos dobles «::»). Usando ambas sintaxis juntas causará un error en el que algunos usuarios caen: Una opción con el inusual nombre de «::» que actúa como cualquier otra opción con un nombre. Esto introduce muchos problemas; por ejemplo, un usuario que escribiese varias líneas con esta sintaxis incorrecta, con la esperanza de añadir a una lista conseguiría lo opuesto ya que sólo se usará la última asignación de esta opción «::». Las próximas versiones de APT devolverán errores y dejarán de funcionar si encuentran este fallo, así que corrija estas declaraciones ahora mientras APT no se queja explícitamente de ellos.

EL GRUPO APT

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

Arquitectura
    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ó.

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», «squeeze», «wheezy», «4.0», «5.0*». Vea también apt_preferences(5).

Ignore-Hold
    Ignora paquetes retenidos, esta opción global causa 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, hará que APT instale los paquetes esenciales e importantes tan rápido como le sea posible al instalar y/o actualizar. Esto se hace para limitar el efecto de un fallo en la ejecución de dpkg(1). Si esta opción está desactivada, APT trata los paquetes importantes del mismo modo que un paquete adicional: entre desempaquetar un paquete importante A y su configuración puede haber muchos otros desempaquetados y configuraciones. Por ejemplo, el paquete B que no tiene relación con A, pero que hace que la ejecución de dpkg falle (ya sea porque el script del mantenedor del paquete B genera un error) generará un estado del sistema en el que el paquete A está desempaquetado pero no configurado; no se garantiza el funcionamiento de cada paquete que depende de A ya que su dependencia con A no está satisfecha. El marcador de configuración inmediata se aplicará a todas las dependencias que puedan generar un problema si las dependencias, por ejemplo, forman un círculo vicioso como dependencia con la marca de configuración inmediata, lo cual lo califica casi como Pre-Dependencia. Así, en teoría es posible que APT encuentre una situación en la que es incapaz de llevar a cabo una configuración inmediata, devuelva un error y mencione esta opción para que así el usuario pueda desactivar la configuración inmediata temporalmente para llevar a cabo una vez más la instalación y/o actualización. Observe el uso de la expresión «en teoría», ya que esta situación sólo se ha visto algunas veces con versiones de distribución no estables, y causadas por dependencias incorrectas del paquete en cuestión o en un sistema ya roto. Por ello, no debería desactivar ciegamente esta opción ya que la situación mencionada anteriormente no es el único problema que la configuración inmediata puede resolver. Antes de llevar a cabo una operación grande como dist-upgrade con esta opción desactivada debería intentar un install con el paquete que APT es incapaz de configurar inmediatamente, pero asegúrese de informar del fallo a su distribución y al equipo de APT mediante el enlace a informes de fallo a continuación para que así puedan mejorar o corregir el proceso de actualización.

Force-LoopBreak
    Nunca active esta opción a menos que usted (realmente) sepa lo que está haciendo. Esto permite a APT eliminar temporalmente un paquete esencial para eliminar conflictos o bucles conflicto/pre-dependencia entre dos paquetes esenciales. EL BUCLE NO DEBERÍA EXISTIR NUNCA COMO TAL Y ES UN ERROR GRAVE. Esta opción funcionará si el paquete esencial no es ni tar, ni gzip, ni libc, ni dpkg, ni bash, ni cualquier otro del que dependan estos paquetes.

Cache-Start, Cache-Grow y Cache-Limit
    A partir de la versión 0.7.26, APT usa un fichero de caché mapeado («mapped cache file») redimensionable para almacenar la información disponible. Cache-Start actúa como una indicación del tamaño que el caché alcanzará y por ello es la cantidad de memoria que APT solicitará al iniciarse. El valor predeterminado es 20971520 bytes (~20 MB). Tenga en cuenta que esta cantidad de espacio debe estar disponible para APT, o fallará. Por ello, este valor se debería disminuir para los dispositivos con memoria restringida, mientras que se debería aumentar en sistemas con varias fuentes configuradas. Cache-Grow define en bytes, con el valor predeterminado de 1048576 (~1 MB) cuánto se aumentará el caché en el caso de que el espacio definido por Cache-Start no sea suficiente. Este valor se aplicará repetidamente hasta que el caché sea suficientemente grande para almacenar toda la información o si el caché alcanza Cache-Limit. El valor predeterminado de Cache-Limit es cero, esto es, ilimitado. Si define Cache-Grow con un valor de cero se desactivará el crecimiento automático del cache.

Build-Essential
    Define qué paquete(s) se consideran dependencias de creación esenciales.

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

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

CDROM
    La subsección CDROM controla la herramienta apt-cdrom(8), por favor, 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 gestores de URI.

Check-Valid-Until
    Opción relacionada con la seguridad, cuyo valor predeterminado de «true», ya que una validación temporal para un fichero «Release» evita ataques «longtime replay» 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 se hace, o si un valor más estricto es opcional, se puede usar la opción Max-ValidTime.

Max-ValidTime
    Los segundos que el fichero «Release» se considerará válido después de su creación. El valor predeterminado es «para siempre» (cero) si el fichero «Release» del archivo no incluye una cabecera Valid-Until. Si lo incluye, el valor predeterminado es esta fecha. La fecha del fichero «Release» o la fecha definida por la hora de creación del fichero «Release» (cabecera Date), a lo que se añaden los segundos definidos con estas opciones, se usan para comprobar si la validez de un fichero a expirado, usando la fecha más antigua de las dos anteriormente mencionadas. Se pueden definir opciones de configuración específicas al archivo añadiendo la etiqueta del archivo al nombre de la opción.

PDiffs
    Intenta descargar deltas llamados PDiffs de los ficheros «Packages» o «Sources» en lugar de descargarlos enteros. Es «true» de forma predeterminada

    Se ofrecen dos opciones secundarias para limitar el uso de «PDiffs»: FileLimit permite definir cuántos ficheros «PDiff» como máximo se descargarán para parchear un fichero. Por otra parte, SizeLimit es el porcentaje de tamaño máximo de todos los parches comparados con el tamaño del fichero 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
    Usa 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 URI, http::Proxy es el proxy http predeterminado a usar. Usa 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.

    Para los proxies que cumplen con HTTP/1.1 se proporcionan tres opciones de configuración para el control de la caché. No-Cache dice al proxy que no use sus respuestas almacenadas bajo ninguna circunstancia, Max-Age sólo se envía para los ficheros de índice y le pide a la caché que actualice sus objetos si son más antiguos que un determinado número de segundos. Debian actualiza sus ficheros de índices diariamente, por lo que el valor predeterminado es un día. No-Store especifica que la caché nunca deberá almacenar la petición, sólo está habilitada para los ficheros de los archivos de paquetes. Puede ser útil para prevenir que un proxy se contamine con ficheros «.deb» muy grandes. Aviso: Squid 2.0.2 no permite usar ninguna de estas opciones.

    La opción timeout define el tiempo máximo de espera usado por el método, esto se aplica a todo, incluyendo el tiempo de espera para realizar la conexión y para recibir datos.

    Se ofrece una opción para controlar la profundidad de la tubería en casos en que el servidor remoto no cumpla con la RFC o tenga fallos (como pasa con Squid 2.0.2). Acquire::http::Pipeline-Depth puede ser un valor entre 0 y 5, e indica cuántas peticiones sin resolver puede enviar APT. DEBE especificar si la máquina remota no retrasa apropiadamente las conexiones TCP, de otro modo los datos se corromperán. Las máquinas que necesitan esto violan la RFC 2068.

    El ancho de banda usado se puede limitar mediante Acquire::http::Dl-Limit, que acepta valores enteros en kilobytes. El valor predeterminado es cero, que desactiva el límite e intenta usar lo máximo posible del ancho de banda. (Tenga en cuenta que esta opción desactiva implícitamente la descarga simultánea desde varios servidores).

    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.

https
    HTTPS URI. Las opciones de control de «Cache», «timeout», «AllowRedirect», «Dl-Limit» y del proxy son las mismas que para el método http y de forma predeterminada tienen el valor de las opciones de http si no están explícitamente definidas para https. La opción Pipeline-Depth no se puede usar por ahora.

    La sub-opción CaInfo define el lugar del fichero que contiene la información sobre los certificados de confianza. <host>::CaInfo corresponde a la opción por máquina. La sub-opción booleana Verify-Peer define si se comprobará el certificado del servidor con los certificados de confianza. <host>::Verify-Peer corresponde a la opción por máquina. La sub-opción Verify-Host define si se comprobará el nombre del servidor. <host>::Verify-Host corresponde a la opción por máquina. SslCert define qué certificado usar para la autenticación del cliente. <host>::SslCert corresponde a la opción por máquina. SslKey define qué clave privada usar para la autenticación del cliente. <host>::SslKey corresponde a la opción por máquina. SslForceVersion cambia la versión de SSL a usar. Puede ser «TLSv1» o «SSLv3». <host>::SslForceVersion corresponde a la opción por máquina.

ftp
    FTP URI, ftp::Proxy es el proxy ftp predeterminado a usar. Usa 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é conectar. Por favor, vea /usr/share/doc/apt/examples/configure-index.gz para un ejemplo de cómo usarlo. Las variables de sustitución disponibles son $(PROXY_USER) $(PROXY_PASS) $(SITE_USER) $(SITE_PASS) $(SITE) y $(SITE_PORT), cada uno tomada de su respectivo componente de la URI.

    La opción timeout define el tiempo máximo de espera usado por el método, esto se aplica a todo, incluyendo el tiempo de espera para realizar la conexión y para recibir datos.

    Puede controlar el modo pasivo a través de varias opciones. Generalmente 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 (vea el fichero de configuración de muestra para ver algunos ejemplos).

    Es posible usar un proxy FTP a través de HTTP definiendo la variable de entorno ftp_proxy con una dirección http. Consulte la discusión anterior del método http para la sintaxis. No puede definir esto 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
    CDROM URI, la única opción de configuración para las URI de CDROM es el punto de montaje. cdrom::Mount debe ser el punto de montaje de la unidad de CDROM tal y como se especifica en /etc/fstab. Es posible proporcionar órdenes «mount» y «unmount» alternativas si el punto de montaje no se puede especificar en el fichero fstab (como con SMB y versiones antiguas de mount). La sintaxis consiste en insertar

        /cdrom/::Mount "algo";

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

gpgv
    GPGV URI, la única opción para las URI de GPGV es la entrega de parámetros adicionales a gpgv. gpgv::Options Parámetros adicionales introducidos 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 no se añaden, ya que se añaden durante la ejecución 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 prefieren los comprimidos con lzma antes que con 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 ya que se añadirá de forma automática.

    Tenga en cuenta que durante la ejecución se comprobará la opción Dir::Bin::nombre-del-método. Si esta opción existe, el método sólo se usará si este fichero existe. Por ejemplo: para el método bzip2 (incorporado de serie) la opción es

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

    También tenga en cuenta que las entradas de la lista definida 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 predeterminadas. Para usar un tipo preferido, en este caso antes que otros definidos en los ficheros de configuración, puede definir la opción directamente (no en el formato de lista). Esto no sobrescribirá la lista definida, sólo añadirá este tipo al principio de la lista.

    Aunque es posible añadir un tipo de compresión vacío a la lista, la versión actual de APT no lo entiende correctamente y mostrará muchos avisos sobre ficheros no descargados (la mayoría de estos avisos son falsos negativos). Puede que las próximas versiones incluyan una forma de poder usar ficheros sin comprimir de modo que se permita el uso de 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 definir 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), por lo que debería informarse de cuales están disponibles antes de definir valores imposibles.

    La lista predeterminada incluye «environment» y «en». «environment» tiene un significado especial aquí; se reemplazará durante la ejecución con los códigos de idioma extraídos de la variable de entorno LC_MESSAGES. También se asegurará de que estos códigos no se incluyan dos veces en la lista. Si LC_MESSAGES está definida como «C» sólo se usará el fichero Translation-en (si está disponible). Puede usar la opción Acquire::Languages=none para forzar apt a que no use ficheros «Translation» . «none» es otro código especial que significa que detendrá la búsqueda de un fichero Translation adecuado. El administrador del sistema puede usar esto para permitir que APT sepa que debería descargar estos ficheros sin tener que usarlos si no se definen con «environment». De modo que el siguiente ejemplo de configuración resultará en el orden «en, de» en una configuración regional inglesa y «de, en» en una configuración regional alemana. Tenga en cuenta que «fr» se descargará, pero no se usará si APT no se usa con una configuración regional francesa, de modo que la orden en este entorno («environment») sería «fr, de, en».

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

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. preferences es el nombre del fichero de 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 en blanco. Ésto hará que el arranque sea más lento, pero ahorrará espacio. Normalmente se prefiere deshabilitar pkgcache en vez 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, este valor puede ser «always», «prompt», «auto», «pre-auto» y «never». Los valores «always» y «prompt» borrarán todos los paquetes del almacén después de actualizar, «prompt» (el valor predeterminado) preguntará primero. El valor «auto» borrará sólo aquellos paquetes que ya no se pueden descargar (por ejemplo, los reemplazados por otra versión). El valor «pre-auto» realiza esta última acción antes de descargar los paquetes nuevos.

Opciones
    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.

CóMO INVOCA APT A DPKG

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

Opciones
    Es una lista de opciones que se introducen a dpkg. 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, y APT finalizará en caso de fallo.

Pre-Install-Pkgs
    Es una lista de órdenes de la consola que se ejecutarán antes de invocar a dpkg(1). Como options, se debe especificar con notación de lista. Las órdenes se ejecutan en orden usando /bin/sh, y APT finalizará en caso de fallo. APT introducirá las órdenes, por la entrada estándar, de los nombres de fichero de todos los «.deb» que va a instalar, uno por línea.

    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 y de los paquetes, los ficheros y las versiones que cambian. La versión 2 se habilita definiendo DPkg::Tools::Options::cmd::Version con el valor 2. cmd es una orden que se pasa a Pre-Install-Pkgs.

Run-Directory
    APT cambia a este directorio antes de invocar a dpkg, 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 a dpkg de forma que pueda hacer un uso agresivo de los disparadores mediante varias invocaciones a dpkg. Sin más opciones, dpkg usará los disparadores sólo en su propia ejecución. Activar estas opciones puede reducir el tiempo necesario para realizar la instalación o la actualización. Tenga en cuenta que está orientado a que estas opciones se activen de forma predeterminada en un futuro, necesita muchas pruebas pero la forma en que APT invoca a dpkg ha cambiado drásticamente. Estas opciones actualmente son experimentales, y no se deberían usar en entornos de producción. También rompe el informe del progreso ya que todas las interfaces estarán alrededor de la mitad (o más) del tiempo en el 100% mientras se están configurando 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 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 llamadas a dpkg la opción sin disparadores («no triggers»), excepto a la llamada a «ConfigurePending». Consulte dpkg(1) si está interesado en saber qué significa esto. De forma breve: dpkg no ejecutará los disparadores cuando está opción esté presente a menos que se ejecute explícitamente en una llamada 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 llamadas de la configuración para dpkg, ahora apt también añadirá esta opción a las llamadas de desempaquetado y borrado.

PackageManager::Configure
    Los valores válidos son «all», «smart» y «no». «all» es el valor predeterminado y hace que APT configure todos los paquetes de forma explícita. El valor «smart» sólo configura los paquetes que necesiten ser configurados antes de que otro paquete se desempaquete (pre-dependencia) y permite que dpkg configure los restantes con una llamada generada por la siguiente opción. El valor «no» no configurará nada y dependerá totalmente de dpkg para la configuración (que fallará si se encuentra una pre-dependencia). Definir esta opción a otro valor distinto a «all» activará 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 rompe 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.

PackageManager::UnpackAll
    Ya que la configuración se puede aplazar para que dpkg la haga al final se puede intentar ordenar las series de desempaquetado por necesidades críticas, por ejemplo, mediante pre-dependencias. De forma predeterminada, es «true» y por tanto se usa el método «antiguo» de ordenación en varios pasos para todo. Mientras ambos métodos estén presentes en versiones anteriores de APT, el método OrderCritical no se usará, ya que este método es experimental y necesita más mejoras antes de llegar a ser realmente útil.

OrderList::Score::Immediate
    Los paquetes esenciales (y sus dependencias) se deberían configurar inmediatamente después de desempaquetarlos. Es una buena idea hacerlo lo más pronto posible en el proceso de actualización ya que actualmente estas llamadas de configuración también necesitan DPkg::TriggersPending, que ejecutará unos pocos 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 CDROM.

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. Véase 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::pkgInitConfig
    Vuelca la configuración predeterminada a la salida estándar durante al iniciarse.

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.

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 2010.

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.

AUTHORS

Jason Gunthorpe

Equipo de APT

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

NOTES

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