Provided by: apt_1.2.35_amd64 
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