APT.CONF(5) APT APT.CONF(5) NOM apt.conf - Fichier de configuration pour APT DESCRIPTION Le fichier apt.conf est le fichier de configuration principal de l'ensemble de programmes APT, mais n'est de loin pas le seul endroit ou des choix d'options peuvent etre effectues. L'ensemble des outils partagent leur analyse de la ligne de commande, ce qui permet de garantir un environnement d'utilisation uniforme. Lorsqu'un programme de l'ensemble APT est utilise, il lit le fichier de configuration dans l'ordre suivant : 1. le fichier indique par la variable d'environnement APT_CONFIG si elle existe. 2. tous les fichiers de Dir::Etc::Parts dans l'ordre alphanumerique ascendant qui ont soit l'extension << conf >>, soit aucune extension et qui ne contiennent que des caracteres alphanumeriques, des tirets (-), des caracteres de soulignement (_) et des points (.), les autres fichiers etant ignores. Dans le cas contraire, APT affichera un avertissement indiquant qu'il a ignore un fichier sauf si celui-ci correspond a un motif defini dans la liste de configuration Dir::Ignore-Files-Silently (les fichiers correspondant a ce motif sont ignores silencieusement). 3. le fichier de configuration defini par Dir::Etc::Main 4. toutes les options definies dans le sous-arbre binaire de configuration specifique sont deplacees a la racine de l'arbre. 5. les options de ligne de commande sont appliquees pour remplacer les directives de configuration ou pour charger d'autres fichiers de configuration. SYNTAXE Le fichier de configuration est construit comme un arbre d'options organisees 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, destinee a l'outil Get. Il n'y a pas d'heritage des options des groupes parents. Syntaxiquement, le langage de configuration est concu sur le meme modele que les langages utilises par des outils ISC tels que bind et dhcp. Une ligne qui commence par // est traitee comme un commentaire et ignoree, de meme que les sections de texte placees entre /* et */, tout comme les commentaires C/C++. Les lignes debutant par # sont aussi traitees comme des commentaires. Chaque ligne est de la forme : APT::Get::Assume-Yes "true";. Les guillemets et le point-virgule final sont obligatoires. La valeur doit tenir sur une seule ligne et il n'existe pas de concatenation de chaines. La valeur ne doit pas comporter de guillemets ni de barre oblique inversee. Le nom d'une option contient des caracteres alphanumeriques et << /-:._+ >>. On peut declarer un nouveau champ d'action avec des accolades, comme suit : APT { Get { Assume-Yes "true"; Fix-Broken "true"; }; }; avec des retours a la ligne pour faciliter la lecture. On peut creer une liste en ouvrant un champ d'action et en y inserant une chaine entre guillemets suivie d'un point virgule. Des entrees multiples peuvent etre incluses, separees par des points-virgules. DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; Les modeles /usr/share/doc/apt/examples/configure-index montrent a quoi devrait ressembler le fichier de configuration. Les identifiants des options de configuration ne sont pas sensibles a la casse. Dans l'exemple precedent, on pourrait donc aussi bien utiliser dpkg::pre-install-pkgs. Les noms des elements de configuration sont optionnels si une liste est definie, comme cela peut se voir avec l'exemple DPkg::Pre-Install-Pkgs precedent. Si vous n'indiquez pas de nom, une nouvelle entree ajoutera une nouvelle option a la liste. Dans le cas contraire, l'option correspondante peut etre remplacee, comme toute autre option, en lui reaffectant une valeur. Deux elements speciaux sont autorises : #include (qui est obsolete et n'est plus gere par des implementations alternatives) et #clear. #include inclut le fichier donne en parametre, a moins que le nom ne se termine par une barre oblique auquel cas le repertoire entier est inclus. #clear sert a effacer une partie de l'arbre de configuration. L'element designe et tous ses descendants sont supprimes. Veuillez noter que ces lignes doivent egalement se terminer par un point-virgule. La commande #clear est la seule facon de supprimer une liste ou un champ d'action (<< scope >>). La reouverture d'un scope ou le style << :: >> decrit plus loin ne remplaceront pas les entrees ecrites precedemment. Les options ne peuvent etre remplacees qu'en leur affectant une nouvelle valeur. Les listes et les champs d'action ne peuvent etre remplaces mais seulement effaces. Tous les outils d'APT possedent une option -o qui permet de specifier une configuration quelconque depuis la ligne de commande. La syntaxe consiste en un nom complet d'option (par exemple APT::Get::Assume-Yes) suivi par un signe egal, puis par la nouvelle valeur de l'option. On peut completer une liste en ajoutant un :: final au nom de la liste. Comme on peut s'en douter, la syntaxe de champ d'action (<< scope >>) ne peut pas etre indiquee a la ligne de commande. Veuillez noter que vous ne pouvez utiliser :: que pour ajouter un element par ligne a la liste et que cela ne devrait pas etre utilise en combinaison avec la syntaxe de champ d'action (<< scope >>) qui inclut implicitement ::. L'utilisation simultanee des deux syntaxes declenchera un bogue dont certains utilisateurs se servent comme d'une fonctionnalite : une option avec le nom inhabituel << :: >> se comportera comme toute autre option nommee. Cela risque d'avoir de nombreux problemes comme consequence, par exemple si un utilisateur ecrit plusieurs lignes avec cette syntaxe erronee afin de faire un ajout a la liste, l'effet obtenu sera inverse puisque seule la derniere valeur pour l'option << :: >> sera utilisee. Les futures versions d'APT retourneront une erreur et l'execution sera interrompue si cette utilisation incorrecte est rencontree. Il est donc conseille de corriger ces defauts tant qu'APT ne s'en plaint pas explicitement. LE GROUPE APT Ce groupe d'options controle le comportement global d'APT et contient egalement des options communes a tous les outils. Architecture L'architecture du systeme ; cette option positionne l'architecture a utiliser pour recuperer des fichiers et analyser des listes de paquets. La valeur interne par defaut est l'architecture pour laquelle APT a ete compile. Architectures Toutes les architectures gerees par le systeme. Par exemple, les processeurs qui mettent en oeuvre le jeu d'instructions amd64 (aussi appele x86-64) peuvent executer des binaires compiles pour le jeu d'instructionsi386 (x86). Cette liste est utilisee pour recuperer des fichiers et analyser les listes de paquets. La valeur par defaut initiale est toujours celle de l'architecture native du systeme (APT::Architecture) et les autres architectures sont ajoutees a la liste par defaut lorsqu'elles sont enregistrees avec dpkg --add-architecture. Color Ce champ d'action definit les couleurs et les styles. Les couleurs de base prises en charge sont red, green, yellow, blue, magenta, cyan et white. Le sous-champ d'action action definit les couleurs des listes de paquets dans install et des commandes analogues. Les options suivantes peuvent etre definies : APT::Color::Action::Upgrade, APT::Color::Action::Install, APT::Color::Action::Install-Dependencies, APT::Color::Action::Downgrade, APT::Color::Action::Remove;, correspondant a leurs listes dans la sortie d'apt(8). Chaque couleur peut faire reference a une ou plusieurs autres options de couleur par leur nom, relatif a APT::Color. Leurs sequences d'echappement seront combinees. APT::Color::Bold "\x1B[1m"; APT::Color::Action::Install "cyan"; APT::Color::Action::Upgrade "bold action::install"; Les couleurs peuvent etre completement activees ou desactivees en reglant APT::Color a yes ou no, en utilisant les variables d'environnement NO_COLOR ou APT_NO_COLOR, ou en utilisant les options en ligne de commande --color et --no-color. Compressor Ce champ d'action (<< scope >>) definit quels formats de compression sont geres, comment la compression et la decompression peuvent etre realisees si ce format n'est pas pris en charge directement dans APT et une indication du cout d'une compression dans ce format. Dans cet exemple, le paragraphe suivant de la configuration permettra a APT de telecharger, decompresser, creer et stocker des fichiers avec l'extension de fichier a bas cout .reversed qu'il passera a la commande rev sans parametre supplementaire en ligne de commande pour la compression et la decompression : APT::Compressor::rev { Name "rev"; Extension ".reversed"; Binary "rev"; CompressArg {}; UncompressArg {}; Cost "10"; }; Build-Profiles Liste de tous les profils de construction actives pour la resolution de dependances de construction, sans le prefixe de l'espace de nommage du "profile.". Par defaut, cette liste est vide. La variable DEB_BUILD_PROFILES comme l'utilise dpkg- buildpackage(1) annule la notation de liste. Default-Release Indiquer la distribution a utiliser par defaut lors de l'installation d'un paquet si plusieurs versions sont disponibles. La valeur peut etre un nom de distribution ou un numero de version. Exemples : << stable >>, << testing >>, << trixie >>, << forky >>, << 4.0 >>, << 5.0* >>. Voir aussi apt_preferences(5). Snapshot Instantane a utiliser pour tous les depots configures avec Snapshot: yes. Voir aussi sources.list(5), l'option --snapshot qui definit cette valeur et Acquire::Snapshots::URI ci-dessous. Ignore-Hold Ignorer les paquets << geles >> ; cette option globale indique au systeme de resolution de probleme de ne pas tenir compte des paquets << geles >> dans sa prise de decision. Clean-Installed Avec cette option qui est activee par defaut, la fonctionnalite << autoclean >> supprime du cache tout paquet qui ne peut plus etre recupere. Quand cette option est desactivee, les paquets qui sont installes localement sont aussi exclus du nettoyage, mais notez que APT ne fournit aucun moyen direct pour les reinstaller. Immediate-Configure La valeur par defaut est << on >> ce qui a pour consequence qu'APT installera les paquets essentiels et importants des que possible pendant les operations d'installation ou de mise a jour, afin de limiter les consequences d'un echec de dpkg(1). Si cette option est desactivee, APT traitera les paquets importants comme les paquets de priorite << extra >> : entre la decompression du paquet A et sa configuration, de nombreuses operations de decompression ou de configuration peuvent prendre place pour des paquets B ou C qui n'ont rien a voir. Si ces operations provoquent un echec de dpkg(1) (par exemple si les scripts du responsable du paquet B provoquent une erreur), le resultat est que le paquet A est decompresse mais non configure. En consequence, les paquets qui en dependent pourraient ne plus fonctionner puisque leurs dependances ne sont pas satisfaites. Le marqueur de configuration immediate est egalement utilise dans le cas potentiellement delicat de dependances circulaires, car une dependance avec le marqueur << immediate >> est equivalent a une pre-dependance. Cela permet en theorie a APT de reconnaitre le cas ou il ne peut effectuer de configuration immediate et de s'interrompre pour suggerer de desactiver temporairement l'option pour permettre aux operations de s'effectuer. Veuillez noter l'utilisation du terme << en theorie >> : en realite, ce probleme est rarement rencontre, dans des versions non stables de distributions, et etait cause par des dependances incorrectes ou par un systeme deja dans un etat instable. Vous ne devriez donc pas desactiver cette option sans savoir ce que vous faites, car le scenario ci-dessus n'est pas le seul qu'elle permet d'eviter. Avant qu'une operation importante comme dist-upgrade ne soit executee avec cette option desactivee, vous devriez essayer d'installer (install) explicitement le paquet qu'APT ne peut pas configurer immediatement. Ne manquez toutefois pas de signaler le probleme dans votre distribution et a l'equipe de maintenance d'APT avec le lien de systeme de gestion de bogues ci-dessous, afin qu'ils puissent ameliorer ou corriger les processus de mise a jour. Force-LoopBreak Ne jamais activer cette option a moins que vous ne sachiez reellement ce que vous faites. Elle autorise APT a supprimer temporairement un paquet essentiel pour mettre fin a une boucle Conflicts/Conflicts ou Conflicts/Pre-Depends entre deux paquets essentiels. Une telle boucle ne devrait jamais se produire : c'est un bogue tres important. Cette option fonctionne si les paquets essentiels ne sont pas tar, gzip, libc, dpkg, dash ou tous les paquets dont ces paquets dependent. Cache-Start, Cache-Grow, Cache-Limit A partir de la version 0.7.26, APT utilise un fichier de cache de taille variable indexe en memoire (<< resizable memory mapped cache file >>) pour conserver les informations du fichier << available >>. Cache-Start definit la taille minimale de ce cache et par consequent la quantite de memoire qu'APT utilisera des son lancement. La valeur par defaut est de 20971520 octets (environ 20 Mo). Il est indispensable que l'ensemble de cette memoire soit disponible, sinon APT ne pourra se lancer. Il peut donc etre necessaire de diminuer cette valeur sur des systemes disposant de peu de memoire. Au contraire, pour des systemes qui utilisent de nombreuses sources de paquet, il peut etre necessaire de l'augmenter. La valeur de Cache-Grow definit, en octets, la quantite de memoire supplementaire qui peut etre allouee au cache si la valeur definie par Cache-Start est insuffisante. La valeur par defaut de Cache-Grow est de 1048576 octets (environ 1 Mo). Cette augmentation se fera tant que la taille du cache sera insuffisante pour contenir toutes les informations necessaires ou qu'elle atteint la valeur limite definie par Cache-Limit. La valeur par defaut de Cache-Limit est nulle (il n'existe donc pas de limite a la taille maximale du cache). Si Cache-Grow est egal a 0, l'augmentation automatique de la taille du cache est desactivee. Build-Essential Cette option definit les paquets qui sont consideres comme faisant partie des dependances essentielles pour la construction de paquets. Get La sous-section Get controle l'outil apt-get(8), veuillez consulter sa documentation pour avoir plus d'informations sur les options en question. Cache La sous-section Cache controle l'outil apt-cache(8), veuillez consulter sa documentation pour avoir plus d'informations sur les options en question. CDROM La sous-section CDROM controle l'outil apt-cdrom(8), veuillez consulter sa documentation pour avoir plus d'informations sur les options en question. NeverAutoRemove Ne jamais supprimer automatiquement les fichiers qui correspondent a la ou aux expressions rationnelles. Protect-Kernels Cette option indique a apt autoremove que les noyaux sont proteges et est reglee par defaut a vrai. Dans le cas ou les noyaux ne sont pas proteges, ils sont traites comme n'importe quel paquet. VersionedKernelPackages Definir la ou les expressions rationnelles pour les paquets versionnes du noyau. Un ensemble de regles base sur ces expressions est injecte dans APT de maniere analogue aux expressions rationnelles d'APT::NeverAutoRemove NeverAutoRemove::KernelCount Conserver un nombre personnalise de noyaux lors des suppressions automatiques, 2 par defaut, signifiant que deux noyaux sont conserves. APT garde toujours le noyau en execution et le plus recent. Si le noyau le plus recent est aussi le noyau en execution, l'avant-dernier est aussi conserve. Pour cette raison, toute valeur inferieure a 2 est ignoree. Si vous voulez ne garder que le dernier noyau, reglez APT::Protect-Kernels a << false >>. LE GROUPE ACQUIRE Le groupe d'options Acquire controle le telechargement des paquets ainsi que les differentes << methodes d'acquisition >> qui effectuent ce telechargement (voir aussi sources.list(5)). Check-Date Les options relatives a la securite sont positionnees par defaut a << true >>,permettant des verifications relatives a l'heure. Leur desactivation signifie qu'on ne peut pas faire confiance a l'heure de la machine, et APT de ce fait desactivera toutes les verifications de ce type, telles que Check-Valid-Until et la verification que le champ Date d'un fichier Release n'est pas dans le futur. Max-FutureTime Duree maximale (en secondes) pendant laquelle un fichier Release est considere comme valable, a partir du moment de sa creation (tel que cela est indique dans l'en-tete Date). La valeur par defaut est 10. Un reglage specifique pour une archive donnee peut etre defini en ajoutant l'etiquette de l'archive au nom de l'option. De preference, le meme resultat peut etre obtenu pour des entrees particulieres de sources.list(5) en utilisant ici l'option Date-Max-Future. Check-Valid-Until L'activation de l'option de securite qui permet de mettre une limite temporelle de validite au fichier Release permet d'eviter des attaques de type << replay >> et permet d'eviter d'utiliser des miroirs qui ne sont plus a jour. Cependant, cette fonctionnalite a besoin que l'horloge du systeme soit a jour. Les gestionnaires d'archives devraient creer des fichiers Release comportant l'en-tete Valid-Until. Cependant, si cet en-tete est absent, ou si une valeur plus stricte est desiree, la valeur du parametre Max-ValidTime est alors utilisee. L'option Check-Valid-Until des entrees de sources.list(5) devrait etre preferee pour desactiver selectivement la verification plutot que d'utiliser ce remplacement global. Max-ValidTime Duree maximale (en secondes) pendant laquelle un fichier Release est considere comme valable, a partir du moment de sa creation (tel que cela est indique dans l'en-tete Date). Si ce fichier lui-meme comporte un en-tete Valid-Until la plus ancienne des deux dates est utilisee comme date d'expiration. La valeur par defaut (0) signifie << valable eternellement >>. Un reglage specifique pour une archive donnee peut etre defini en ajoutant l'etiquette de l'archive au nom de l'option. De preference, le meme resultat peut etre obtenu pour des entrees particulieres de sources.list(5) en utilisant ici l'option Valid-Until-Max. Min-ValidTime Duree minimale (en secondes) pendant laquelle un fichier Release est considere comme valable, a partir du moment de sa creation (tel que cela est indique dans l'en-tete Date). Il est conseille d'utiliser ce reglage si vous utilisez un miroir mis a jour ponctuellement (par exemple un miroir local) d'une archive mise a jour plus frequemment avec un en-tete Valid-Until plutot que de desactiver completement le controle des dates d'expiration. Un reglage specifique pour une archive donnee peut etre defini en ajoutant l'etiquette de l'archive au nom de l'option. De preference, le meme resultat peut etre obtenu pour des entrees particulieres de sources.list(5) en utilisant ici l'option Valid-Until-Min. AllowTLS Permet l'utilisation de la prise en charge interne de TLS dans la methode http. Si la valeur de l'option est << false >>, cela desactive totalement la prise en charge de TLS dans les methodes propres d'Apt (a l'exclusion de la methode https basee sur curl). Plus aucune des fonctions liees a TLS ne peut etre appelee. PDiffs Essayer de telecharger les fichiers differentiels appeles PDiffs pour les index (par exemple les fichiers Packages), plutot que de les telecharger entierement. Par defaut a << true >>. De preference, cela peut etre defini pour des entrees particulieres de sources.list(5) ou des fichiers d'index en utilisant ici l'option PDiffs. Deux sous-options permettant de limiter l'utilisation de fichiers << pdiff >> sont egalement disponibles. FileLimit permet d'indiquer le nombre maximal de fichiers de differences peuvent etre telecharges pour modifier un fichier. SizeLimit permet par ailleurs de limiter la taille combinee des fichiers de differences recuperes a un certain pourcentage du fichier a modifier. Si une de ces limites est depassee, le fichier complet est telecharge au lieu de telecharger les fichiers de differences. By-Hash Essayer de telecharger les index avec un URI construit a partir de la somme de hachage du fichier attendu plutot que de les telecharger a partir d'un nom de fichier stable bien connu. Par defaut a << true >>, mais automatiquement desactive si la source n'indique pas sa prise en charge. Son utilisation peut etre forcee avec la valeur speciale << force >>. De preference, cela peut etre defini pour des entrees particulieres de sources.list(5) ou des fichiers d'index en utilisant ici l'option By-Hash. Queue-Mode Mode de file d'attente ; Queue-Mode peut prendre les valeurs host ou access, ce qui determine comment APT parallelise les connexions sortantes. Host signifie qu'une connexion par cible sera initiee, tandis que access signifie qu'une connexion par type d'URI sera initiee. Retries Nombre d'essais a effectuer. Si ce nombre n'est pas nul, APT essaie de recuperer, le nombre donne de fois, les fichiers dont la recuperation a echoue. Source-Symlinks Utilise des liens symboliques pour les archives de sources. Positionnee a << true >>, cette option cree si possible des liens symboliques vers les archives de sources au lieu de les copier. Par defaut a << true >>. http https Les options dans ces champs d'action configurent les transports d'acquisition d'APT pour les protocoles HTTP et HTTPS et sont documentees dans les pages de manuel apt-transport-http(1) et apt- transport-https(1) respectivement. cdrom La seule option de configuration pour les URI qui utilisent la methode cdrom est le point de montage : cdrom::Mount ; il doit representer le point de montage du lecteur de CD-ROM (ou DVD, etc.) indique dans /etc/fstab. D'autres commandes de montage et de demontage peuvent etre fournies quand le point de montage ne peut etre liste dans le fichier /etc/fstab. Syntaxiquement, il faut placer /cdrom/::Mount "foo"; dans le bloc cdrom. La barre oblique finale est importante. Les commandes de demontage peuvent etre specifiees en utilisant UMount. gpgv La seule option pour les URI GPGV est gpgv::Options qui passe des parametres supplementaires a gpgv. CompressionTypes Cette option indique la liste des types de compression comprises par les methodes d'acquisition. Des fichiers comme Packages peuvent etre disponibles dans divers formats de compression. Par defaut, les methodes d'acquisition decompressent et recompressent dans beaucoup de formats courants les fichiers compresses comme avec xz et gzip ; ce champ d'action permet de rechercher les formats pris en charge ou de les modifier, et l'ajout de prise en charge de formats supplementaires est aussi possible (voir aussi APT::Compressor). La syntaxe a utiliser est : Acquire::CompressionTypes::ExtensionFichier "NomMethode"; Le sous-groupe Order peut etre egalement utilise pour definir l'ordre dans lequel le systeme d'acquisition tentera de telecharger les fichiers compresses. Le premier systeme mentionne sera essaye en premier, puis le suivant en cas d'echec. Ainsi, pour privilegier un format par rapport a un autre, il suffit de le placer en premier dans cette liste. Les types qui ne sont pas deja indiques seront ajoutes implicitement a la fin de la liste. Ainsi, par exemple, Acquire::CompressionTypes::Order:: "gz"; peut etre utilise pour preferer les fichiers compresses avec gzip par rapport a tous les autres formats de compression. Si l'objectif est d'utiliser xz en priorite par rapport a gzip et bzip2, ce reglage doit ressembler a Acquire::CompressionTypes::Order { "xz"; "gz"; }; . Il est inutile d'ajouter explicitement bz2 a la liste, car il sera ajoute automatiquement. Veuillez noter que Dir::Bin::NomMethode sera controle a l'execution : si cette option est utilisee et que la prise en charge de ce format n'est pas construite dans APT, la methode ne sera utilisee que si ce fichier existe. Ainsi, pour la methode bzip2, le reglage (utilise en interne) est Dir::Bin::bzip2 "/bin/bzip2"; . Veuillez egalement noter que les elements de liste indiques a la ligne de commande seront ajoutes a la fin de la liste indiquee dans les fichiers de configuration, mais avant les valeurs par defaut. Dans ce cas, pour etablir une preference par rapport aux types mentionnes dans les fichiers de configuration, il est possible de placer l'option directement, pas sous forme de liste. Cela ne remplacera pas la liste par defaut mais elle sera simplement prefixee avec l'option en question. Le type special uncompressed peut servir a donner la preference aux fichiers non compresses. Veuillez noter que la plupart des archives ne fournissent pas de fichiers non compresses, donc ce reglage est surtout destine aux miroirs locaux. GzipIndexes Lorsque des index compresses par gzip doivent etre utilises (pour les fichiers Packages, Sources, Translations), ceux-ci seront compresses avec gzip au lieu d'etre laisses decompresses. Cela peut permettre de gagner beaucoup d'espace disque au prix d'une utilisation plus importante du processeur lorsque les caches locaux sont crees. Valeur par defaut : << false >>. Languages La sous-section << Languages >> controle quels fichiers Translation sont telecharges et dans quel ordre APT les utilisera pour afficher les traductions de descriptions. APT recherchera d'abord la premiere traduction disponible pour le champ Description dans la langue choisie en premier. Les langues peuvent etre indiquees par leur code long ou court. Veuillez noter que tous les depots ne fournissent pas les fichiers Translation pour toutes les langues, les codes longs de langues etant particulierement rares. La liste par defaut contient << environment >> et << en >>. La valeur << environment >> a une signification speciale : elle sera remplacee, a l'execution, par les codes de langues utilises dans la variable d'environnement LC_MESSAGES. Les codes utilises en double ne seront pas inclus deux fois dans la liste. Si LC_MESSAGES contient << C >>, seul le fichier Translation-en sera utilise, s'il est disponible. Pour forcer APT a n'utiliser aucun fichier de traduction, il est necessaire d'utiliser le reglage Acquire::Languages=none. La valeur << none >> a une signification speciale et indique de ne rechercher aucun fichier Translation. Cela indique a APT de telecharger ces traductions, sans necessairement les utiliser sauf si la variable d'environnement indique ces langues. Ainsi, dans l'exemple qui suit, l'ordre utilise sera << en, fr >> si dans un environnement configure pour l'anglais et << fr, en >> pour un environnement configure en francais. Les fichiers pour l'allemand seront egalement telecharges mais ne sont utilises que dans un environnement configure pour l'allemand. Dans ce dernier cas, l'ordre est alors << de, fr, en >>. Acquire::Languages { "environment"; "fr"; "en"; "none"; "de"; }; Note : afin d'eviter des problemes lorsqu'APT est execute dans differents environnements (par exemple par differents utilisateurs ou differents programmes), tous les fichiers << Translation >>qui sont trouves dans /var/lib/apt/lists/ seront ajoutes a la fin de la liste (apres un << none >> implicite). ForceIPv4 Utilisation imposee du protocole IPv4 lors des telechargements. ForceIPv6 Utilisation imposee du protocole IPv6 lors des telechargements. MaxReleaseFileSize La taille maximale des fichiers Release/Release.gpg/InRelease. La taille par defaut est 10 Mo. EnableSrvRecords Cette option verifie si APT utilisera l'entree de serveur DNS SRV telle que definie dans la RFC 2782 pour choisir un serveur alternatif auquel se connecter. La valeur par defaut est << true >>. AllowInsecureRepositories Autoriser les operations de mise a jour a charger des fichiers de donnees a partir de depots sans informations de securite suffisantes. La valeur par defaut est << false >>. Le concept, les implications ainsi que les alternatives sont detailles dans apt- secure(8). AllowWeakRepositories Autoriser les operations de mise a jour a charger des fichiers de donnees a partir de depots qui fournissent des informations de securite, mais qui ne sont plus consideres comme suffisamment robustes sur le plan de la cryptographie. La valeur par defaut est << false >>. Le concept, les implications ainsi que les alternatives sont detaillees dans apt-secure(8). AllowDowngradeToInsecureRepositories Permettre qu'un depot qui etait auparavant signe par pgp devienne non signe durant l'operation de la mise a jour. Quand il n'y a pas de signature valable pour un ancien depot de confiance, APT refusera la mise a jour. Cette option peut etre utilisee pour contourner cette protection. Vous ne souhaiterez presque certainement jamais activer cette option. La valeur pas defaut est << false >>. Le concept, les implications ainsi que les alternatives sont detaillees dans apt-secure(8). Changelogs::URI champ d'action La recuperation des journaux des modifications n'est possible que si l'URI ou les telecharger est connu. De preference, le fichier Release l'indique dans un champ << Changelogs >>. S'il n'est pas disponible, les champs Label ou Origine du fichier Release sont utilises pour verifier si les options Acquire::Changelogs::URI::Label::ETIQUETTE ou Acquire::Changelogs::URI::Origin::ORIGINE existent, et si c'est le cas, cette valeur est prise. La valeur dans le fichier Release peut etre outrepassee par Acquire::Changelogs::URI::Override::Label::ETIQUETTE ou Acquire::Changelogs::URI::Override::Origin::ORIGINE. La valeur devrait etre un URI normal vers un fichier texte, a l'exception que les donnees specifiques du paquet sont remplacees par le parametre @CHANGEPATH@. Sa valeur est la suivante : 1. si le paquet provient d'un composant (par exemple main) il constitue la premiere partie, sinon il est omis ; 2. est la premiere lettre du nom du paquet source, sauf si le nom du paquet source commence par lib auquel cas les quatre premieres lettres seront utilisees ; 3. le nom complet du paquet source ; 4. le nom complet une fois de plus et 5. la version de la source. Les quatre premieres parties (ou trois si le composant est absent) sont separees par des barres obliques (<< / >>) et les deux dernieres sont separees par un caractere de soulignement (<< _ >>). La valeur speciale << no >> est disponible pour indiquer que cette source ne peut etre utilisee pour recuperer les fichiers changelog. Dans ce cas, une autre source sera essayee. Snapshots::URI champ d'action Comme pour les journaux des modifications, la recuperation des instantanes n'est possible que si l'URI ou les telecharger est connu. De preference, le fichier Release l'indique dans un champ << Snapshots >>. S'il n'est pas disponible, les champs Label ou Origine du fichier Release sont utilises pour verifier si les options Acquire::Snapshots::URI::Label::ETIQUETTE ou Acquire::Snapshots::URI::Origin::ORIGINE existent, et si c'est le cas, cette valeur est prise. La valeur dans le fichier Release peut etre contournee par Acquire::Snapshots::URI::Override::Label::ETIQUETTE ou Acquire::Snapshots::URI::Override::Origin::ORIGINE. La valeur devrait etre un URI normal vers un repertoire, a l'exception que l'identifiant de l'instantane est remplace par le parametre @SNAPSHOTID@. La valeur speciale << no >> est disponible pour indiquer que cette source ne peut etre utilisee pour recuperer les instantanes. Dans ce cas, une autre source sera essayee. CONFIGURATION SPECIFIQUE DEXECUTABLE Particulierement avec l'introduction de l'executable apt il peut etre utile de configurer certaines options seulement pour un executable particulier dans la mesure ou meme des options qui semblent affecter seulement certains binaires telles que APT::Get::Show-Versions affectent apt-get autant qu'apt. La configuration d'une option pour un executable particulier peut etre realisee en reglant l'option dans le champ d'action Binary::executable-specifique. Affecter l'option APT::Get::Show-Versions a apt seulement peut etre fait, par exemple en configurant plutot Binary::apt::APT::Get::Show-Versions. Veuillez noter que comme cela est indique dans la section DESCRIPTION plus haut, il n'est pas possible de configurer les options specifiques aux executables en ligne de commande ni dans des fichiers de configuration charges par la ligne de commande. LES REPERTOIRES Les repertoires de la section Dir::State concernent le systeme local. lists est le repertoire ou placer les listes de paquets telecharges et status est le nom du fichier d'etat de dpkg(1). preferences concerne APT : c'est le nom du fichier preferences. Dir::State contient le repertoire par defaut prefixe a tous les sous-elements, 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, ainsi que l'endroit ou sont placees les archives telechargees, Dir::Cache::archives. On peut empecher la creation des caches en positionnant pkgcache ou srcpkgcache a la valeur "". Cela ralentit le demarrage mais economise de l'espace disque. Il vaut mieux se passer du cache pkgcache plutot que se passer du cache srcpkgcache. Comme pour Dir::State, le repertoire par defaut 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 defaut (le modifier n'a aucun effet, a moins qu'on ne le modifie avec le fichier de configuration indique par la variable APT_CONFIG). Dir::Parts lit, par ordre d'entree, tous les fragments de configuration dans le repertoire indique. Ensuite, le fichier principal de configuration est charge. Les programmes binaires sont pointes par Dir::Bin. L'emplacement des gestionnaires de methodes est indique par Dir::Bin::Methods ; gzip, bzip2, lzma, dpkg, apt-get, dpkg-source, dpkg-buildpackage et apt-cache indiquent l'emplacement des programmes correspondants. L'option de configuration RootDir a une signification particuliere. Lorsqu'elle est definie, tous les chemins sont consideres relativement a RootDir, meme les chemins specifies de maniere absolue. Par exemple, si RootDir est defini comme /tmp/staging, et que chemin du fichier d'etat Dir::State::status est declare comme /var/lib/dpkg/status, alors ce fichier sera cherche dans /tmp/staging/var/lib/dpkg/status. Si vous souhaitez seulement prefixer des chemins relatifs, definissez plutot Dir. La liste Ignore-Files-Silently permet d'indiquer quels sont les fichiers qu'APT peut ignorer sans avertissement dans les repertoires contenant des fragments de configuration. Par defaut, les fichiers qui se terminent par .disabled, ~, .bak ou .dpkg-[a-z]+ sont ignores. Comme cela est visible dans le dernier element de cette liste, il est possible d'utiliser la syntaxe des expressions rationnelles. APT ET DSELECT Quand APT est utilise comme une methode de dselect(1), plusieurs directives controlent le comportement par defaut. 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 apres la mise a niveau ; << prompt >> (valeur par defaut) les supprime apres une demande et << auto >> ne supprime que les archives qui ne peuvent plus etre telechargees (remplacees, par exemple, par une nouvelle version). << pre-auto >> les supprime avant de recuperer de nouveaux paquets. options Le contenu de cette variable est passe comme options de ligne de commande a apt-get(8) lors de la phase d'installation. Updateoptions Le contenu de cette variable est passe comme options de ligne de commande a apt-get(8) lors de la phase de mise a jour. PromptAfterUpdate Si cette option est << true >>, l'operation [U]pdate de dselect(1) interroge toujours l'utilisateur avant de continuer. Par defaut, ce n'est qu'en cas d'erreur que l'on propose a l'utilisateur d'intervenir. METHODE DAPPEL DE DPKG(1) PAR APT Plusieurs directives de configuration controlent la maniere dont APT invoque dpkg(1) : elles figurent dans la section DPkg. options Il s'agit d'une liste d'options a passer a dpkg(1). Les options doivent etre declarees en utilisant la notation de liste et chaque element de la liste est passe comme un seul parametre a dpkg(1). Path Il s'agit d'une chaine qui definit la variable d'environnement PATH utilisee lors de l'execution de dpkg. Elle peut etre definie a n'importe quelle valeur valable pour cette variable d'environnement ou etre une chaine vide, dans ce cas la variable n'est pas modifiee. Pre-Invoke, Post-Invoke Il s'agit d'une liste de commandes shell a executer avant ou apres l'appel de dpkg(1). Tout comme pour Options, on doit utiliser la notation de liste. Les commandes sont appelees dans l'ordre, en utilisant /bin/sh : APT s'arrete des que l'une d'elles echoue. Pre-Install-Pkgs Il s'agit d'une liste de commandes shell a executer avant d'appeler dpkg(1). Tout comme pour Options, on doit utiliser la notation de liste. Les commandes sont appelees dans l'ordre, en utilisant /bin/sh : APT s'arrete des que l'une d'elles echoue. APT transmet aux commandes les noms de tous les fichiers .deb qu'il va installer, a raison d'un par ligne sur le descripteur de fichier demande, par defaut sur l'entree standard. La version 2 de ce protocole envoie plus d'informations a travers le descripteur du fichier requis : une ligne avec le texte VERSION 2, l'espace de configuration d'APT et une liste d'actions de paquet avec le nom de fichier et l'information de version. Chaque ligne de directive de configuration a la forme cle=valeur. Les caracteres speciaux (signes egal, fin de ligne, caracteres non imprimables, guillemets et signe pourcentage dans cle et fin de ligne, caracteres non imprimables et signe pourcentage dans valeur) sont %-encodes (encodage URL). Les listes sont representes par des lignes cle::=valeur multiples avec la meme cle. Les sections de la configuration se terminent par une ligne vide. Les lignes d'action de paquet consistent en cinq champs dans la version 2 : le nom du paquet (sans qualification d'architecture, meme si c'est une architecture supplementaire - << foreign >>), la version ancienne, la direction du changement de version (< pour les mises a niveau, > pour les retours en arriere, = pour pas de modification), la nouvelle version, l'action. Les champs versions sont << - >> pour pas de version du tout (par exemple lors de la premiere installation d'un paquet ; pas de version est traite comme anterieur a n'importe quelle version reelle, ainsi c'est une mise a jour, indiquee comme - < 1.23.4). Le champ action est << **CONFIGURE** >> si le paquet est en cours de configuration, << **REMOVE** >> s'il est en cours de suppression, ou bien le nom d'un fichier .deb s'il est en cours de depaquetage. Dans la Version 3, apres chaque champ version, se trouve l'architecture de cette version qui est << - >> s'il n'y a pas de version, puis un champ montrant le type MultiArch << same >>, << foreign >>, << allowed >> ou << none >>. Veuillez noter que << none >> est un nom de type incorrect qui est juste conserve pour des raisons de compatibilite, il devrait etre lu comme << no >> et les utilisateurs sont encourages a prendre en charge les deux. La version du protocole qu'il faut utiliser pour la commande cmd peut etre choisie en reglant DPkg::Tools::options::cmd::Version en consequence, la version par defaut etant la premiere. Si APT ne gere pas la version demandee, il enverra les informations dans la version la plus haute qu'il gere. Le descripteur de fichier a utiliser pour l'envoi des informations peut etre demande avec l'option DPkg::Tools::options::cmd::InfoFD qui est par defaut 0 comme entree standard ; l'option est disponible depuis la version 0.9.11. La prise en charge de l'option peut etre detectee en regardant la variable d'environnement APT_HOOK_INFO_FD qui contient comme confirmation le numero du descripteur de fichier utilise. Run-Directory APT se place dans ce repertoire avant d'appeler dpkg(1) ; par defaut, c'est le repertoire /. Build-options Ces options sont passees a dpkg-buildpackage(1) lors de la compilation des paquets ; par defaut la signature est desactivee et tous les binaires sont crees. DPkg::ConfigurePending Si cette option est choisie, APT lancera dpkg --configure --pending pour laisser dpkg(1) gerer les configurations de paquets et les actions differees. Cette option est automatiquement activee. Il peut par contre etre utile de la desactiver pour lancer APT plusieurs fois successives, par exemple quand il est utilise depuis un outil d'installation. Dans ce cas, seul le dernier de tous les appels successifs peut conserver l'option active. OPTIONS << PERIODIC >> ET << ARCHIVE >> Les groupes d'options APT::Periodic et APT::Archive configurent les comportements periodiques realises par le script /usr/lib/apt/apt.systemd.daily, lance quotidiennement. LES OPTIONS DE DEBOGAGE Les options de la section Debug:: servent soit a provoquer l'affichage d'informations de debogage sur la sortie d'erreur standard du programme qui utilise les bibliotheques APT, soit a activer des modes de fonctionnement speciaux qui sont principalement utiles pour deboguer le comportement de APT. La plupart de ces options n'ont pas d'interet pour un utilisateur normal, mais certaines peuvent tout de meme etre utiles : o Debug::pkgProblemResolver affiche d'interessantes informations sur les decisions prises par les commandes dist-upgrade, upgrade, install, remove et purge. o Debug::NoLocking desactive le verrouillage de fichier de maniere a ce qu'APT puisse effectuer quelques operations (telles que apt-get -s install) sans avoir les privileges du superutilisateur. o Debug::pkgDPkgPM affiche la ligne de commande a chaque appel de dpkg(1). o Debug::IdentCdrom desactive l'inclusion de donnees de type statfs dans les identifiants de CD. Liste complete des options de debogage d'APT : Debug::Acquire::cdrom Afficher les informations concernant les sources de type cdrom:// Debug::Acquire::http Afficher les informations concernant le telechargement de paquets par HTTP. Debug::Acquire::https Afficher les informations concernant le telechargement de paquets par HTTPS. Debug::Acquire::gpgv Afficher les informations relatives a la verification de signatures chiffrees avec gpg. Debug::aptcdrom Afficher des informations concernant l'acces aux collections de paquets stockees sur CD. Debug::Hashes Afficher tous les hachages de chiffrement crees par les bibliotheques d'apt. Debug::IdentCDROM Ne pas inclure les informations de statfs pour la generation des identifiants de CD, c'est-a-dire le nombre de blocs libres et utilises sur le systeme de fichiers du CD. Debug::NoLocking Desactiver le verrouillage de fichiers. Cela permet par exemple de lancer deux instances de << apt-get update >> en meme temps. Debug::pkgAcquire Tracer les ajouts et suppressions d'elements de la queue globale de telechargement. Debug::pkgAcquire::Auth Afficher les messages d'etat de la verification des sommes de controle et des signatures chiffrees des fichiers telecharges, ainsi que les erreurs eventuelles. Debug::pkgAcquire::Diffs Afficher les informations de telechargement et de prise en compte des fichiers differentiels des listes d'index de paquets, ainsi que les erreurs eventuelles. Debug::pkgAcquire::RRed Afficher les details de l'application des fichiers de differences aux listes de paquets d'APT quand ces fichiers de differences sont telecharges a la place des fichiers complets. Debug::pkgAcquire::Worker Afficher toutes les interactions avec les processus enfants qui se chargent effectivement des telechargements. Debug::pkgAutoRemove Afficher les changements concernant le marquage des paquets comme installes automatiquement et la suppression des paquets inutiles. Debug::pkgDepCache::AutoInstall Creer les informations de debogage decrivant quels paquets sont installes automatiquement pour satisfaire les dependances. Cela concerne la passe initiale d'installation automatique effectuee par exemple par apt-get install et pas le systeme de resolution de dependances complet d'APT ; voir Debug::pkgProblemResolver pour ce dernier. Debug::pkgDepCache::Marker Creer les informations de debogage decrivant quels paquets sont gardes/installes/supprimes pendant le travail de l'outil de resolution de problemes. Chaque ajout ou suppression peut impliquer des actions supplementaires ; elles sont alors indiquees avec une indentation de deux espaces de plus sous l'action qui les a declenchees. Le format de chaque ligne est MarkKeep, MarkDelete ou MarkInstall suivi de nom-paquet d.e.f | x.y.z> (section) ou a.b.c est la version actuelle du paquet, d.e.f la version devant etre installee et x.y.z une version plus recente qui n'est pas prevue pour etre installee (a cause d'un score d'epinglage plus faible). Ces deux derniers elements peuvent ne pas etre mentionnes s'ils ne sont pas pertinents ou lorsqu'ils sont identiques a la version installee. section est le nom de la section ou figure le paquet. Debug::pkgDPkgPM Afficher la commande exacte d'invocation de dpkg(1) a chaque appel ; les parametres sont separes par une unique espace. Debug::pkgDPkgProgressReporting Afficher l'ensemble des informations recues de dpkg(1) par l'intermediaire du descripteur de fichier d'etat, et les eventuelles erreurs d'analyse de ce fichier. Debug::pkgOrderList Afficher les etapes de l'algorithme utilise pour choisir l'ordre dans lequel apt passe les paquets a dpkg(1). Debug::pkgPackageManager Afficher les messages d'etat tracant les etapes realisees lors de l'invocation de dpkg(1). Debug::pkgPolicy Afficher, au lancement, la priorite de chaque liste de paquets. Debug::pkgProblemResolver Afficher la trace d'execution du systeme de resolution de dependances (ne concerne que les cas ou un probleme de dependances complexe se presente). Debug::pkgProblemResolver::ShowScores Afficher la liste de tous les paquets installes avec leur score calcule par l'outil de resolution de problemes. La description du paquet est celle qui est decrite dans Debug::pkgDepCache::Marker. Debug::sourceList Afficher les fournisseurs declares dans le fichier /etc/apt/vendors.list. Debug::RunScripts Afficher les commandes externes qui sont appelees par les points d'entree d'apt. Cela inclut par exemple les options de configuration DPkg::{Pre,Post}-Invoke ou APT::Update::{Pre,Post}-Invoke. EXEMPLES Le fichier /usr/share/doc/apt/examples/configure-index contient un modele de fichier montrant des exemples pour toutes les options existantes. FICHIERS /etc/apt/apt.conf Fichier de configuration d'APT. Element de configuration : Dir::Etc::Main. /etc/apt/apt.conf.d/ Fragments du fichier de configuration d'APT. Element de configuration : Dir::Etc::Parts. VOIR AUSSI apt-cache(8), apt-config(8), apt_preferences(5). BOGUES Page des bogues d'APT[1]. Si vous souhaitez signaler un bogue a propos d'APT, veuillez lire /usr/share/doc/debian/bug-reporting.txt ou utiliser la commande reportbug(1). TRADUCTEURS Jerome Marant, Philippe Batailler, Christian Perrier (2000, 2005, 2009, 2010), bubu et Jean-Pierre Giraud (2004, 2017-2024) et l'equipe de traduction francophone de Debian Veuillez noter que cette traduction peut contenir des parties non traduites. Cela est volontaire, pour eviter de perdre du contenu quand la traduction est legerement en retard sur le contenu d'origine. AUTEURS Jason Gunthorpe Equipe de developpement d'APT Daniel Burrows Documentation initiale de Debug::*. NOTES 1. Page des bogues d'APT https://bugs.debian.org/src:apt APT 2.9.33 05 janvier 2025 APT.CONF(5)