APT.CONF(5)

NAME
apt.conf - Fichier de configuration pour APT

DESCRIPTION

Le fichier apt.conf est le principal fichier de configuration de la collection d'outils que constitue APT ; tous les outils font appel à ce fichier de configuration et utilisent un analyseur syntaxique en ligne de commande commun afin de fournir un environnement uniforme. Quand un outil d'APT démarre, il lit la configuration désignée par variable d'environnement APT_CONFIG (si elle existe), puis il lit les fichiers situés dans Dir::Etc::Parts ainsi que le principal fichier de configuration indiqué par Dir::Etc::main ; enfin il applique les options de la ligne de commande qui prévalent sur les directives de configuration, chargeant si nécessaire d'autres fichiers de configuration.

Le fichier de configuration est construit comme un arbre d'options organisées en groupes fonctionnels. On se sert du double deux points (« :: ») pour indiquer une option ; par exemple, APT::Get::Assume-Yes est une option pour le groupe d'outils APT, destinée à l'outil Get. Il n'y a pas d'héritage des options des groupes parents.

Syntaxiquement, le langage de configuration est conçu sur le même modèle que les langages utilisés par des outils ISC tels que bind et dhcp. Une ligne qui commence par // est traitée comme un commentaire et ignorée, de même que les sections de texte placées entre /* et */, tout comme les commentaires C/C++. Chaque ligne est de la forme : APT::Get::Assume-Yes "true"; Le point-virgule final est obligatoire et les guillemets sont optionnels. La valeur doit tenir sur une seule ligne et il n'existe pas de fusion de chaînes. Elle ne doit pas comporter de guillemets . Le comportement du caractère barre oblique inversée "\" et les caractères utilisés avec séquence d'échappement dans ue valeur ne sont pas déterministes et devraient être évités. Le nom d'une option peut contenir des caractères alphanumériques et « /-:._+ ». On peut déclarer un nouveau champ d'action avec des accolades, comme suit :

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

avec des retours à la ligne pour faciliter la lecture. On peut créer une liste en ouvrant un champ d'action et en y insérant une chaîne entre guillemets suivie d'un point virgule pour chaque élément de la liste.

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

Les modèles /usr/share/doc/apt/examples/apt.conf et /usr/share/doc/apt/examples/configure-index.gz montrent à quoi devrait ressembler le fichier de configuration.

Les identifiants des options de configuration ne sont pas sensibles à la casse. Dans l'exemple précédent, on pourrait donc aussi bien utiliser dpkg::pre-install-pkgs.

Les noms des éléments de configuration sont optionnels si une liste est définie, comme cela peut se voir avec l'exemple DPkg::Pre-Install-Pkgs précédent. Si vous n'indiquez pas de nom, une nouvelle entrée ajoutera une nouvelle option à la liste. Dans le cas contraire, l'option correspondante peut être remplacée, comme toute autre option, en lui réaffectant une valeur.

Two specials are allowed, #include (which is deprecated and not supported by alternative implementations) and #clear: #include will include the given file, unless the filename ends in a slash, then the whole directory is included. #clear is used to erase a part of the configuration tree. The specified element and all its descendants are erased. (Note that these lines also need to end with a semicolon.)

The #clear command is the only way to delete a list or a complete scope. Reopening a scope or the ::-style described below will not override previously written entries. Only options can be overridden by addressing a new value to it - lists and scopes can't be overridden, only cleared.

All of the APT tools take a -o option which allows an arbitrary configuration directive to be specified on the command line. The syntax is a full option name (APT::Get::Assume-Yes for instance) followed by an equals sign then the new value of the option. Lists can be appended too by adding a trailing :: to the list name. (As you might suspect: The scope syntax can't be used on the command line.)

Note that you can use :: only for appending one item per line to a list and that you should not use it in combination with the scope syntax. (The scope syntax implicit insert ::) Using both syntaxes together will trigger a bug which some users unfortunately relay on: An option with the unusual name "::" which acts like every other option with a name. These introduces many problems including that a user who writes multiple lines in this wrong syntax in the hope to append to a list will gain the opposite as only the last assignment for this option "::" will be used. Upcoming APT versions will raise errors and will stop working if they encounter this misuse, so please correct such statements now as long as APT doesn't complain explicit about them.

LE GROUPE APT

Ce groupe d'options contrôle le comportement global d'APT et contient également des options communes à tous les outils.

Architecture
    L'architecture du système ; cette option positionne l'architecture à utiliser pour récupérer des fichiers et analyser des listes de paquets. La valeur interne par défaut est l'architecture pour laquelle APT a été compilé.

Default-Release
    Indique la distribution à utiliser par défaut lors de l'installation d'un paquet si plusieurs versions sont disponibles. La valeur peut être un nom de distribution ou un numéro de version. Exemples : « stable », « testing », « 4.0 », « 5.0* ». Voir aussi apt_preferences(5).

Ignore-Hold
    Ignore les paquets « gelés » ; cette option globale indique au système de résolution de ne pas tenir compte des paquets « gelés » dans sa prise de décision.

Clean-Installed
    Avec cette option qui est activée par défaut, la fonctionnalité « autoclean » supprime du cache tout paquet qui ne peut plus être récupéré. Quand cette option est désactivée, les paquets qui sont installés localement sont aussi exclus du nettoyage - mais notez que APT ne fournit aucun moyen direct pour les réinstaller.

Immediate-Configure
    Defaults to on which will cause APT to install essential and important packages as fast as possible in the install/upgrade operation. This is done to limit the effect of a failing dpkg(1) call: If this option is disabled APT does treat an important package in the same way as an extra package: Between the unpacking of the important package A and his configuration can then be many other unpack or configuration calls, e.g. for package B which has no relation to A, but causes the dpkg call to fail (e.g. because maintainer script of package B generates an error) which results in a system state in which package A is unpacked but unconfigured - each package depending on A is now no longer guaranteed to work as their dependency on A is not longer satisfied. The immediate configuration marker is also applied to all dependencies which can generate a problem if the dependencies e.g. form a circle as a dependency with the immediate flag is comparable with a Pre-Dependency. So in theory it is possible that APT encounters a situation in which it is unable to perform immediate configuration, error out and refers to this option so the user can deactivate the immediate configuration temporary to be able to perform an install/upgrade again. Note the use of the word "theory" here as this problem was only encountered by now in real world a few times in non-stable distribution versions and caused by wrong dependencies of the package in question or by a system in an already broken state, so you should not blindly disable this option as the mentioned scenario above is not the only problem immediate configuration can help to prevent in the first place. Before a big operation like dist-upgrade is run with this option disabled it should be tried to explicitly install the package APT is unable to configure immediately, but please make sure to report your problem also to your distribution and to the APT team with the buglink below so they can work on improving or correcting the upgrade process.

Force-LoopBreak
    Ne jamais activer cette option à moins que vous ne sachiez - réellement - ce que vous faites. Elle autorise APT à supprimer temporairement un paquet essentiel pour mettre fin à une boucle Conflicts / Conflicts ou Conflicts / Pre-Depends entre deux paquets essentiels. UNE TELLE BOUCLE NE DOIT JAMAIS SE PRODUIRE : C'EST UN BOGUE SÉRIEUX. Cette option fonctionne si les paquets essentiels ne sont pas tar, gzip, libc, dpkg, bash ou tous les paquets dont ces paquets dépendent.

Cache-Limit
    APT utilise un fichier de cache chargé en mémoire avec mmap pour ranger les informations sur les paquets disponibles. Cette option fixe la taille mémoire allouée pour le chargement de ce cache.

Build-Essential
    Cette option définit les paquets qui sont considérés comme faisant partie des dépendances essentielles pour la construction de paquets.

Get
    La sous-section Get contrôle l'outil apt-get(8), veuillez consulter sa documentation pour avoir plus d'informations sur les options en question.

Cache
    La sous-section Cache contrôle l'outil apt-cache(8), veuillez consulter sa documentation pour avoir plus d'informations sur les options en question.

CDROM
    La sous-section CDROM contrôle l'outil apt-cdrom(8), veuillez consulter sa documentation pour avoir plus d'informations sur les options en question.

LE GROUPE ACQUIRE

Le groupe d'options Acquire contrôle le téléchargement des paquets et les gestionnaires d'URI.

PDiffs
    Essayer de télécharger les fichiers différentiels appelés PDiffs pour les paquets ou les fichiers sources, plutôt que de les télécharger entièrement. Par défaut à « true ».

Queue-Mode
    Mode de file d'attente ; Queue-Mode peut prendre les valeurs host ou access et cela détermine comment APT parallélise les connexions sortantes. Host signifie qu'une connexion par cible sera initiée, tandis que access signifie qu'une connexion par type d'URI sera initiée.

Retries
    Nombre d'essais à effectuer. Si ce nombre n'est pas nul, APT essaie de récupérer, le nombre donné de fois, les fichiers dont la récupération a échoué.

Source-Symlinks
    Utilise des liens symboliques pour les archives de sources. Positionnée à « true », cette option crée si possible des liens symboliques vers les archives de sources au lieu de les copier. Par défaut à « true ».

http
    HTTP URIs; http::Proxy is the default http proxy to use. It is in the standard form of http://[[user][:pass]@]host[:port]/. Per host proxies can also be specified by using the form http::Proxy::<host> with the special keyword DIRECT meaning to use no proxies. If no one of the above settings is specified, http_proxy environment variable will be used.

    Trois options de configuration sont fournies pour le contrôle des caches compatibles avec HTTP/1.1. No-Cache signifie que le mandataire ne doit jamais utiliser les réponses qu'il a stockées ; Max-Age sert uniquement pour les fichiers d'index : cela demande au cache de les mettre à jour quand leur ancienneté est supérieure au nombre de secondes donné. Debian met à jour ses fichiers d'index de manière quotidienne ; la valeur par défaut est donc de 1 jour. No-Store sert uniquement pour les fichiers d'archive et demande au cache de ne jamais garder la requête. Cela peut éviter de polluer un cache mandataire avec des fichiers .deb très grands. Note : Squid 2.0.2 ne prend en compte aucune de ces options.

    L'option timeout positionne le compteur de temps mort (timeout) utilisé par la méthode. Cela vaut pour tout, connexion et données.

    One setting is provided to control the pipeline depth in cases where the remote server is not RFC conforming or buggy (such as Squid 2.0.2). Acquire::http::Pipeline-Depth can be a value from 0 to 5 indicating how many outstanding requests APT should send. A value of zero MUST be specified if the remote host does not properly linger on TCP connections - otherwise data corruption will occur. Hosts which require this are in violation of RFC 2068.

    The used bandwidth can be limited with Acquire::http::Dl-Limit which accepts integer values in kilobyte. The default value is 0 which deactivates the limit and tries uses as much as possible of the bandwidth (Note that this option implicit deactivates the download from multiple servers at the same time.)

    Acquire::http::User-Agent can be used to set a different User-Agent for the http download method as some proxies allow access for clients only if the client uses a known identifier.

https
    HTTPS URIs. Cache-control, Timeout, AllowRedirect, Dl-Limit and proxy options are the same as for http method and will also default to the options from the http method if they are not explicitly set for https. Pipeline-Depth option is not supported yet.

    La sous-option CaInfo spécifie le fichier contenant les informations sur les certificats de confiance. La sous-option booléenne Verify-Peer précise si le certificat d'hôte du serveur doit être confronté aux certificats de confiance ou pas. La sous-option booléenne Verify-Host précise s'il faut vérifier ou pas le nom d'hôte du serveur. SslCert détermine le certificat à utiliser pour l'authentification du client. SslKey détermine quelle clef privée doit être utilisée pour l'authentification du client. SslForceVersion surcharge la valeur par défaut pour la version de SSL à utiliser et peut contenir l'une des chaînes 'TLSv1' ou 'SSLv3'.

ftp
    FTP URIs; ftp::Proxy is the default ftp proxy to use. It is in the standard form of ftp://[[user][:pass]@]host[:port]/. Per host proxies can also be specified by using the form ftp::Proxy::<host> with the special keyword DIRECT meaning to use no proxies. If no one of the above settings is specified, ftp_proxy environment variable will be used. To use a ftp proxy you will have to set the ftp::ProxyLogin script in the configuration file. This entry specifies the commands to send to tell the proxy server what to connect to. Please see /usr/share/doc/apt/examples/configure-index.gz for an example of how to do this. The substitution variables available are $(PROXY_USER) $(PROXY_PASS) $(SITE_USER) $(SITE_PASS) $(SITE) and $(SITE_PORT) Each is taken from it's respective URI component.

    L'option timeout positionne le compteur de temps mort (timeout) utilisé par la méthode. Cela vaut pour tout, connexion et données.

    Plusieurs options de configuration sont fournies pour contrôler le mode passif. Il est généralement plus sûr d'activer le mode passif et cela marche dans presque tous les environnements. Cependant, certaines situations nécessitent que le mode passif soit désactivé et que le mode « port » de ftp soit utilisé à la place. On peut le faire globalement, pour des connexions qui passent par un mandataire ou pour une machine spécifique (examinez le modèle de fichier de configuration).

    Il est possible de faire transiter le trafic FTP par un mandataire HTTP en positionnant la variable d'environnement ftp_proxy à une URL HTTP -- consultez la méthode http ci-dessus pour la syntaxe. On ne peut pas le faire dans le fichier de configuration et il n'est de toute façon pas recommandé d'utiliser FTP au travers de HTTP en raison la faible efficacité de cette méthode.

    L'option ForceExtended contrôle l'utilisation des commandes liées à la RFC 2428, EPSV et EPRT. Par défaut, elle vaut « false » ce qui signifie que ces commandes ne sont utilisées que pour une connexion de type IPv6. Quand elle vaut « true », on les utilise même si la connexion est de type IPv4. La plupart des serveurs FTP ne suivent pas la RFC 2428.

cdrom
    URI CD ; la seule option de configuration pour les URI de CD est le point de montage : cdrom::Mount ; il doit représenter le point de montage du lecteur de CD-ROM indiqué dans /etc/fstab. On peut fournir d'autres commandes de montage et de démontage quand le point de montage ne peut être listé dans le fichier /etc/fstab (par exemple, un montage SMB). Syntaxiquement, il faut placer

        /cdrom/::Mount "foo";

    dans le bloc cdrom. La barre oblique finale est importante. Les commandes de démontage peuvent être spécifiées en utilisant UMount.

gpgv
    URI GPGV ; la seule option pour les URI GPGV est celle qui permet de passer des paramètres à gpgv. gpgv::Options : options supplémentaires passées à gpgv.

CompressionTypes
    List of compression types which are understood by the acquire methods. Files like Packages can be available in various compression formats. Per default the acquire methods can decompress bzip2, lzma and gzip compressed files, with this setting more formats can be added on the fly or the used method can be changed. The syntax for this is:

        Acquire::CompressionTypes::FileExtension "Methodname";

    Also the Order subgroup can be used to define in which order the acquire system will try to download the compressed files. The acquire system will try the first and proceed with the next compression type in this list on error, so to prefer one over the other type simple add the preferred type at first - not already added default types will be added at run time to the end of the list, so e.g.

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

    can be used to prefer gzip compressed files over bzip2 and lzma. If lzma should be preferred over gzip and bzip2 the configure setting should look like this

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

    It is not needed to add bz2 explicit to the list as it will be added automatic.

    Note that at run time the Dir::Bin::Methodname will be checked: If this setting exists the method will only be used if this file exists, e.g. for the bzip2 method (the inbuilt) setting is

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

    Note also that list entries specified on the command line will be added at the end of the list specified in the configuration files, but before the default entries. To prefer a type in this case over the ones specified in in the configuration files you can set the option direct - not in list style. This will not override the defined list, it will only prefix the list with this type.

    While it is possible to add an empty compression type to the order list, but APT in its current version doesn't understand it correctly and will display many warnings about not downloaded files - these warnings are most of the time false negatives. Future versions will maybe include a way to really prefer uncompressed files to support the usage of local mirrors.

LES RéPERTOIRES

Les répertoires de la section Dir::State concernent le système local. lists est le répertoire où placer les listes de paquets téléchargés et status est le nom du fichier d'état de dpkg(1). preferences concerne APT : c'est le nom du fichier des préférences. Dir::State contient le répertoire par défaut préfixé à tous les sous-éléments, quand ceux-ci ne commencent pas par / ou ./.

Dir::Cache contient les emplacements qui renseignent sur le cache local : par exemple, les deux caches de paquets srcpkgcache et pkgcache, et aussi l'endroit où sont placées les archives téléchargées, Dir::Cache::archives. On peut empêcher la création des caches en saisissant un nom vide. Cela ralentit le démarrage mais sauve de l'espace disque. Il vaut mieux se passer du cache pkgcache plutôt que se passer du cache srcpkgcache. Comme pour Dir::State, le répertoire par défaut est contenu dans Dir::Cache.

Dir::Etc contient l'emplacement des fichiers de configuration, sourcelist indique l'emplacement de la liste de sources et main est le fichier de configuration par défaut (le modifier n'a aucun effet, à moins qu'on ne le modifie avec le fichier de configuration indiqué par la variable APT_CONFIG).

Dir::Parts lit, par ordre d'entrée, tous les fragments de configuration dans le répertoire indiqué. Ensuite, le fichier principal de configuration est chargé.

Binary programs are pointed to by Dir::Bin. Dir::Bin::Methods specifies the location of the method handlers and gzip, bzip2, lzma, dpkg, apt-get dpkg-source dpkg-buildpackage and apt-cache specify the location of the respective programs.

L'option de configuration RootDir a une signification particulière. Lorsqu'elle est définie, tous les chemins déclarés dans Dir:: sont considérés relativement à RootDir, même les chemins spécifiés de manière absolue. Ainsi par exemple si RootDir est défini comme /tmp/staging, et que chemin du fichier d'état Dir::State::status est déclaré comme /var/lib/dpkg/status alors ce fichier sera cherché dans /tmp/staging/var/lib/dpkg/status.

APT ET DSELECT

Quand APT est utilisé comme une méthode de dselect(1), plusieurs directives contrôlent le comportement par défaut. On les trouve dans la section DSelect.

Clean
    Mode de nettoyage du cache ; cette variable peut prendre l'une des valeurs suivantes : « always », « prompt », « auto », « pre-auto » et « never ». « always » et « prompt » suppriment tous les paquets du cache après la mise à niveau ; « prompt » (valeur par défaut) les supprime après une demande et « auto » ne supprime que les archives qui ne peuvent plus être téléchargées (remplacées, par exemple, par une nouvelle version). « pre-auto » les supprime avant de récupérer de nouveaux paquets.

options
    Le contenu de cette variable est passé comme options de ligne de commande à apt-get(8) lors de la phase d'installation.

UpdateOptions
    Le contenu de cette variable est passé comme options de ligne de commande à apt-get(8) lors de la phase de mise à jour.

PromptAfterUpdate
    Si cette option est « true », l'opération [U]pdate de dselect(1) interroge toujours l'utilisateur avant de continuer. Par défaut, ce n'est qu'en cas d'erreur que l'on propose à l'utilisateur d'intervenir.

MéTHODE D'APPEL DE DPKG(1) PAR APT

Plusieurs directives de configuration contrôlent la manière dont APT invoque dpkg(1) : elles figurent dans la section DPkg.

options
    Il s'agit d'une liste d'options à passer à dpkg(1). Les options doivent être déclarées en utilisant la notation de liste et chaque élément de la liste est passé comme un seul paramètre à dpkg(1).

Pre-Invoke, Post-Invoke
    Il s'agit d'une liste de commandes shell à exécuter avant ou après l'appel de dpkg(1). Tout comme pour Options, on doit utiliser la notation de liste. Les commandes sont appelées dans l'ordre, en utilisant /bin/sh : APT s'arrête dès que l'une d'elles échoue.

Pre-Install-Pkgs
    Il s'agit d'une liste de commandes shell à exécuter avant d'appeler dpkg(1). Tout comme pour Options, on doit utiliser la notation de liste. Les commandes sont appelées dans l'ordre, en utilisant /bin/sh : APT s'arrête dès que l'une d'elles échoue. Sur l'entrée standard, APT transmet aux commandes les noms de tous les fichiers .deb qu'il va installer, à raison d'un par ligne.

    La deuxième version de ce protocole donne plus de renseignements : on obtient la version du protocole, la configuration de APT et les paquets, fichiers ou versions qui ont changé. On autorise cette version en positionnant DPkg::Tools::Options::cmd::Version à 2. cmd est une commande passée à Pre-Install-Pkgs.

Run-Directory
    APT se place dans ce répertoire avant d'appeler dpkg(1) ; par défaut, c'est le répertoire /.

Build-options
    Ces options sont passées à dpkg-buildpackage(1) lors de la compilation des paquets ; par défaut la signature est désactivée et tous les binaires sont créés.

  dpkg trigger usage (and related options)

APT can call dpkg in a way so it can make aggressive use of triggers over multiply calls of dpkg. Without further options dpkg will use triggers only in between his own run. Activating these options can therefore decrease the time needed to perform the install / upgrade. Note that it is intended to activate these options per default in the future, but as it changes the way APT calling dpkg drastically it needs a lot more testing. These options are therefore currently experimental and should not be used in productive environments. Also it breaks the progress reporting so all frontends will currently stay around half (or more) of the time in the 100% state while it actually configures all packages.

Note that it is not guaranteed that APT will support these options or that these options will not cause (big) trouble in the future. If you have understand the current risks and problems with these options, but are brave enough to help testing them create a new configuration file and test a combination of options. Please report any bugs, problems and improvements you encounter and make sure to note which options you have used in your reports. Asking dpkg for help could also be useful for debugging proposes, see e.g. dpkg --audit. A defensive option combination would be

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

DPkg::NoTriggers
    Add the no triggers flag to all dpkg calls (except the ConfigurePending call). See dpkg(1) if you are interested in what this actually means. In short: dpkg will not run the triggers when this flag is present unless it is explicitly called to do so in an extra call. Note that this option exists (undocumented) also in older apt versions with a slightly different meaning: Previously these option only append --no-triggers to the configure calls to dpkg - now apt will add these flag also to the unpack and remove calls.

PackageManager::Configure
    Valid values are "all", "smart" and "no". "all" is the default value and causes APT to configure all packages explicit. The "smart" way is it to configure only packages which need to be configured before another package can be unpacked (Pre-Depends) and let the rest configure by dpkg with a call generated by the next option. "no" on the other hand will not configure anything and totally rely on dpkg for configuration (which will at the moment fail if a Pre-Depends is encountered). Setting this option to another than the all value will implicitly activate also the next option per default as otherwise the system could end in an unconfigured status which could be unbootable!

DPkg::ConfigurePending
    If this option is set apt will call dpkg --configure --pending to let dpkg handle all required configurations and triggers. This option is activated automatic per default if the previous option is not set to all, but deactivating could be useful if you want to run APT multiple times in a row - e.g. in an installer. In these sceneries you could deactivate this option in all but the last run.

DPkg::TriggersPending
    Useful for smart configuration as a package which has pending triggers is not considered as installed and dpkg treats them as unpacked currently which is a dealbreaker for Pre-Dependencies (see debbugs #526774). Note that this will process all triggers, not only the triggers needed to configure this package.

PackageManager::UnpackAll
    As the configuration can be deferred to be done at the end by dpkg it can be tried to order the unpack series only by critical needs, e.g. by Pre-Depends. Default is true and therefore the "old" method of ordering in various steps by everything. While both method were present in earlier APT versions the OrderCritical method was unused, so this method is very experimental and needs further improvements before becoming really useful.

OrderList::Score::Immediate
    Essential packages (and there dependencies) should be configured immediately after unpacking. It will be a good idea to do this quite early in the upgrade process as these these configure calls require currently also DPkg::TriggersPending which will run quite a few triggers (which maybe not needed). Essentials get per default a high score but the immediate flag is relatively low (a package which has a Pre-Depends is higher rated). These option and the others in the same group can be used to change the scoring. The following example shows the settings with there default values.

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

OPTIONS « PERIODIC » ET « ARCHIVE »

Les groupes d'options APT::Periodic et APT::Archive configurent les comportements périodiques réalisés par le script /etc/cron.daily/apt, lancé quotidiennement.

LES OPTIONS DE DéBOGAGE

Les options de la section Debug:: servent soit à provoquer l'affichage d'informations de débogage sur la sortie d'erreur standard du programme qui utilise les librairies APT, soit à activer des modes de fonctionnement spéciaux qui sont principalement utiles pour déboguer le comportement de APT. La plupart de ces options n'ont pas d'intérêt pour un utilisateur normal, mais certaines peuvent tout de même être utiles :

    • Debug::pkgProblemResolver affiche d'intéressantes informations sur les décisions prises par les commandes dist-upgrade, upgrade, install, remove et purge.

    • Debug::NoLocking désactive le verrouillage de fichier de manière à ce qu'APT puisse effectuer quelques opérations (telles que apt-get -s install) sans avoir les privilèges du superutilisateur.

    • Debug::pkgDPkgPM affiche la ligne de commande à chaque appel de dpkg(1).

    • Debug::IdentCdrom désactive l'inclusion de données de type statfs dans les identifiants de CD.

Liste complète des options de débogage de APT :

Debug::Acquire::cdrom
    Affiche les informations concernant les sources de type cdrom://

Debug::Acquire::ftp
    Affiche les informations concernant le téléchargement de paquets par FTP.

Debug::Acquire::http
    Affiche les informations concernant le téléchargement de paquets par HTTP.

Debug::Acquire::https
    Print information related to downloading packages using HTTPS.

Debug::Acquire::gpgv
    Affiche les informations relatives à la vérification de signatures cryptographiques avec gpg.

Debug::aptcdrom
    Affiche des informations concernant l'accès aux collections de paquets stockées sur CD.

Debug::BuildDeps
    Décrit le processus de résolution des dépendances pour la construction de paquets source ( « build-dependencies » ) par apt-get(8).

Debug::Hashes
    Affiche toutes les clefs de hachage cryptographiques créées par les librairies d'apt.

Debug::IdentCDROM
    Désactive l'inclusion des données de type statfs pour la génération des identifiants de CD, c'est-à-dire le nombre de blocs libres et utilisés sur le système de fichier du CD.

Debug::NoLocking
    Désactive le verrouillage de fichiers. Cela permet par exemple de lancer deux instances de “apt-get update” en même temps.

Debug::pkgAcquire
    Trace les ajouts et suppressions d'éléments de la queue globale de téléchargement.

Debug::pkgAcquire::Auth
    Affiche les détails de la vérification des sommes de contrôle et des signatures cryptographiques des fichiers téléchargés, ainsi que les erreurs éventuelles.

Debug::pkgAcquire::Diffs
    Affiche les informations de téléchargement et de prise en compte des fichiers différentiels des indexes de paquets, ainsi que les erreurs éventuelles.

Debug::pkgAcquire::RRed
    Affiche les détails de l'application des fichiers de différences aux listes de paquets d'APT quand ces fichiers de différences sont téléchargés à la place des fichiers complets.

Debug::pkgAcquire::Worker
    Affiche toutes les interactions avec les processus enfants qui se chargent effectivement des téléchargements.

Debug::pkgAutoRemove
    Affiche les changements concernant le marquage des paquets comme installés automatiquement, et la suppression des paquets inutiles.

Debug::pkgDepCache::AutoInstall
    Crée les informations de débogage décrivant quels paquets sont installés automatiquement pour satisfaire les dépendances. Cela concerne la passe initiale d'installation automatique effectuée par exemple par apt-get install et pas le système de résolution de dépendances complet de APT ; voir Debug::pkgProblemResolver pour ce dernier.

Debug::pkgDepCache::Marker
    Crée les informations de débogage décrivant quels paquets sont gardés/installés/supprimés pendant le travail de l'outil de résolution de problèmes. Chaque ajout ou suppression peut impliquer des actions supplémentaires ; elles sont alors indiquées avec une indentation de deux espaces de plus que l'action qui les a déclenchées. Le format de chaque ligne est MarkKeep, MarkDelete ou MarkInstall suivi de nom-paquet <a.b.c -> d.e.f | x.y.z> (section) où a.b.c est la version actuelle du paquet, d.e.f la version devant être installée et x.y.z une version plus récente qui n'est pas prévue pour être installée (à cause d'un score plus faible). Ces deux derniers éléments peuvent ne pas être mentionnés s'ils ne sont pas pertinents où lorsque ils sont identiques à la version installée. section est le nom de la section où figure le paquet.automatiquement pour satisfaire les dépendances. Cela concerne la passe initiale d'installation automatique effectuée par exemple par apt-get install et pas le système de résolution de dépendances complet de APT ; voir Debug::pkgProblemResolver pour ce dernier.

Debug::pkgInitConfig
    Affiche, au lancement, l'ensemble de la configuration sur la sortie d'erreur standard.

Debug::pkgDPkgPM
    Affiche la commande exacte d'invocation de dpkg(1) à chaque appel ; les paramètres sont séparés par des espaces.

Debug::pkgDPkgProgressReporting
    Affiche l'ensemble des informations reçues de dpkg(1) par l'intermédiaire du descripteur de fichier d'état, et les éventuelles erreurs d'analyse de ce fichier.

Debug::pkgOrderList
    Affiche les étapes de l'algorithme utilisé pour choisir l'ordre dans lequel apt passe les paquets à dpkg(1).

Debug::pkgPackageManager
    Affiche le détail des opérations liées à l'invocation de dpkg(1).

Debug::pkgPolicy
    Affiche, au lancement, la priorité de chaque liste de paquets.

Debug::pkgProblemResolver
    Affiche la trace d'exécution du système de résolution de dépendances (ne concerne que les cas où un problème de dépendances complexe se présente).

Debug::pkgProblemResolver::ShowScores
    Affiche la liste de tous les paquets installés avec leur score calculé par l'outil de résolution de problèmes. La description du paquet est celle qui est décrite dans Debug::pkgDepCache::Marker.

Debug::sourceList
    Affiche les fournisseurs déclarés dans le fichier /etc/apt/vendors.list.

EXEMPLES

Le fichier /usr/share/doc/apt/examples/configure-index.gz contient un modèle de fichier montrant des exemples pour toutes les options existantes.

FICHIERS

/etc/apt/apt.conf
    Fichier de configuration d'APT. Élément de configuration : Dir::Etc::Main.

/etc/apt/apt.conf.D/
    Fragments du fichier de configuration d'APT. Élément de configuration : Dir::Etc::Partsn.

VOIR AUSSI

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

BOGUES

Page des bogues d'APT[1]. Si vous souhaitez remonter un bogue à propos d'APT, veuillez lire /usr/share/doc/debian/bug-reporting.txt ou utiliser la commande reportbug(1).

TRADUCTEURS

Jérôme Marant, Philippe Batailler, Christian Perrier bubulle@debian.org (2000, 2005, 2009), Équipe de traduction francophone de Debian debian-l10n-french@lists.debian.org

AUTHORS

Jason Gunthorpe

Équipe de développement d'APT

Daniel Burrows <dburrows@debian.org>
    Documentation d'origine de Debug::*.

NOTES

1.  Page des bogues d'APT
    http://bugs.debian.org/src:apt