Loading

NAME

       apt.conf - Fichier de configuration pour APT

       Le fichier apt.conf est le fichier de configuration principal du
       l'ensemble de programmes APT, mais n'est de loin pas le seul endroit o
       des choix d'options peuvent tre effectus. Tous les outils partagent les
       fichiers de configuration et utilisent galement une analyse commune de
       la ligne de commande, ce qui permet de garantir un environnement
       d'utilisation uniforme.

       Lorsqu'un programme de l'ensemble APT est utilis, il lit le fichier de
       configuration dans l'ordre suivant :

        1. fichier indiqu par la variable d'environnement APT_CONFIG si elle
           existe

        2. tous les fichiers de Dir::Etc::Parts dans l'ordre alphanumrique
           ascendant qui ont soit l'extension "conf", soit aucune extension et
           qui ne contiennent que des caractres alphanumriques, des tirets
           (-), des caractres de soulignement (_) et des points (.), les
           autres fichiers tant ignors.

        3. le fichier de configuration dfini par Dir::Etc::Main

        4. les options de ligne de commande sont appliques 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
       organises 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, destine  l'outil Get. Il
       n'y a pas d'hritage des options des groupes parents.

       Syntaxiquement, le langage de configuration est conu sur le mme modle
       que les langages utiliss par des outils ISC tels que bind et dhcp. Une
       ligne qui commence par // est traite comme un commentaire et ignore, de
       mme que les sections de texte places 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 chanes. Elle ne doit pas comporter de guillemets. Le
       comportement du caractre barre oblique inverse "\" et les caractres
       utiliss avec squence d'chappement dans une valeur ne sont pas
       dterministes et devraient tre vits. Le nom d'une option peut contenir
       des caractres alphanumriques et << /-:._+ >>. On peut dclarer 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 crer une
       liste en ouvrant un champ d'action et en y insrant une chane entre
       guillemets suivie d'un point virgule pour chaque lment de la liste.

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

       Les modles /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 prcdent, on pourrait donc aussi bien utiliser
       dpkg::pre-install-pkgs.

       Les noms des lments de configuration sont optionnels si une liste est
       dfinie, comme cela peut se voir avec l'exemple DPkg::Pre-Install-Pkgs
       prcdent. Si vous n'indiquez pas de nom, une nouvelle entre ajoutera une
       nouvelle option  la liste. Dans le cas contraire, l'option
       correspondante peut tre remplace, comme toute autre option, en lui
       raffectant une valeur.

       Deux lments spciaux sont autoriss : #include (qui est obsolte et n'est
       plus gr par des implmentations alternatives) et #clear.  #include
       inclut le fichier donn en paramtre,  moins que le nom ne se termine par
       une barre oblique auquel cas le rpertoire entier est inclus.  #clear
       sert  effacer une partie de l'arbre de configuration. L'lment dsign et
       tout ses descendants sont supprims. Veuillez noter que ces lignes
       doivent galement se terminer avec un point-virgule.

       La commande #clear est la seule faon de supprimer une liste ou un champ
       d'action (<< scope >>). La rouverture d'un scope ou le style << ::- >>
       dcrit plus loin ne remplaceront pas les entres crites prcdemment.
       Seules les options peuvent tre remplaces en leur assignant une nouvelle
       valeur. Les listes et les champs d'action ne peuvent tre remplacs mais
       seulement effacs.

       Tous les outils d'APT possdent une option -o qui permet de spcifier 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 gal, puis par la nouvelle valeur de l'option. On
       peut complter une liste en ajoutant un << :: >> au nom de la liste.
       Comme on peut s'en douter, la syntaxe de champ d'action (<< scope >>)
       ne peut pas tre indique  la ligne de commande.

       Veuillez noter que vous ne pouvez utiliser << :: >> que pour ajouter un
       lment par ligne  la liste et que cela ne devrait pas tre utilis en
       combinaison avec la syntaxe de champ d'action (<< scope >>) qui inclut
       implicitement << :: >>. L'utilisation simultane des deux syntaxes
       dclenchera un bogue dont certains utilisateurs se servent comme d'une
       fonctionnalit : une option avec le nom inhabituel << :: >> se
       comportera comme toute autre option nomme. Cela risque d'avoir de
       nombreux problmes comme consquence, par exemple si un utilisateur crit
       plusieurs lignes avec cette syntaxe errone afin de faire un ajout  la
       liste, l'effet obtenu sera inverse puisque seule la dernire valeur pour
       l'option << :: >> sera utilise. Les futures versions d'APT retourneront
       une erreur et l'excution sera interrompue si cette utilisation
       incorrecte est rencontre. Il est donc conseill de corriger ces dfauts
       tant qu'APT ne s'en plaint pas explicitement.

LE GROUPE APT

       Ce groupe d'options contrle le comportement global d'APT et contient
       galement des options communes  tous les outils.

       Architecture
           L'architecture du systme ; cette option positionne l'architecture
           utiliser pour rcuprer des fichiers et analyser des listes de
           paquets. La valeur interne par dfaut est l'architecture pour
           laquelle APT a t compil.

       Default-Release
           Default release to install packages from if more than one version
           available. Contains release name, codename or release version.
           Examples: 'stable', 'testing', 'unstable', 'lenny', 'squeeze',
           '4.0', '5.0*'. See also apt_preferences(5).

       Ignore-Hold
           Ignore les paquets << gels >> ; cette option globale indique au
           systme de rsolution de ne pas tenir compte des paquets << gels >>
           dans sa prise de dcision.

       Clean-Installed
           Avec cette option qui est active par dfaut, la fonctionnalit
           << autoclean >> supprime du cache tout paquet qui ne peut plus tre
           rcupr. Quand cette option est dsactive, les paquets qui sont
           installs localement sont aussi exclus du nettoyage - mais notez que
           APT ne fournit aucun moyen direct pour les rinstaller.

       Immediate-Configure
           La valeur par dfaut de ce rglage est << on >> ce qui conduira APT
           installer les paquets essentiels et importants ds que possible
           pendant les oprations d'installation ou de mise  jour. Cela permet
           de limiter les consquences de l'chec d'un appel dpkg(1) : si cette
           option est dsactive, APT grera un paquet important de la mme manire
           qu'un paquet << extra >> ; entre le dpaquetage du paquet important
           A et sa configuration pourront prendre place de nombreux autres
           oprations de dpaquetage ou de configuration. Ainsi, si le paquet B,
           qui n'a pas de rapport avec A, provoque une erreur de dpkg(1)
           (p. ex. en cas d'erreur dans les scripts du responsable), le paquet
           A sera alors dans l'tat install mais non configur et chaque paquet
           qui en dpend ne fonctionnera plus ncessairement puisque sa
           dpendance n'est pas satisfaite. Le marqueur de configuration
           immdiate sera aussi utilis pour toute dpendance qui peut crer un
           problme, par exemple les dpendances circulaires. En effet, utiliser
           le marqueur de configuration immdiate revient  grer une
           pr-dpendance. Il est donc possible, en thorie, qu'APT rencontre une
           situation o il lui est impossible d'effectuer la configuration
           immdiate, qu'il se termine alors avec une erreur en faisant rfrence
           cette option afin que l'utilisateur puisse la dsactiver
           temporairement pour retenter l'opration d'installation ou de mise
           jour. Il est  noter que << en thorie >> indique ici que cette
           situation n'a t rencontre que dans de rares cas, sur des versions
           instables de distributions, la cause tant des dpendances
           incorrectes ou un systme dj dans un tat instable. Il est donc
           dconseill de dsactiver cette option sans rflchir car la situation
           dcrite prcdemment n'est qu'un des cas o la configuration immdiate
           permet de rsoudre des situations complexes. Avant de tenter une
           opration telle que dist-upgrade avec cette option dsactive, il est
           largement prfrable d'essayer une opration install sur le paquet
           qu'APT ne peut configurer immdiatement. Il est galement conseill de
           signaler ce type de problme dans le systme de suivi de bogues de la
           distribution utilise afin qu'il soit tudi et corrig.

       Force-LoopBreak
           Ne jamais activer cette option  moins que vous ne sachiez -
           rellement - 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 devrait jamais se produire : c'est
           un bogue trs important. Cette option fonctionne si les paquets
           essentiels ne sont pas tar, gzip, libc, dpkg, bash ou tous les
           paquets dont ces paquets dpendent.

       Cache-Start, Cache-Grow and Cache-Limit
           APT uses since version 0.7.26 a resizable memory mapped cache file
           to store the 'available' information.  Cache-Start acts as a hint
           to which size the Cache will grow and is therefore the amount of
           memory APT will request at startup. The default value is 20971520
           bytes (~20 MB). Note that these amount of space need to be
           available for APT otherwise it will likely fail ungracefully, so
           for memory restricted devices these value should be lowered while
           on systems with a lot of configured sources this might be
           increased.  Cache-Grow defines in byte with the default of 1048576
           (~1 MB) how much the Cache size will be increased in the event the
           space defined by Cache-Start is not enough. These value will be
           applied again and again until either the cache is big enough to
           store all information or the size of the cache reaches the
           Cache-Limit. The default of Cache-Limit is 0 which stands for no
           limit. If Cache-Grow is set to 0 the automatic grow of the cache is
           disabled.

       Build-Essential
           Cette option dfinit les paquets qui sont considrs comme faisant
           partie des dpendances essentielles pour la construction de paquets.

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

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

       CDROM
           La sous-section CDROM contrle 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 contrle le tlchargement des paquets et les
       gestionnaires d'URI.

       Check-Valid-Until
           Security related option defaulting to true as an expiring
           validation for a Release file prevents longtime replay attacks and
           can e.g. also help users to identify no longer updated mirrors -
           but the feature depends on the correctness of the time 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 volitional the following Max-ValidTime option can be used.

       Max-ValidTime
           Seconds the Release file should be considered valid after it was
           created. The default is "for ever" (0) if the Release file of the
           archive doesn't include a Valid-Until header. If it does then this
           date is the default. The date from the Release file or the date
           specified by the creation time of the Release file (Date header)
           plus the seconds specified with this options are used to check if
           the validation of a file has expired by using the earlier date of
           the two. Archive specific settings can be made by appending the
           label of the archive to the option name.

       PDiffs
           Essayer de tlcharger les fichiers diffrentiels appels PDiffs pour
           les paquets ou les fichiers sources, plutt que de les tlcharger
           entirement. Par dfaut  << true >>.

           Deux sous-options permettant de limite l'utilisation de fichiers
           << pdiff >> sont galement disponibles.  FileLimit permet d'indiquer
           le nombre maximal de fichiers de diffrences peuvent tre tlchargs
           pour modifier un fichier.  SizeLimit permet par ailleurs de limiter
           la taille combine des fichiers de diffrences rcuprs  un certain
           pourcentage du fichier  modifier. Si une de ces limites est dpasse,
           le fichier complet est tlcharg au lieu de tlcharger les fichiers de
           diffrences.

       Queue-Mode
           Mode de file d'attente ; Queue-Mode peut prendre les valeurs host
           ou access, ce qui dtermine comment APT paralllise les connexions
           sortantes.  Host signifie qu'une connexion par cible sera initie,
           tandis que access signifie qu'une connexion par type d'URI sera
           initie.

       Retries
           Nombre d'essais  effectuer. Si ce nombre n'est pas nul, APT essaie
           de rcuprer, le nombre donn de fois, les fichiers dont la rcupration
           a chou.

       Source-Symlinks
           Utilise des liens symboliques pour les archives de sources.
           Positionne  << true >>, cette option cre si possible des liens
           symboliques vers les archives de sources au lieu de les copier. Par
           dfaut  << true >>.

       http
           URI HTTP ; http::Proxy est le mandataire (proxy) HTTP  utiliser par
           dfaut. Il se prsente sous la forme standard :
           http://[[utilisateur][:mot_de_passe]@]hte[:port]/. On peut spcifier
           un mandataire particulier par hte distant en utilisant la syntaxe :
           http::Proxy::<hte>. Le mot-cl spcial DIRECT indique alors de
           n'utiliser aucun mandataire pour l'hte. Si aucun des paramtres
           prcdents n'est dfini, la variable d'environnement http_proxy annule
           et remplace toutes les options de mandataire HTTP.

           Trois options de configuration sont fournies pour le contrle des
           caches compatibles avec HTTP/1.1.  No-Cache signifie que le
           mandataire ne doit jamais utiliser les rponses qu'il a stockes ;
           Max-Age sert uniquement pour les fichiers d'index : cela demande au
           cache de les mettre  jour quand leur anciennet est suprieure au
           nombre de secondes donn. Debian met  jour ses fichiers d'index de
           manire quotidienne ; la valeur par dfaut est donc de 1 jour.
           No-Store sert uniquement pour les fichiers d'archive et demande au
           cache de ne jamais garder la requte. Cela peut viter de polluer un
           cache mandataire avec des fichiers .deb trs grands. Note : Squid
           2.0.2 ne prend en compte aucune de ces options.

           L'option timeout positionne le compteur d'expiration du dlai
           (timeout) utilis par la mthode. Cela vaut pour tout, connexion et
           donnes.

           Une option de configuration est fournie pour contrler la profondeur
           du tube pour le cas o un serveur distant n'est pas conforme  la RFC
           ou est bogu (comme Squid 2.0.2).  Acquire::http::Pipeline-Depth a
           une valeur comprise entre 0 et 5 : elle indique le nombre de
           requtes en attente qui peuvent tre mises. Quand la machine distante
           ne conserve pas correctement les connexions TCP, la valeur doit
           gale  0. Dans le cas contraire, des donnes seront corrompues. Les
           machines qui ont besoin de cette option ne respectent pas la RFC
           2068.

           La bande passante utilise peut tre limit avec
           Acquire::http::Dl-Limit qui peut prendre une valeur entire, l'unit
           utilise tant le kilo-octet. La valeur par dfaut est 0, ce qui
           correspond  aucune limitation de bande passante. Veuillez noter que
           cette option dsactive implicitement le tlchargement simultan depuis
           plusieurs serveurs.

           L'option Acquire::http::User-Agent peut tre utilise pour envoyer
           une valeur User-Agent modifie pour les tlchargements HTTP, ce qui
           peut par exemple tre utile avec certains mandataires HTTP qui
           n'autorisent l'accs qu'aux client s'identifiant de manire
           spcifique..

       https
           URI HTTPS. Les options de contrle de cache, de dlai limite,
           d'autorisation de redirection, de Dl-Limit et de mandataire (proxy)
           sont les mmes que pour la mthode http. Les valeurs par dfaut sont
           les mmes que pour l'option http sauf si des valeurs spcifiques
           https sont indiques. L'option Pipeline-Depth n'est pas encore gre.

           La sous-option CaInfo spcifie le fichier contenant les informations
           sur les certificats de confiance. La sous-option boolenne
           Verify-Peer prcise si le certificat d'hte du serveur doit tre
           confront aux certificats de confiance ou pas. La sous-option
           boolenne Verify-Host prcise s'il faut vrifier ou pas le nom d'hte
           du serveur.  SslCert dtermine le certificat  utiliser pour
           l'authentification du client.  SslKey dtermine quelle clef prive
           doit tre utilise pour l'authentification du client.
           SslForceVersion surcharge la valeur par dfaut pour la version de
           SSL  utiliser et peut contenir l'une des chanes 'TLSv1' ou 'SSLv3'.

       ftp
           URI FTP ; ftp::Proxy est le mandataire (proxy) FTP  utiliser par
           dfaut. Il se prsente sous la forme standard :
           ftp://[[user][:pass]@]host[:port]/. On peut spcifier un mandataire
           particulier par hte distant en utilisant la syntaxe :
           ftp::Proxy::<hte>. Le mot-cl spcial DIRECT indique alors de
           n'utiliser aucun mandataire pour l'hte. Si aucun des paramtres
           prcdents n'est dfinis, la variable d'environnement ftp_proxy annule
           et replace toutes les options de mandataire FTP. Pour utiliser un
           mandataire FTP, vous devrez renseigner l'entre ftp::ProxyLogin dans
           le fichier de configuration. Cette entre spcifie les commandes
           envoyer au mandataire pour lui prciser  quoi il doit se connecter.
           Voyez /usr/share/doc/apt/examples/configure-index.gz pour savoir
           comment faire. Les variables de substitution disponibles sont :
           $(PROXY_USER), $(PROXY_PASS), $(SITE_USER), $(SITE_PASS), $(SITE)
           et $(SITE_PORT). Chacune correspond  l'lment respectif de l'URI.

           L'option timeout positionne le compteur d'expiration du dlai
           (timeout) utilis par la mthode. Cela vaut pour tout, connexion et
           donnes.

           Plusieurs options de configuration sont fournies pour contrler le
           mode passif. Il est gnralement plus sr d'activer le mode passif et
           cela marche dans presque tous les environnements. Cependant,
           certaines situations ncessitent que le mode passif soit dsactiv 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 spcifique (examinez le modle 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 mthode http ci-dessus pour la
           syntaxe. On ne peut pas le faire dans le fichier de configuration
           et il n'est de toute faon pas recommand d'utiliser FTP au travers
           de HTTP en raison de la faible efficacit de cette mthode.

           L'option ForceExtended contrle l'utilisation des commandes lies  la
           RFC 2428, EPSV et EPRT. Par dfaut, elle vaut << false >> ce qui
           signifie que ces commandes ne sont utilises que pour une connexion
           de type IPv6. Quand elle vaut << true >>, on les utilise mme 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 reprsenter le point de
           montage du lecteur de CD-ROM indiqu dans /etc/fstab. D'autres
           commandes de montage et de dmontage peuvent tre fournies 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 dmontage peuvent tre spcifies en utilisant UMount.

       gpgv
           URI GPGV ; la seule option pour les URI GPGV est celle qui permet
           de passer des paramtres  gpgv.  gpgv::Options : options
           supplmentaires passes  gpgv.

       CompressionTypes
           Cette option indique la liste des types de compression comprises
           par les mthodes d'acquisition. Des fichiers comme Packages peuvent
           tre disponibles dans divers formats de compression. Par dfaut, les
           mthodes d'acquisition dcompressent les fichiers compresss avec
           bzip2, lzma et gzip. Ce rglage permet d'ajouter  la vole des
           formats supplmentaires ou de modifier la mthode utilise. La syntaxe
           utiliser est :

               Acquire::CompressionTypes::ExtensionFichier "NomMethode";

           Le sous-groupe Order peut tre galement utilis pour dfinir l'ordre
           dans lequel le systme d'acquisition tentera de tlcharger les
           fichiers compresss. Le premier systme mentionn sera essay en
           premier, puis le suivant en cas d'chec. Ainsi, pour privilgier un
           format par rapport  un autre, il suffit de le placer en premier
           dans cette liste. Les types par dfaut qui ne sont pas dj indiqus
           seront ajouts en fin de liste au moment de l'excution. Ainsi, par
           exemple,

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

           peut tre utiliser de prfrence les fichiers compresss avec gzip par
           rapport bzip2 et lzma. Si l'objectif est d'utiliser lzma en priorit
           par rapport gzip et bzip2, ce rglage doit ressembler

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

           . Il est inutile d'ajouter explicitement bz2
            liste car il sera ajout automatiquement.

           Veuillez noter qu' l'excution, Dir::Bin::Methodname sera vrifi : si
           ce rglage existe, la mthode ne sera utilise que si ce fichier
           existe. Ainsi, pour la mthode bzip2, le rglage (utilis en interne)
           est

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

           . Veuillez galement noter que les lments de liste indiqus  la ligne
           de commande seront ajouts  la fin de la liste indique dans les
           fichiers de configuration, mais avant les valeurs par dfaut. Dans
           ce cas, pour tablir une prfrence par rapport aux types mentionns
           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 dfaut mais elle sera simplement prfixe avec
           l'option en question.

           Bien qu'il soit possible d'ajouter un type vide de compression  la
           liste ordonne, APT ne l'interprtera pas correctement et affichera
           de nombreux messages d'avertissement  propos d'chec de
           tlchargement, qui sont le plus souvent des avertissements sans
           consquences. Dans de futures versions, il deviendra rellement
           possible d'tablir une prfrence pour des fichiers non compresss afin
           de grer des miroirs locaux.

       GzipIndexes
           When downloading gzip compressed indexes (Packages, Sources, or
           Translations), keep them gzip compressed locally instead of
           unpacking them. This saves quite a lot of disk space at the expense
           of more CPU requirements when building the local package caches.
           False by default.

       Langues
           La sous-section << Languages >> contrle quels fichiers Translation
           sont tlchargs et dans quel ordre APT les utilisera pour afficher
           les traductions de descriptions. APT recherchera d'abord la premire
           traduction disponible pour le champ Description dans la langue
           choisie en premier. Les langues peuvent tre indiques par leur code
           long ou court. Veuillez noter que tous les dpts ne fournissent pas
           les fichiers Translation pour toutes les langues, particulirement
           pour les codes rarement utiliss. Il est donc conseill de vous
           renseigner sur ce qui est disponible avant d'tablir des rglages
           impossibles.

           La liste par dfaut contient << environment >> and << en >>. La
           valeur << environment >> a une signification spciale : elle sera
           remplace,  l'excution, par les codes de langues utiliss dans la
           variable d'environnement LC_MESSAGES. Les codes utiliss en double
           ne seront pas inclus deux fois dans la liste. Si LC_MESSAGES
           contient << C >>, seul le fichier Translation-en sera utilis, s'il
           est disponible. Pour forcer APT  n'utiliser aucun fichier de
           traduction, il est ncessaire d'utiliser le rglage
           Acquire::Languages=none. La valeur << none >> a une signification
           spciale et indique de ne rechercher aucun fichier Translation. Cela
           permet  l'administrateur local d'indiquer  APT de tlcharger des
           fichiers sans les utiliser si la variable d'environnement ne les
           comporte pas. Ainsi, dans l'exemple qui suit, l'ordre utilis sera
           << en, fr >> si dans un environnement configur pour l'anglais et
           << fr, en >> pour un environnement configur en franais. Les
           fichiers pour l'allemand seront galement tlchargs mais ne sont
           utiliss que dans un environnement configur pour l'allemand. Dans ce
           dernier cas, l'ordre est alors << de, fr, en >>.

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

LES RPERTOIRES

       Les rpertoires de la section Dir::State concernent le systme local.
       lists est le rpertoire o placer les listes de paquets tlchargs et
       status est le nom du fichier d'tat de dpkg(1).  preferences concerne
       APT : c'est le nom du fichier des prfrences.  Dir::State contient le
       rpertoire par dfaut prfix  tous les sous-lments, 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 o sont places les archives tlcharges,
       Dir::Cache::archives. On peut empcher la cration des caches en
       saisissant un nom vide. Cela ralentit le dmarrage mais conomise de
       l'espace disque. Il vaut mieux se passer du cache pkgcache plutt que se
       passer du cache srcpkgcache. Comme pour Dir::State, le rpertoire par
       dfaut 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 dfaut (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'entre, tous les fragments de configuration
       dans le rpertoire indiqu. Ensuite, le fichier principal de
       configuration est charg.

       Les programmes binaires sont points par Dir::Bin. L'emplacement des
       gestionnaires de mthodes est indiqu 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 particulire.
       Lorsqu'elle est dfinie, tous les chemins dclars dans Dir:: sont
       considrs relativement RootDir, mme les chemins spcifis de manire
       absolue. Ainsi par exemple si RootDir est dfini comme /tmp/staging, et
       que chemin du fichier d'tat Dir::State::status est dclar comme
       /var/lib/dpkg/status alors ce fichier sera cherch dans
       /tmp/staging/var/lib/dpkg/status.

       The Ignore-Files-Silently list can be used to specify which files APT
       should silently ignore while parsing the files in the fragment
       directories. Per default a file which end with .disabled, ~, .bak or
       .dpkg-[a-z]+ is silently ignored. As seen in the last default value
       these patterns can use regular expression syntax.

APT ET DSELECT

       Quand APT est utilis comme une mthode de dselect(1), plusieurs
       directives contrlent le comportement par dfaut. 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 aprs la mise  niveau ;
           << prompt >> (valeur par dfaut) les supprime aprs une demande et
           << auto >> ne supprime que les archives qui ne peuvent plus tre
           tlcharges (remplaces, par exemple, par une nouvelle version).
           << pre-auto >> les supprime avant de rcuprer 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'opration [U]pdate de dselect(1)
           interroge toujours l'utilisateur avant de continuer. Par dfaut, ce
           n'est qu'en cas d'erreur que l'on propose  l'utilisateur
           d'intervenir.

METHODE D'APPEL DE DPKG PAR APT

       Plusieurs directives de configuration contrlent la manire 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 dclares en utilisant la notation de liste et chaque
           lment de la liste est pass comme un seul paramtre dpkg(1).

       Pre-Invoke, Post-Invoke
           Il s'agit d'une liste de commandes shell  excuter avant ou aprs
           l'appel de dpkg(1). Tout comme pour Options, on doit utiliser la
           notation de liste. Les commandes sont appeles dans l'ordre, en
           utilisant /bin/sh : APT s'arrte ds que l'une d'elles choue.

       Pre-Install-Pkgs
           Il s'agit d'une liste de commandes shell  excuter avant d'appeler
           dpkg(1). Tout comme pour Options, on doit utiliser la notation de
           liste. Les commandes sont appeles dans l'ordre, en utilisant
           /bin/sh : APT s'arrte ds que l'une d'elles choue. Sur l'entre
           standard, APT transmet aux commandes les noms de tous les fichiers
           .deb qu'il va installer,  raison d'un par ligne.

           La deuxime 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 passe Pre-Install-Pkgs.

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

       Build-options
           Ces options sont passes dpkg-buildpackage(1) lors de la compilation
           des paquets ; par dfaut la signature est dsactive et tous les
           binaires sont crs.

   utilisation des actions diffres (<< triggers >>) de dpkg (et options
       associes)
       APT peut lancer dpkg pour utiliser les actions diffres de manire
       agressive entre les appels successifs  dpkg. Sans options
       supplmentaires, dpkg n'utilisera les actions diffres que dans le cadre
       de sa propre excution. Si ces options sont utilises, le temps
       d'excution peut diminuer fortement dans les actions d'installation ou
       de mise  jour. Il est prvu de les activer par dfaut dans le futur mais
       tant donn qu'elles changent notablement la mthode qu'utilise APT pour
       lancer dpkg, elles ont besoin d'importantes validations.  Ces options
       sont donc exprimentales et ne devraient pas tre utilises avec des
       environnements de production.. Elles modifient galement le suivi de
       progression et toutes les interfaces passeront la moiti du temps  un
       tat termin  100% pendant la configuration des paquets.

       Veuillez noter que rien ne garantit qu'APT grera encore ces options
       dans le futur ou qu'elles ne provoqueront pas de nombreux dgts. Si vous
       avez bien compris les implications de ce choix et tes suffisamment
       motiv(e) pour essayer ces options, il vous est donc possible de crer un
       nouveau fichier de configuration et essayer une combinaison de ces
       options. Veuillez signaler tout bogue, problmes ou suggestions
       d'amlioration en prenant soin de mentionner les options utilises.
       Utiliser l'aide apporte par dpkg peut galement tre utile pour le
       dbogage, par exemple dpkg --audit. Une combinaison intressante
       d'options pourrait tre

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

       .

       DPkg::NoTriggers
           Ajoute l'option << no-triggers >>  tous les appels  dpkg (hormis
           l'appel << ConfigurePending >>). Voir dpkg(1) pour plus
           d'informations sur la signification de cette option. En rsum, dpkg
           n'effectuera pas les actions diffres (<< triggers >>) si cette
           option est utilise sauf si cela est demand explicitement dans une
           invocation supplmentaire. Cette option existe en fait dj (mais
           n'est pas documente) dans de plus anciennes version d'APT avec une
           signification lgrement diffrente : elle n'ajoutait l'option
           << --no-triggers >> qu'aux appels de dpkg avec << configure >>
           alors que cela sera dsormais utilis galement avec les appels  dpkg
           avec les options << unpack >> et << remove >>.

       PackageManager::Configure
           Les valeurs possibles sont << all >>, << smart >> et << no >>. La
           valeur par dfaut est << all >> o APT configure explicitement tous
           les paquets. La valeur << smart >> permet de ne configurer que les
           paquets qui ont besoin de l'tre avant la dcompaction d'un autre
           paquet ( cause d'une pr-dpendance) ; les autres configurations sont
           laisses pour un appel ultrieur  dpkg. L'option << no >> ne
           provoquera aucune configuration et s'en remettra totalement  dpkg
           pour ces oprations (ce qui chouera en cas de pr-dpendances). Si
           cette option est dfinie sur une valeur diffrente de << all >>,
           l'option suivante sera active par dfaut pour viter de placer le
           systme dans un tat non configur et donc ventuellement non amorable.

       DPkg::ConfigurePending
           Si cette option est choisie, APT lancera dpkg --configure --pending
           pour laisser dpkg grer les configurations de paquets et les actions
           diffres. Cette option est automatiquement active si l'option
           prcdente a une valeur diffrente de << all >>. Il peut par contre
           tre utile de la dsactiver pour lancer APT plusieurs fois
           successives, par exemple quand il est utilis depuis un outil
           d'installation. Dans ce cas, seul le dernier de tous les appels
           successifs peut conserver l'option active.

       DPkg::TriggersPending
           Cette option est utile pour la configuration en mode << smart >>.
           En effet, un paquet qui a des actions diffres (<< triggers >>) en
           attente n'est pas considr comme install (tat << installed >>) et
           dpkg le considre actuellement comme simplement dcompact (tat
           << unpacked >>) ce qui empche une gestion correcte des
           pr-dpendances (voir le bogue Debian #526774). Veuillez noter que
           cette option provoquera la gestion de toutes les actions diffres,
           pas seulement celles concernant le paquet en cours de traitement.

       PackageManager::UnpackAll
           Cette option permet de ne trier les oprations de dcompactage qu'en
           fonction de leur criticit (c'est  dire en ne considrant que les
           pr-dpendances) dans le cas o la configuration des paquets est
           diffre pour n'tre effectue qu' la fin par dpkg. Cette option est
           active par dfaut, ce qui revient  la mthode traditionnelle o les
           oprations ont lieu en plusieurs tapes, selon l'ensemble des critres
           de tri. Bien que les deux mthodes existent mme dans les versions,
           la mthode << OrderCritical >> n'tait pas utilise. Elle doit donc
           tre considre comme trs exprimentale et a besoin de nombreuses
           amliorations avant de devenir rellement utile. (Note du
           traducteur : la version originale de cette partie des pages de
           manuel est trs confuse. Il est donc conseill de s'y reporter en cas
           de doute car le contresens de traduction n'est pas exclu...).

       OrderList::Score::Immediate
           Les paquets essentiels (et leurs dpendances) devraient tre
           configurs aprs avoir t dcompresss. Il est conseill que cette
           opration ait lieu le plus tt possible dans le processus de mise
           jour car ces oprations de configuration ncessitent galement
           DPkg::TriggersPending, ce qui peut conduire  l'excution de certains
           actions diffres qui ne sont pas ncessairement utiles. Les paquets
           essentiels obtiennent par dfaut un score lev mais le marqueur
           << immdiat >> implique un score assez bas (par exemple un paquet
           qui comporte des prdpendances obtient un score plus lev). Cette
           option et les options du mme groupe permettent de modifier la faon
           d'attribuer un score. L'exemple ci-dessous indique ces rglages avec
           leurs valeurs par dfaut.

               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 priodiques raliss par le script /etc/cron.daily/apt, lanc
       quotidiennement.

LES OPTIONS DE DBOGAGE

       Les options de la section Debug:: servent soit  provoquer l'affichage
       d'informations de dbogage sur la sortie d'erreur standard du programme
       qui utilise les librairies APT, soit  activer des modes de
       fonctionnement spciaux qui sont principalement utiles pour dboguer le
       comportement de APT. La plupart de ces options n'ont pas d'intrt pour
       un utilisateur normal, mais certaines peuvent tout de mme tre utiles :

       o    Debug::pkgProblemResolver affiche d'intressantes informations sur
           les dcisions prises par les commandes dist-upgrade, upgrade,
           install, remove et purge.

       o    Debug::NoLocking dsactive le verrouillage de fichier de manire  ce
           qu'APT puisse effectuer quelques oprations (telles que apt-get -s
           install) sans avoir les privilges du superutilisateur.

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

       o

           Debug::IdentCdrom dsactive l'inclusion de donnes de type statfs
           dans les identifiants de CD.

       Liste complte des options de dbogage de APT :

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

       Debug::Acquire::ftp
           Affiche les informations concernant le tlchargement de paquets par
           FTP.

       Debug::Acquire::http
           Affiche les informations concernant le tlchargement de paquets par
           HTTP.

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

       Debug::Acquire::gpgv
           Affiche les informations relatives  la vrification de signatures
           cryptographiques avec gpg.

       Debug::aptcdrom
           Affiche des informations concernant l'accs aux collections de
           paquets stockes sur CD.

       Debug::BuildDeps
           Dcrit le processus de rsolution des dpendances pour la construction
           de paquets source ( << build-dependencies >> ) par apt-get(8).

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

       Debug::IdentCDROM
           Dsactive l'inclusion des donnes de type statfs pour la gnration des
           identifiants de CD, c'est--dire le nombre de blocs libres et
           utiliss sur le systme de fichier du CD.

       Debug::NoLocking
           Dsactive le verrouillage de fichiers. Cela permet par exemple de
           lancer deux instances de "apt-get update" en mme temps.

       Debug::pkgAcquire
           Trace les ajouts et suppressions d'lments de la queue globale de
           tlchargement.

       Debug::pkgAcquire::Auth
           Affiche les dtails de la vrification des sommes de contrle et des
           signatures cryptographiques des fichiers tlchargs, ainsi que les
           erreurs ventuelles.

       Debug::pkgAcquire::Diffs
           Affiche les informations de tlchargement et de prise en compte des
           fichiers diffrentiels des indexes de paquets, ainsi que les erreurs
           ventuelles.

       Debug::pkgAcquire::RRed
           Affiche les dtails de l'application des fichiers de diffrences aux
           listes de paquets d'APT quand ces fichiers de diffrences sont
           tlchargs  la place des fichiers complets.

       Debug::pkgAcquire::Worker
           Affiche toutes les interactions avec les processus enfants qui se
           chargent effectivement des tlchargements.

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

       Debug::pkgDepCache::AutoInstall
           Cre les informations de dbogage dcrivant quels paquets sont
           installs automatiquement pour satisfaire les dpendances. Cela
           concerne la passe initiale d'installation automatique effectue par
           exemple par apt-get install et pas le systme de rsolution de
           dpendances complet de APT ; voir Debug::pkgProblemResolver pour ce
           dernier.

       Debug::pkgDepCache::Marker
           Cre les informations de dbogage dcrivant quels paquets sont
           gards/installs/supprims pendant le travail de l'outil de rsolution
           de problmes. Chaque ajout ou suppression peut impliquer des actions
           supplmentaires ; elles sont alors indiques avec une indentation de
           deux espaces de plus que l'action qui les a dclenches. 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 installe et
           x.y.z une version plus rcente qui n'est pas prvue pour tre installe
           ( cause d'un score plus faible). Ces deux derniers lments peuvent
           ne pas tre mentionns s'ils ne sont pas pertinents o lorsque ils
           sont identiques  la version installe.  section est le nom de la
           section o figure le paquet.automatiquement pour satisfaire les
           dpendances. Cela concerne la passe initiale d'installation
           automatique effectue par exemple par apt-get install et pas le
           systme de rsolution de dpendances 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 paramtres sont spars par des espaces.

       Debug::pkgDPkgProgressReporting
           Affiche l'ensemble des informations reues de dpkg(1) par
           l'intermdiaire 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 dtail des oprations lies  l'invocation de dpkg(1).

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

       Debug::pkgProblemResolver
           Affiche la trace d'excution du systme de rsolution de dpendances
           (ne concerne que les cas o un problme de dpendances complexe se
           prsente).

       Debug::pkgProblemResolver::ShowScores
           Affiche la liste de tous les paquets installs avec leur score
           calcul par l'outil de rsolution de problmes. La description du
           paquet est celle qui est dcrite dans Debug::pkgDepCache::Marker.

       Debug::sourceList
           Affiche les fournisseurs dclars dans le fichier
           /etc/apt/vendors.list.

EXEMPLES

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

FICHIERS

       /etc/apt/apt.conf
           Fichier de configuration d'APT. lment de configuration :
           Dir::Etc::Main.

       /etc/apt/apt.conf.D/
           Fragments du fichier de configuration d'APT. lment 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  propos
       d'APT, veuillez lire /usr/share/doc/debian/bug-reporting.txt ou
       utiliser la commande reportbug(1).

TRADUCTEURS

       Jrme Marant, Philippe Batailler, Christian Perrier bubulle@debian.org
       (2000, 2005, 2009, 2010), quipe de traduction francophone de Debian
       debian-l10n-french@lists.debian.org

       Veuillez noter que cette traduction peut contenir des parties non
       traduites Cela est volontaire, pour viter de perdre du contenu quand la
       traduction est lgrement en retard sur le contenu d'origine.

AUTHORS

       Jason Gunthorpe

       quipe de dveloppement 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