Provided by: apt_0.8.16~exp12ubuntu10_i386 bug

NAME

       apt.conf - Fichier de configuration pour APT

DESCRIPTION

       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 ou
       des choix d'options peuvent etre effectues. Tous les outils partagent
       les fichiers de configuration et utilisent egalement 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 utilise, il lit le fichier de
       configuration dans l'ordre suivant :

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

        2. all files in Dir::Etc::Parts in alphanumeric ascending order which
           have either no or "conf" as filename extension and which only
           contain alphanumeric, hyphen (-), underscore (_) and period (.)
           characters. Otherwise APT will print a notice that it has ignored a
           file if the file doesn't match a pattern in the
           Dir::Ignore-Files-Silently configuration list - in this case it
           will be silently ignored.

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

        4. 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++. 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 chaines. Elle ne doit pas
       comporter de guillemets. Le comportement du caractere barre oblique
       inversee "\" et les caracteres utilises avec sequence d'echappement
       dans une valeur ne sont pas deterministes et devraient etre evites. Le
       nom d'une option peut contenir 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 pour chaque element de la
       liste.

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

       Les modeles /usr/share/doc/apt/examples/apt.conf et
       /usr/share/doc/apt/examples/configure-index.gz 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 tout ses descendants sont supprimes. Veuillez
       noter que ces lignes doivent egalement se terminer avec 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. Seules les options peuvent etre remplacees en leur
       assignant 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 << :: >> 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 erron'ee 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
           All Architectures the system supports. Processors implementing the
           amd64 are e.g. also able to execute binaries compiled for i386;
           This list is use when fetching files and parsing package lists. The
           internal default is always the native architecture
           (APT::Architecture) and all foreign architectures it can retrieve
           by calling dpkg --print-foreign-architectures.

       Default-Release
           Indique 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 >>, << squeeze >>,
           << wheezy >>, << 4.0 >>, << 5.0* >>. Voir aussi apt_preferences(5).

       Ignore-Hold
           Ignore les paquets << geles >> ; cette option globale indique au
           systeme de resolution 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 de ce reglage est << on >> ce qui conduira APT
           a installer les paquets essentiels et importants des que possible
           pendant les operations d'installation ou de mise a jour. Cela
           permet de limiter les consequences de l'echec d'un appel a
           dpkg(1) : si cette option est desactivee, APT gerera un paquet
           important de la meme maniere qu'un paquet << extra >> ; entre le
           depaquetage du paquet important A et sa configuration pourront
           prendre place de nombreux autres operations de depaquetage 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'etat
           installe mais non configure et chaque paquet qui en depend ne
           fonctionnera plus necessairement puisque sa dependance n'est pas
           satisfaite. Le marqueur de configuration immediate sera aussi
           utilise pour toute dependance qui peut creer un probleme, par
           exemple les dependances circulaires. En effet, utiliser le marqueur
           de configuration immediate revient a gerer une pre-dependance. Il
           est donc possible, en theorie, qu'APT rencontre une situation ou il
           lui est impossible d'effectuer la configuration immediate, qu'il se
           termine alors avec une erreur en faisant reference a cette option
           afin que l'utilisateur puisse la desactiver temporairement pour
           retenter l'operation d'installation ou de mise a jour. Il est a
           noter que << en theorie >> indique ici que cette situation n'a ete
           rencontree que dans de rares cas, sur des versions instables de
           distributions, la cause etant des dependances incorrectes ou un
           systeme deja dans un etat instable. Il est donc deconseille de
           desactiver cette option sans reflechir car la situation decrite
           precedemment n'est qu'un des cas ou la configuration immediate
           permet de resoudre des situations complexes. Avant de tenter une
           operation telle que dist-upgrade avec cette option desactivee, il
           est largement preferable d'essayer une operation install sur le
           paquet qu'APT ne peut configurer immediatement. Il est egalement
           conseille de signaler ce type de probleme dans le systeme de suivi
           de bogues de la distribution utilisee afin qu'il soit etudie et
           corrige.

       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, bash ou tous les
           paquets dont ces paquets dependent.

       Cache-Start, Cache-Grow et 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.

LE GROUPE ACQUIRE

       Le groupe d'options Acquire controle le telechargement des paquets et
       les gestionnaires d'URI.

       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 << longtime 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, la valeur du parametre Max-ValidTime est alors utilisee.

       Max-ValidTime
           Seconds the Release file should be considered valid after it was
           created (indicated by the Date header). If the Release file itself
           includes a Valid-Until header the earlier date of the two is used
           as the expiration date. The default value is 0 which stands for
           "for ever". Archive specific settings can be made by appending the
           label of the archive to the option name.

       Min-ValidTime
           Minimum of seconds the Release file should be considered valid
           after it was created (indicated by the Date header). Use this if
           you need to use a seldomly updated (local) mirror of a more regular
           updated archive with a Valid-Until header instead of completely
           disabling the expiration date checking. Archive specific settings
           can and should be used by appending the label of the archive to the
           option name.

       PDiffs
           Essayer de telecharger les fichiers differentiels appeles PDiffs
           pour les paquets ou les fichiers sources, plutot que de les
           telecharger entierement. Par defaut a << true >>.

           Two sub-options to limit the use of PDiffs are also available: With
           FileLimit can be specified how many PDiff files are downloaded at
           most to patch a file.  SizeLimit on the other hand is the maximum
           percentage of the size of all patches compared to the size of the
           targeted file. If one of these limits is exceeded the complete file
           is downloaded instead of the patches.

       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
           URI HTTP ; http::Proxy est le mandataire (proxy) HTTP a utiliser
           par defaut. Il se presente sous la forme standard :
           http://[[utilisateur][:mot_de_passe]@]hote[:port]/. On peut
           specifier un mandataire particulier par hote distant en utilisant
           la syntaxe : http::Proxy::<hote>. Le mot-cle special DIRECT indique
           alors de n'utiliser aucun mandataire pour l'hote. Si aucun des
           parametres precedents n'est defini, la variable d'environnement
           http_proxy annule et remplace toutes les options de mandataire
           HTTP.

           Trois options de configuration sont fournies pour le controle des
           caches compatibles avec HTTP/1.1.  No-Cache signifie que le
           mandataire ne doit jamais utiliser les reponses qu'il a stockees ;
           Max-Age sert uniquement pour les fichiers d'index : cela demande au
           cache de les mettre a jour quand leur anciennete est superieure au
           nombre de secondes donne. Debian met a jour ses fichiers d'index de
           maniere quotidienne ; la valeur par defaut est donc de 1 jour.
           No-Store sert uniquement pour les fichiers d'archive et demande au
           cache de ne jamais garder la requete. Cela peut eviter de polluer
           un cache mandataire avec des fichiers .deb tres grands. Note :
           Squid 2.0.2 ne prend en compte aucune de ces options.

           L'option timeout positionne le compteur d'expiration du delai
           (timeout) utilise par la methode. Cela vaut pour tout, connexion et
           donnees.

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

           La bande passante utilisee peut etre limite avec
           Acquire::http::Dl-Limit qui peut prendre une valeur entiere,
           l'unite utilisee etant le kilo-octet. La valeur par defaut est 0,
           ce qui correspond a aucune limitation de bande passante. Veuillez
           noter que cette option desactive implicitement le telechargement
           simultane depuis plusieurs serveurs.

           L'option Acquire::http::User-Agent peut etre utilisee pour envoyer
           une valeur User-Agent modifiee pour les telechargements HTTP, ce
           qui peut par exemple etre utile avec certains mandataires HTTP qui
           n'autorisent l'acces qu'aux client s'identifiant de maniere
           specifique..

       https
           URI HTTPS. Les options de controle de cache, de delai limite,
           d'autorisation de redirection, de Dl-Limit et de mandataire (proxy)
           sont les memes que pour la methode http. Les valeurs par defaut
           sont les memes que pour l'option http sauf si des valeurs
           specifiques a https sont indiquees. L'option Pipeline-Depth n'est
           pas encore geree.

           La sous-option CaInfo specifie le fichier contenant les
           informations sur les certificats de confiance. La sous-option
           booleenne Verify-Peer precise si le certificat d'hote du serveur
           doit etre confronte aux certificats de confiance ou pas. La
           sous-option booleenne Verify-Host precise s'il faut verifier ou pas
           le nom d'hote du serveur.  SslCert determine le certificat a
           utiliser pour l'authentification du client.  SslKey determine
           quelle clef privee doit etre utilisee pour l'authentification du
           client.  SslForceVersion surcharge la valeur par defaut pour la
           version de SSL a utiliser et peut contenir l'une des chaines
           'TLSv1' ou 'SSLv3'.

       ftp
           URI FTP ; ftp::Proxy est le mandataire (proxy) FTP a utiliser par
           defaut. Il se presente sous la forme standard :
           ftp://[[user][:pass]@]host[:port]/. On peut specifier un mandataire
           particulier par hote distant en utilisant la syntaxe :
           ftp::Proxy::<hote>. Le mot-cle special DIRECT indique alors de
           n'utiliser aucun mandataire pour l'hote. Si aucun des parametres
           precedents n'est definis, la variable d'environnement ftp_proxy
           annule et replace toutes les options de mandataire FTP. Pour
           utiliser un mandataire FTP, vous devrez renseigner l'entree
           ftp::ProxyLogin dans le fichier de configuration. Cette entree
           specifie les commandes a envoyer au mandataire pour lui preciser a
           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 a l'element respectif de l'URI.

           L'option timeout positionne le compteur d'expiration du delai
           (timeout) utilise par la methode. Cela vaut pour tout, connexion et
           donnees.

           Plusieurs options de configuration sont fournies pour controler le
           mode passif. Il est generalement plus sur d'activer le mode passif
           et cela marche dans presque tous les environnements. Cependant,
           certaines situations necessitent que le mode passif soit desactive
           et que le mode << port >> de ftp soit utilise a la place. On peut
           le faire globalement, pour des connexions qui passent par un
           mandataire ou pour une machine specifique (examinez le modele 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 a une
           URL HTTP -- consultez la methode http ci-dessus pour la syntaxe. On
           ne peut pas le faire dans le fichier de configuration et il n'est
           de toute facon pas recommande d'utiliser FTP au travers de HTTP en
           raison de la faible efficacite de cette methode.

           L'option ForceExtended controle l'utilisation des commandes liees a
           la RFC 2428, EPSV et EPRT. Par defaut, elle vaut << false >> ce qui
           signifie que ces commandes ne sont utilisees que pour une connexion
           de type IPv6. Quand elle vaut << true >>, on les utilise meme 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 representer le point de
           montage du lecteur de CD-ROM 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 (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 demontage peuvent etre specifiees en utilisant UMount.

       gpgv
           URI GPGV ; la seule option pour les URI GPGV est celle qui permet
           de passer des parametres a gpgv.  gpgv::Options : options
           supplementaires passees 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 les fichiers compresses
           avec bzip2, lzma et gzip. Ce reglage permet d'ajouter a la volee
           des formats supplementaires ou de modifier la methode utilisee. 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 par defaut qui ne sont pas deja
           indiques seront ajoutes en fin de liste au moment de l'execution.
           Ainsi, par exemple,

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

           peut etre utiliser de preference les fichiers compresses avec gzip
           par rapport a bzip2 et lzma. Si l'objectif est d'utiliser lzma en
           priorite par rapport a gzip et bzip2, ce reglage doit ressembler a

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

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

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

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

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

           The special type uncompressed can be used to give uncompressed
           files a preference, but note that most archives don't provide
           uncompressed files so this is mostly only useable for local
           mirrors.

       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 : Faux (<< False >>).

       Langues
           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,
           particulierement pour les codes rarement utilises. Il est donc
           conseille de vous renseigner sur ce qui est disponible avant
           d'etablir des reglages impossibles.

           La liste par defaut contient << environment >> and << 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 permet a l'administrateur local d'indiquer a APT de
           telecharger des fichiers sans les utiliser si la variable
           d'environnement ne les comporte pas. 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"; };

LES R'ePERTOIRES

       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 des 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 saisissant un nom vide. 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 declares dans Dir:: sont
       consideres relativement a RootDir, m^eme les chemins sp'ecifi'es de
       mani`ere absolue. Ainsi 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.

       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.

M'eTHODE D'APPEL 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).

       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. Sur l'entree
           standard, APT transmet aux commandes les noms de tous les fichiers
           .deb qu'il va installer, a raison d'un par ligne.

           La deuxieme 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 change. On autorise cette
           version en positionnant DPkg::Tools::Options::cmd::Version a 2.
           cmd est une commande passee a Pre-Install-Pkgs.

       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.

   utilisation des actions diff'er'ees (<< triggers >>) de dpkg (et options
       associ'ees)
       APT peut lancer dpkg pour utiliser les actions differees de maniere
       agressive entre les appels successifs a dpkg. Sans options
       supplementaires, dpkg n'utilisera les actions differees que dans le
       cadre de sa propre execution. Si ces options sont utilisees, le temps
       d'execution peut diminuer fortement dans les actions d'installation ou
       de mise a jour. Il est prevu de les activer par defaut dans le futur
       mais etant donne qu'elles changent notablement la methode qu'utilise
       APT pour lancer dpkg, elles ont besoin d'importantes validations.  Ces
       options sont donc exp'erimentales et ne devraient pas ^etre utilis'ees
       avec des environnements de production.. Elles modifient egalement le
       suivi de progression et toutes les interfaces passeront la moitie du
       temps a un etat termine a 100% pendant la configuration des paquets.

       Veuillez noter que rien ne garantit qu'APT gerera encore ces options
       dans le futur ou qu'elles ne provoqueront pas de nombreux degats. Si
       vous avez bien compris les implications de ce choix et etes
       suffisamment motive(e) pour essayer ces options, il vous est donc
       possible de creer un nouveau fichier de configuration et essayer une
       combinaison de ces options. Veuillez signaler tout bogue, problemes ou
       suggestions d'amelioration en prenant soin de mentionner les options
       utilisees. Utiliser l'aide apportee par dpkg peut egalement etre utile
       pour le debogage, par exemple dpkg --audit. Une combinaison
       interessante d'options pourrait etre

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

       .

       DPkg::NoTriggers
           Ajoute l'option << no-triggers >> a tous les appels a dpkg (hormis
           l'appel << ConfigurePending >>). Voir dpkg(1) pour plus
           d'informations sur la signification de cette option. En resume,
           dpkg n'effectuera pas les actions differees (<< triggers >>) si
           cette option est utilisee sauf si cela est demande explicitement
           dans une invocation supplementaire. Cette option existe en fait
           deja (mais n'est pas documentee) dans de plus anciennes version
           d'APT avec une signification legerement differente : elle
           n'ajoutait l'option << --no-triggers >> qu'aux appels de dpkg avec
           << configure >> alors que cela sera desormais utilise egalement
           avec les appels a dpkg avec les options << unpack >> et
           << remove >>.

       PackageManager::Configure
           Les valeurs possibles sont << all >>, << smart >> et << no >>. La
           valeur par defaut est << all >> ou APT configure explicitement tous
           les paquets. La valeur << smart >> permet de ne configurer que les
           paquets qui ont besoin de l'etre avant la decompaction d'un autre
           paquet (a cause d'une pre-dependance) ; les autres configurations
           sont laissees pour un appel ulterieur a dpkg. L'option << no >> ne
           provoquera aucune configuration et s'en remettra totalement a dpkg
           pour ces operations (ce qui echouera en cas de pre-dependances). Si
           cette option est definie sur une valeur differente de << all >>,
           l'option suivante sera activee par defaut pour eviter de placer le
           systeme dans un etat non configure et donc eventuellement non
           amorcable.

       DPkg::ConfigurePending
           Si cette option est choisie, APT lancera dpkg --configure --pending
           pour laisser dpkg gerer les configurations de paquets et les
           actions differees. Cette option est automatiquement activee si
           l'option precedente a une valeur differente de << all >>. 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.

       DPkg::TriggersPending
           Cette option est utile pour la configuration en mode << smart >>.
           En effet, un paquet qui a des actions differees (<< triggers >>) en
           attente n'est pas considere comme installe (etat << installed >>)
           et dpkg le considere actuellement comme simplement decompacte (etat
           << unpacked >>) ce qui empeche une gestion correcte des
           pre-dependances (voir le bogue Debian #526774). Veuillez noter que
           cette option provoquera la gestion de toutes les actions differees,
           pas seulement celles concernant le paquet en cours de traitement.

       PackageManager::UnpackAll
           Cette option permet de ne trier les operations de decompactage
           qu'en fonction de leur criticite (c'est a dire en ne considerant
           que les pre-dependances) dans le cas ou la configuration des
           paquets est differee pour n'etre effectuee qu'a la fin par dpkg.
           Cette option est active par defaut, ce qui revient a la methode
           traditionnelle ou les operations ont lieu en plusieurs etapes,
           selon l'ensemble des criteres de tri. Bien que les deux methodes
           existent meme dans les versions, la methode << OrderCritical >>
           n'etait pas utilisee. Elle doit donc etre consideree comme tres
           experimentale et a besoin de nombreuses ameliorations avant de
           devenir reellement utile. (Note du traducteur : la version
           originale de cette partie des pages de manuel est tres confuse. Il
           est donc conseille 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 dependances) devraient etre
           configures apres avoir ete decompresses. Il est conseille que cette
           operation ait lieu le plus tot possible dans le processus de mise a
           jour car ces operations de configuration necessitent egalement
           DPkg::TriggersPending, ce qui peut conduire a l'execution de
           certains actions differees qui ne sont pas necessairement utiles.
           Les paquets essentiels obtiennent par defaut un score eleve mais le
           marqueur << immediat >> implique un score assez bas (par exemple un
           paquet qui comporte des predependances obtient un score plus
           eleve). Cette option et les options du meme groupe permettent de
           modifier la facon d'attribuer un score. L'exemple ci-dessous
           indique ces reglages avec leurs valeurs par defaut.

               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 periodiques realises par le script /etc/cron.daily/apt,
       lance quotidiennement.

LES OPTIONS DE D'eBOGAGE

       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 librairies 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 de APT :

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

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

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

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

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

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

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

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

       Debug::IdentCDROM
           Desactive l'inclusion des donnees de type statfs pour la generation
           des identifiants de CD, c'est-a-dire le nombre de blocs libres et
           utilises sur le systeme de fichier du CD.

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

       Debug::pkgAcquire
           Trace les ajouts et suppressions d'elements de la queue globale de
           telechargement.

       Debug::pkgAcquire::Auth
           Affiche les details de la verification des sommes de controle et
           des signatures cryptographiques des fichiers telecharges, ainsi que
           les erreurs eventuelles.

       Debug::pkgAcquire::Diffs
           Affiche les informations de telechargement et de prise en compte
           des fichiers differentiels des indexes de paquets, ainsi que les
           erreurs eventuelles.

       Debug::pkgAcquire::RRed
           Affiche 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
           Affiche toutes les interactions avec les processus enfants qui se
           chargent effectivement des telechargements.

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

       Debug::pkgDepCache::AutoInstall
           Cree 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 de APT ; voir Debug::pkgProblemResolver pour ce
           dernier.

       Debug::pkgDepCache::Marker
           Cree 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 que l'action qui les a
           declenchees. Le format de chaque ligne est MarkKeep, MarkDelete ou
           MarkInstall suivi de nom-paquet <a.b.c -> 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 plus faible). Ces
           deux derniers elements peuvent ne pas etre mentionnes s'ils ne sont
           pas pertinents ou lorsque ils sont identiques a la version
           installee.  section est le nom de la section ou figure le
           paquet.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 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) a chaque appel ;
           les parametres sont separes par des espaces.

       Debug::pkgDPkgProgressReporting
           Affiche 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
           Affiche les etapes de l'algorithme utilise pour choisir l'ordre
           dans lequel apt passe les paquets a dpkg(1).

       Debug::pkgPackageManager
           Affiche le detail des operations liees a l'invocation de dpkg(1).

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

       Debug::pkgProblemResolver
           Affiche 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
           Affiche 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
           Affiche les fournisseurs declares dans le fichier
           /etc/apt/vendors.list.

EXEMPLES

       Le fichier /usr/share/doc/apt/examples/configure-index.gz 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
       <bubulle@debian.org> (2000, 2005, 2009, 2010), Equipe 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 eviter de perdre du contenu quand
       la traduction est legerement en retard sur le contenu d'origine.

AUTHORS

       Jason Gunthorpe

       'Equipe de d'eveloppement 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