APT.CONF(5)

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. all options set in the binary specific configuration subtree are moved into the root of the tree.

    5. 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», «jessie», «stretch», «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
    Security related option defaulting to true, as giving a Release file's validation an expiration date prevents replay attacks over a long timescale, and can also for example help users to identify mirrors that are no longer updated - but the feature depends on the correctness of the clock on the user system. Archive maintainers are encouraged to create Release files with the Valid-Until header, but if they don't or a stricter value is desired the Max-ValidTime option below can be used. The Check-Valid-Until option of sources.list(5) entries should be preferred to disable the check selectively instead of using this global override.

Max-ValidTime
    Maximum time (in seconds) after its creation (as indicated by the Date header) that the Release file should be considered valid. If the Release file itself includes a Valid-Until header the earlier date of the two is used as the expiration date. The default value is 0 which stands for "valid forever". Archive specific settings can be made by appending the label of the archive to the option name. Preferably, the same can be achieved for specific sources.list(5) entries by using the Valid-Until-Max option there.

Min-ValidTime
    Minimum time (in seconds) after its creation (as indicated by the Date header) that the Release file should be considered valid. Use this if you need to use a seldom updated (local) mirror of a more frequently updated archive with a Valid-Until header instead of completely disabling the expiration date checking. Archive specific settings can and should be used by appending the label of the archive to the option name. Preferably, the same can be achieved for specific sources.list(5) entries by using the Valid-Until-Min option there.

PDiffs
    Try to download deltas called PDiffs for indexes (like Packages files) instead of downloading whole ones. True by default. Preferably, this can be set for specific sources.list(5) entries or index files by using the PDiffs option there.

    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.

By-Hash
    Try to download indexes via an URI constructed from a hashsum of the expected file rather than downloaded via a well-known stable filename. True by default, but automatically disabled if the source indicates no support for it. Usage can be forced with the special value "force". Preferably, this can be set for specific sources.list(5) entries or index files by using the By-Hash option there.

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.

    The setting Acquire::http::Pipeline-Depth can be used to enable HTTP pipelining (RFC 2616 section 8.1.2.2) which can be beneficial e.g. on high-latency connections. It specifies how many requests are sent in a pipeline. APT tries to detect and workaround misbehaving webservers and proxies at runtime, but if you know that yours does not conform to the HTTP/1.1 specification pipelining can be disabled by setting the value to 0. It is enabled by default with the value 10.

    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.

MaxReleaseFileSize
    The maximum file size of Release/Release.gpg/InRelease files. The default is 10MB.

EnableSrvRecords
    This option controls if apt will use the DNS SRV server record as specified in RFC 2782 to select an alternative server to connect to. The default is "true".

AllowInsecureRepositories
    Allow the update operation to load data files from a repository without a trusted signature. If enabled this option no data files will be loaded and the update operation fails with a error for this source. The default is false for backward compatibility. This will be changed in the future.

AllowDowngradeToInsecureRepositories
    Allow that a repository that was previously gpg signed to become unsigned durign a update operation. When there is no valid signature of a perviously trusted repository apt will refuse the update. This option can be used to override this protection. You almost certainly never want to enable this. The default is false. Note that apt will still consider packages from this source untrusted and warn about them if you try to install them.

Changelogs::URI scope
    Acquiring changelogs can only be done if an URI is known from where to get them. Preferable the Release file indicates this in a 'Changelogs' field. If this isn't available the Label/Origin field of the Release file is used to check if a Acquire::Changelogs::URI::Label::LABEL or Acquire::Changelogs::URI::Origin::ORIGIN option exists and if so this value is taken. The value in the Release file can be overridden with Acquire::Changelogs::URI::Override::Label::LABEL or Acquire::Changelogs::URI::Override::Origin::ORIGIN. The value should be a normal URI to a text file, except that package specific data is replaced with the placeholder @CHANGEPATH@. The value for it is: 1. if the package is from a component (e.g. main) this is the first part otherwise it is omitted, 2. the first letter of source package name, except if the source package name starts with 'lib' in which case it will be the first four letters. 3. The complete source package name. 4. the complete name again and 5. the source version. The first (if present), second, third and fourth part are separated by a slash ('/') and between the fourth and fifth part is an underscore ('_'). The special value 'no' is available for this option indicating that this source can't be used to acquire changelog files from. Another source will be tried if available in this case.

BINARY SPECIFIC CONFIGURATION

Especially with the introduction of the apt binary it can be useful to set certain options only for a specific binary as even options which look like they would effect only a certain binary like APT::Get::Show-Versions effect apt-get as well as apt.

Setting an option for a specific binary only can be achieved by setting the option inside the Binary::specific-binary scope. Setting the option APT::Get::Show-Versions for the apt only can e.g. by done by setting Binary::apt::APT::Get::Show-Versions instead.

Note that as seen in the DESCRIPTION section further above you can't set binary-specific options on the commandline itself nor in configuration files loaded via the commandline.

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 contains locations pertaining to local cache information, such as the two package caches srcpkgcache and pkgcache as well as the location to place downloaded archives, Dir::Cache::archives. Generation of caches can be turned off by setting pkgcache or srcpkgcache to "". This will slow down startup but save disk space. It is probably preferable to turn off the pkgcache rather than the srcpkgcache. Like Dir::State the default directory is contained in 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.

The configuration item RootDir has a special meaning. If set, all paths will be relative to RootDir, even paths that are specified absolutely. So, for instance, if RootDir is set to /tmp/staging and Dir::State::status is set to /var/lib/dpkg/status, then the status file will be looked up in /tmp/staging/var/lib/dpkg/status. If you want to prefix only relative paths, set Dir instead.

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 sends more information through the requested file descriptor: a line with the text VERSION 2, the APT configuration space, and a list of package actions with filename and version information.

    Each configuration directive line has the form key=value. Special characters (equal signs, newlines, nonprintable characters, quotation marks, and percent signs in key and newlines, nonprintable characters, and percent signs in value) are %-encoded. Lists are represented by multiple key::=value lines with the same key. The configuration section ends with a blank line.

    Package action lines consist of five fields in Version 2: package name (without architecture qualification even if foreign), old version, direction of version change (< for upgrades, > for downgrades, = for no change), new version, action. The version fields are "-" for no version at all (for example when installing a package for the first time; no version is treated as earlier than any real version, so that is an upgrade, indicated as - < 1.23.4). The action field is "**CONFIGURE**" if the package is being configured, "**REMOVE**" if it is being removed, or the filename of a .deb file if it is being unpacked.

    In Version 3 after each version field follows the architecture of this version, which is "-" if there is no version, and a field showing the MultiArch type "same", "foreign", "allowed" or "none". Note that "none" is an incorrect typename which is just kept to remain compatible, it should be read as "no" and users are encouraged to support both.

    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