+'\" t
.\" Title: apt.conf
.\" Author: Jason Gunthorpe
-.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
-.\" Date: 29 Février 2004
-.\" Manual:
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
+.\" Date: 16 January 2010
+.\" Manual: APT
.\" Source: Linux
+.\" Language: English
.\"
-.TH "APT\&.CONF" "5" "29 Février 2004" "Linux" ""
+.TH "APT\&.CONF" "5" "16 January 2010" "Linux" "APT"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
-.SH "NOM"
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
apt.conf \- Fichier de configuration pour APT
.SH "DESCRIPTION"
.PP
-Le fichier
-\fIapt\&.conf\fR
-est le principal fichier de configuration de la collection d\'outils que constitue APT\ \&; tous les outils font appel à ce fichier de configuration et utilisent un analyseur syntaxique en ligne de commande commun afin de fournir un environnement uniforme\&. Quand un outil d\'APT démarre, il lit (si elle existe) la variable d\'environnement
-\fBAPT_CONFIG\fR\ \&; puis il lit les fichiers situés dans
+apt\&.conf
+is the main configuration file for the APT suite of tools, but by far not the only place changes to options can be made\&. All tools therefore share the configuration files and also use a common command line parser to provide a uniform environment\&.
+.PP
+When an APT tool starts up it will read the configuration files in the following order:
+.sp
+.RS 4
+.ie n \{\
+\h'-04' 1.\h'+01'\c
+.\}
+.el \{\
+.sp -1
+.IP " 1." 4.2
+.\}
+the file specified by the
+\fBAPT_CONFIG\fR
+environment variable (if any)
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04' 2.\h'+01'\c
+.\}
+.el \{\
+.sp -1
+.IP " 2." 4.2
+.\}
+all files in
Dir::Etc::Parts
-ainsi que le principal fichier de configuration indiqué par
-Dir::Etc::main\ \&; enfin il applique les options de la ligne de commande qui annulent les directives de configuration, chargeant, si nécessaire, d\'autres fichiers de configuration\&.
+in alphanumeric ascending order which have no or "conf" as filename extension and which only contain alphanumeric, hyphen (\-), underscore (_) and period (\&.) characters \- otherwise they will be silently ignored\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04' 3.\h'+01'\c
+.\}
+.el \{\
+.sp -1
+.IP " 3." 4.2
+.\}
+the main configuration file specified by
+Dir::Etc::main
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04' 4.\h'+01'\c
+.\}
+.el \{\
+.sp -1
+.IP " 4." 4.2
+.\}
+the command line options are applied to override the configuration directives or to load even more configuration files\&.
+.RE
+.SH "SYNTAX"
.PP
-Le fichier de configuration est construit comme un arbre d\'options organisées en groupes fonctionnels\&. On se sert du double deux points (\(Fo\ \&::\ \&\(Fc) pour indiquer une option\ \&; par exemple,
+Le fichier de configuration est construit comme un arbre d\*(Aqoptions organisées en groupes fonctionnels\&. On se sert du double deux points (\(Fo\ \&::\ \&\(Fc) pour indiquer une option\ \&; par exemple,
APT::Get::Assume\-Yes
-est une option pour le groupe d\'outils APT, destinée à l\'outil Get\&. Les options n\'héritent pas des groupes de leurs parents\&.
+est une option pour le groupe d\*(Aqoutils APT, destinée à l\*(Aqoutil Get\&. Il n\*(Aqy a pas d\*(Aqhéritage des options des groupes parents\&.
.PP
-Syntaxiquement, le langage de configuration est conçu sur le même modèle que les langages utilisés par des outils ISC tels que bind et dhcp\&. Une ligne qui commence par
+Syntaxiquement, le langage de configuration est conçu sur le même modèle que les langages utilisés par des outils ISC tels que bind et dhcp\&. Une ligne qui commence par
//
-est un commentaire et elle est ignorée\&. Chaque ligne est de la forme\ \&:
-APT::Get::Assume\-Yes "true";
-Le point\-virgule final est obligatoire et les guillemets sont optionnels\&. On peut déclarer un nouveau champ d\'action avec des accolades, comme suit\ \&:
+est traitée comme un commentaire et ignorée, de même que les sections de texte placées entre
+/*
+et
+*/, tout comme les commentaires C/C++\&. Chaque ligne est de la forme\ \&:
+APT::Get::Assume\-Yes "true";\&. Le point\-virgule final est obligatoire et les guillemets sont optionnels\&. La valeur doit tenir sur une seule ligne et il n\*(Aqexiste pas de fusion de chaînes\&. Elle ne doit pas comporter de guillemets\&. Le comportement du caractère barre oblique inversée "\e" et les caractères utilisés avec séquence d\*(Aqéchappement dans une valeur ne sont pas déterministes et devraient être évités\&. Le nom d\*(Aqune option peut contenir des caractères alphanumériques et \(Fo\ \&/\-:\&._+\ \&\(Fc\&. On peut déclarer un nouveau champ d\*(Aqaction avec des accolades, comme suit\ \&:
.sp
+.if n \{\
.RS 4
+.\}
.nf
APT {
};
};
.fi
+.if n \{\
.RE
+.\}
.PP
-avec des retours à la ligne pour faciliter la lecture\&. On peut créer des listes en ouvrant un champ d\'action et en mettant un seul mot entre apostrophes suivi d\'un point\-virgule\&. On peut mettre plusieurs entrées, séparées par un point\-virgule\&.
+avec des retours à la ligne pour faciliter la lecture\&. On peut créer une liste en ouvrant un champ d\*(Aqaction et en y insérant une chaîne entre guillemets suivie d\*(Aqun point virgule pour chaque élément de la liste\&.
.sp
+.if n \{\
.RS 4
+.\}
.nf
DPkg::Pre\-Install\-Pkgs {"/usr/sbin/dpkg\-preconfigure \-\-apt";};
.fi
+.if n \{\
.RE
+.\}
.PP
-Les modèles
-\fI/usr/share/doc/apt/examples/apt\&.conf\fR
-\fI/usr/share/doc/apt/examples/configure\-index\&.gz\fR
-montrent à quoi devrait ressembler le fichier de configuration\&.
+Les modèles
+/usr/share/doc/apt/examples/apt\&.conf
+et
+/usr/share/doc/apt/examples/configure\-index\&.gz
+montrent à quoi devrait ressembler le fichier de configuration\&.
+.PP
+Les identifiants des options de configuration ne sont pas sensibles à la casse\&. Dans l\*(Aqexemple précédent, on pourrait donc aussi bien utiliser
+dpkg::pre\-install\-pkgs\&.
.PP
-Deux éléments spéciaux sont autorisés\ \&:
+Les noms des éléments de configuration sont optionnels si une liste est définie, comme cela peut se voir avec l\*(Aqexemple
+DPkg::Pre\-Install\-Pkgs
+précédent\&. Si vous n\*(Aqindiquez pas de nom, une nouvelle entrée ajoutera une nouvelle option à la liste\&. Dans le cas contraire, l\*(Aqoption correspondante peut être remplacée, comme toute autre option, en lui réaffectant une valeur\&.
+.PP
+Deux éléments spéciaux sont autorisés\ \&:
#include
-et
+(qui est obsolète et n\*(Aqest plus géré par des implémentations alternatives) et
#clear\&.
#include
-inclut le fichier donné en argument, à moins que le nom ne se termine par une barre oblique\&.
+inclut le fichier donné en paramètre, à moins que le nom ne se termine par une barre oblique auquel cas le répertoire entier est inclus\&.
#clear
-sert à effacer une liste de noms\&.
+sert à effacer une partie de l\*(Aqarbre de configuration\&. L\*(Aqélément désigné et tout ses descendants sont supprimés\&. Veuillez noter que ces lignes doivent également se terminer avec un point\-virgule\&.
.PP
-Tous les outils d\'APT possèdent une option
+La commande #clear est la seule façon de supprimer une liste ou un champ d\*(Aqaction (\(Fo\ \&scope\ \&\(Fc)\&. La réouverture d\*(Aqun scope ou le style \(Fo\ \&::\-\ \&\(Fc décrit plus loin ne remplaceront
+\fIpas\fR
+les entrées écrites précédemment\&. Seules les options peuvent être remplacées en leur assignant une nouvelle valeur\&. Les listes et les champs d\*(Aqaction ne peuvent être remplacés mais seulement effacés\&.
+.PP
+Tous les outils d\*(AqAPT possèdent une option
\fB\-o\fR
-qui permet de spécifier une configuration arbitraire 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 compléter une liste en ajoutant un \(Fo\ \&::\ \&\(Fc au nom de la liste\&.
+qui permet de spécifier une configuration quelconque depuis la ligne de commande\&. La syntaxe consiste en un nom complet d\*(Aqoption (par exemple
+APT::Get::Assume\-Yes) suivi par un signe égal, puis par la nouvelle valeur de l\*(Aqoption\&. On peut compléter une liste en ajoutant un \(Fo\ \&::\ \&\(Fc au nom de la liste\&. Comme on peut s\*(Aqen douter, la syntaxe de champ d\*(Aqaction (\(Fo\ \&scope\ \&\(Fc) ne peut pas être indiquée à la ligne de commande\&.
+.PP
+Veuillez noter que vous ne pouvez utiliser \(Fo\ \&::\ \&\(Fc que pour ajouter un élément par ligne à la liste et que cela ne devrait pas être utilisé en combinaison avec la syntaxe de champ d\*(Aqaction (\(Fo\ \&scope\ \&\(Fc) qui inclut implicitement \(Fo\ \&::\ \&\(Fc\&. L\*(Aqutilisation simultanée des deux syntaxes déclenchera un bogue dont certains utilisateurs se servent comme d\*(Aqune fonctionnalité\ \&: une option avec le nom inhabituel \(Fo\ \&::\ \&\(Fc se comportera comme toute autre option nommée\&. Cela risque d\*(Aqavoir de nombreux problèmes comme conséquence, par exemple si un utilisateur écrit plusieurs lignes avec cette syntaxe
+\fIerronée\fR
+afin de faire un ajout à la liste, l\*(Aqeffet obtenu sera inverse puisque seule la dernière valeur pour l\*(Aqoption \(Fo\ \&::\ \&\(Fc sera utilisée\&. Les futures versions d\*(AqAPT retourneront une erreur et l\*(Aqexécution sera interrompue si cette utilisation incorrecte est rencontrée\&. Il est donc conseillé de corriger ces défauts tant qu\*(AqAPT ne s\*(Aqen plaint pas explicitement\&.
.SH "LE GROUPE APT"
.PP
-Ce groupe d\'options contrôle aussi bien le comportement global d\'APT que la prise en compte des options pour chaque outil\&.
+Ce groupe d\*(Aqoptions contrôle le comportement global d\*(AqAPT et contient également des options communes à tous les outils\&.
.PP
Architecture
.RS 4
-L\'architecture du système\ \&; cette option positionne l\'architecture à utiliser pour récupérer des fichiers et analyser des listes de paquets\&. L\'architecture interne par défaut est celle pour laquelle APT a été compilé\&.
+L\*(Aqarchitecture du système\ \&; cette option positionne l\*(Aqarchitecture à utiliser pour récupérer des fichiers et analyser des listes de paquets\&. La valeur interne par défaut est l\*(Aqarchitecture pour laquelle APT a été compilé\&.
+.RE
+.PP
+Default\-Release
+.RS 4
+Indique la distribution à utiliser par défaut lors de l\*(Aqinstallation d\*(Aqun paquet si plusieurs versions sont disponibles\&. La valeur peut être un nom de distribution ou un numéro de version\&. Exemples\ \&: \(Fo\ \&stable\ \&\(Fc, \(Fo\ \&testing\ \&\(Fc, \(Fo\ \&lenny\ \&\(Fc, \(Fo\ \&squeeze\ \&\(Fc, \(Fo\ \&4\&.0\ \&\(Fc, \(Fo\ \&5\&.0*\ \&\(Fc\&. Voir aussi
+\fBapt_preferences\fR(5)\&.
.RE
.PP
Ignore\-Hold
.RS 4
-Ignore les paquets \(Fo\ \&gelés\ \&\(Fc\ \&; cette option globale indique au système de résolution de ne pas tenir compte des paquets \(Fo\ \&gelés\ \&\(Fc dans sa prise de décision\&.
+Ignore les paquets \(Fo\ \&gelés\ \&\(Fc\ \&; cette option globale indique au système de résolution de ne pas tenir compte des paquets \(Fo\ \&gelés\ \&\(Fc dans sa prise de décision\&.
.RE
.PP
Clean\-Installed
.RS 4
-Avec cette option qui est activée par défaut, la fonctionnalité \(Fo\ \&autoclean\ \&\(Fc supprime tout paquet qui ne peut plus être récupéré dans le cache\&. Quand cette option est désactivée, les paquets qui sont installés localement sont aussi exclus du nettoyage \- mais notez que APT ne fournit aucun moyen direct pour les réinstaller\&.
+Avec cette option qui est activée par défaut, la fonctionnalité \(Fo\ \&autoclean\ \&\(Fc supprime du cache tout paquet qui ne peut plus être récupéré\&. Quand cette option est désactivée, les paquets qui sont installés localement sont aussi exclus du nettoyage \- mais notez que APT ne fournit aucun moyen direct pour les réinstaller\&.
.RE
.PP
Immediate\-Configure
.RS 4
-Désactive la configuration immédiate\ \&; cette dangereuse option désactive une partie du code de mise en ordre de APT pour que ce dernier effectue le moins d\'appels possible à Dpkg\&. C\'est peut\-être nécessaire sur des systèmes lents à un seul utilisateur mais c\'est extrêmement dangereux et cela peut faire échouer les scripts d\'installation, voire pire\&. Utilisez\-la à vos risques et périls\&.
+Defaults to on which will cause APT to install essential and important packages as fast as possible in the install/upgrade operation\&. This is done to limit the effect of a failing
+\fBdpkg\fR(1)
+call: If this option is disabled APT does treat an important package in the same way as an extra package: Between the unpacking of the important package A and his configuration can then be many other unpack or configuration calls, e\&.g\&. for package B which has no relation to A, but causes the dpkg call to fail (e\&.g\&. because maintainer script of package B generates an error) which results in a system state in which package A is unpacked but unconfigured \- each package depending on A is now no longer guaranteed to work as their dependency on A is not longer satisfied\&. The immediate configuration marker is also applied to all dependencies which can generate a problem if the dependencies e\&.g\&. form a circle as a dependency with the immediate flag is comparable with a Pre\-Dependency\&. So in theory it is possible that APT encounters a situation in which it is unable to perform immediate configuration, errors out and refers to this option so the user can deactivate the immediate configuration temporarily to be able to perform an install/upgrade again\&. Note the use of the word "theory" here as this problem was only encountered by now in real world a few times in non\-stable distribution versions and was caused by wrong dependencies of the package in question or by a system in an already broken state, so you should not blindly disable this option as the mentioned scenario above is not the only problem immediate configuration can help to prevent in the first place\&. Before a big operation like
+dist\-upgrade
+is run with this option disabled it should be tried to explicitly
+install
+the package APT is unable to configure immediately, but please make sure to report your problem also to your distribution and to the APT team with the buglink below so they can work on improving or correcting the upgrade process\&.
.RE
.PP
Force\-LoopBreak
.RS 4
-Ne jamais activer cette option à moins que vous ne sachiez \- réellement \- ce que vous faites\&. Elle autorise APT à supprimer temporairement un paquet essentiel pour mettre fin à une boucle Conflicts / Conflicts ou Conflicts / Pre\-Depends entre deux paquets essentiels\&. UNE TELLE BOUCLE NE DOIT JAMAIS SE PRODUIRE\ \&: C\'EST UN BOGUE SÉRIEUX\&. Cette option fonctionne si les paquets essentiels ne sont pas tar, gzip, libc, dpkg, bash ou tous les paquets dont ces paquets dépendent\&.
+Ne jamais activer cette option à moins que vous ne sachiez \- réellement \- ce que vous faites\&. Elle autorise APT à supprimer temporairement un paquet essentiel pour mettre fin à une boucle Conflicts / Conflicts ou Conflicts / Pre\-Depends entre deux paquets essentiels\&. Une telle boucle ne devrait jamais se produire\ \&: c\*(Aqest un bogue très important\&. Cette option fonctionne si les paquets essentiels ne sont pas tar, gzip, libc, dpkg, bash ou tous les paquets dont ces paquets dépendent\&.
.RE
.PP
Cache\-Limit
.RS 4
-APT utilise un fichier cache d\'une taille mémoire fixe pour ranger les informations du fichier \(Fo\ \&available\ \&\(Fc\&. Cette option fixe la taille de ce cache\&.
+APT utilise un fichier de cache chargé en mémoire avec mmap pour ranger les informations sur les paquets disponibles\&. Cette option fixe la taille mémoire allouée (en octets) pour le chargement de ce cache\&.
.RE
.PP
Build\-Essential
.RS 4
-Cette option définit les paquets qui sont considérés comme faisant partie des dépendances essentielles pour la construction des paquets\&.
+Cette option définit les paquets qui sont considérés comme faisant partie des dépendances essentielles pour la construction de paquets\&.
.RE
.PP
Get
.RS 4
La sous\-section
Get
-contrôle l\'outil
-\fBapt-get\fR(8), veuillez consulter sa documentation pour avoir plus d\'informations sur les options en question\&.
+contrôle l\*(Aqoutil
+\fBapt-get\fR(8), veuillez consulter sa documentation pour avoir plus d\*(Aqinformations sur les options en question\&.
.RE
.PP
Cache
.RS 4
La sous\-section
Cache
-contrôle l\'outil
-\fBapt-cache\fR(8), veuillez consulter sa documentation pour avoir plus d\'informations sur les options en question\&.
+contrôle l\*(Aqoutil
+\fBapt-cache\fR(8), veuillez consulter sa documentation pour avoir plus d\*(Aqinformations sur les options en question\&.
.RE
.PP
CDROM
.RS 4
La sous\-section
CDROM
-contrôle l\'outil\fBapt-cdrom\fR(8), veuillez consulter sa documentation pour avoir plus d\'informations sur les options en question\&.
+contrôle l\*(Aqoutil
+\fBapt-cdrom\fR(8), veuillez consulter sa documentation pour avoir plus d\*(Aqinformations sur les options en question\&.
.RE
.SH "LE GROUPE ACQUIRE"
.PP
-Le groupe d\'options
+Le groupe d\*(Aqoptions
Acquire
-contrôle le téléchargement des paquets et les gestionnaires d\'URI\&.
+contrôle le téléchargement des paquets et les gestionnaires d\*(AqURI\&.
+.PP
+PDiffs
+.RS 4
+Essayer de télécharger les fichiers différentiels appelés
+PDiffs
+pour les paquets ou les fichiers sources, plutôt que de les télécharger entièrement\&. Par défaut à \(Fo\ \&true\ \&\(Fc\&.
+.sp
+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 precentage 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\&.
+.RE
.PP
Queue\-Mode
.RS 4
-Le mode file d\'attente\ \&;
+Mode de file d\*(Aqattente\ \&;
Queue\-Mode
-peut prendre une valeur parmi
+peut prendre les valeurs
host
ou
-access
-et cela détermine comment APT parallélise les connexions sortantes\&.
+access, ce qui détermine comment APT parallélise les connexions sortantes\&.
Host
-signifie qu\'une connexion par cible sera initiée, tandis que
+signifie qu\*(Aqune connexion par cible sera initiée, tandis que
access
-signifie qu\'une connexion par type d\'URI sera initiée\&.
+signifie qu\*(Aqune connexion par type d\*(AqURI sera initiée\&.
.RE
.PP
Retries
.RS 4
-Nombre d\'essais à effectuer\&. Si ce nombre n\'est pas nul, APT essaie de récupérer, le nombre donné de fois, les fichiers dont la récupération a échoué\&.
+Nombre d\*(Aqessais à effectuer\&. Si ce nombre n\*(Aqest pas nul, APT essaie de récupérer, le nombre donné de fois, les fichiers dont la récupération a échoué\&.
.RE
.PP
Source\-Symlinks
.RS 4
-Utilise des liens symboliques pour les archives de sources\&. Positionnée à \(Fo\ \&true\ \&\(Fc, cette option crée si possible des liens symboliques vers les archives de sources au lieu de les copier\&. Par défaut à \(Fo\ \&true\ \&\(Fc\&.
+Utilise des liens symboliques pour les archives de sources\&. Positionnée à \(Fo\ \&true\ \&\(Fc, cette option crée si possible des liens symboliques vers les archives de sources au lieu de les copier\&. Par défaut à \(Fo\ \&true\ \&\(Fc\&.
.RE
.PP
http
.RS 4
-URI HTTP ; http::Proxy est le mandataire (proxy) http à utiliser par défaut\&. Il se présente sous la forme standard\ \&:
-http://[[user][:pass]@]host[:port]/\&. En utilisant la syntaxe\ \&:
-http::Proxy::<host>, où le mot\-clé spécial
+URI HTTP\ \&; http::Proxy est le mandataire (proxy) HTTP à utiliser par défaut\&. Il se présente sous la forme standard\ \&:
+http://[[utilisateur][:mot_de_passe]@]hôte[:port]/\&. On peut spécifier un mandataire particulier par hôte distant en utilisant la syntaxe\ \&:
+http::Proxy::<hôte>\&. Le mot\-clé spécial
DIRECT
-indique de n\'utiliser aucun mandataire, on peut spécifier un mandataire pour chaque machine distante\&. La variable d\'environnement
+indique alors de n\*(Aqutiliser aucun mandataire pour l\*(Aqhôte\&. Si aucun des paramètres précédents n\*(Aqest défini, la variable d\*(Aqenvironnement
\fBhttp_proxy\fR
-remplace tous ces paramètres\&.
+annule et remplace toutes les options de mandataire HTTP\&.
.sp
-Trois options de configuration sont fournies pour le contrôle des caches qui sont compatibles avec HTTP/1\&.1\&.
+Trois options de configuration sont fournies pour le contrôle des caches compatibles avec HTTP/1\&.1\&.
No\-Cache
-signifie que le mandataire ne doit pas du tout utiliser les réponses qu\'il a stockées\ \&;
+signifie que le mandataire ne doit jamais utiliser les réponses qu\*(Aqil a stockées\ \&;
Max\-Age
-sert uniquement pour les fichiers d\'index\ \&: cela demande au cache de les mettre à jour quand leur ancienneté est supérieure au nombre de secondes donné\&. Debian met à jour son fichier d\'index de manière journalière, la valeur par défaut est donc de 1 jour\&.
+sert uniquement pour les fichiers d\*(Aqindex\ \&: cela demande au cache de les mettre à jour quand leur ancienneté est supérieure au nombre de secondes donné\&. Debian met à jour ses fichiers d\*(Aqindex de manière quotidienne\ \&; la valeur par défaut est donc de 1 jour\&.
No\-Store
-sert uniquement pour les fichiers d\'archive\ \&: cela demande au cache de ne jamais garder la requête\&. Cela peut éviter de polluer un cache mandataire avec des fichiers \&.deb très grands\&. Note\ \&: Squid 2\&.0\&.2 ne prend en compte aucune de ces options\&.
+sert uniquement pour les fichiers d\*(Aqarchive et demande au cache de ne jamais garder la requête\&. Cela peut éviter de polluer un cache mandataire avec des fichiers \&.deb très grands\&. Note\ \&: Squid 2\&.0\&.2 ne prend en compte aucune de ces options\&.
.sp
-L\'option
+L\*(Aqoption
timeout
-positionne le compteur de temps mort (timeout) utilisé par la méthode\ \&: cela vaut pour tout (connexion, données)\&.
+positionne le compteur d\*(Aqexpiration du délai (timeout) utilisé par la méthode\&. Cela vaut pour tout, connexion et données\&.
.sp
-Une option de configuration est fournie pour contrôler 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)\&.
+Une option de configuration est fournie pour contrôler la profondeur du tube pour le cas où un serveur distant n\*(Aqest 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 requêtes en attente qui peuvent être émises\&. Quand la machine distante ne conserve pas correctement les connexions TCP, on DOIT donner une valeur égale à 0 \-\- sinon des données seront corrompues\&. Les machines qui ont besoin de cette option ne respectent pas la RFC 2068\&.
+a une valeur comprise entre 0 et 5\ \&: elle indique le nombre de requêtes 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 données seront corrompues\&. Les machines qui ont besoin de cette option ne respectent pas la RFC 2068\&.
+.sp
+La bande passante utilisée peut être limité avec
+Acquire::http::Dl\-Limit
+qui peut prendre une valeur entière, l\*(Aqunité utilisée étant le kilo\-octet\&. La valeur par défaut est 0, ce qui correspond à aucune limitation de bande passante\&. Veuillez noter que cette option désactive implicitement le téléchargement simultané depuis plusieurs serveurs\&.
+.sp
+L\*(Aqoption
+Acquire::http::User\-Agent
+peut être utilisée pour envoyer une valeur User\-Agent modifiée pour les téléchargements HTTP, ce qui peut par exemple être utile avec certains mandataires HTTP qui n\*(Aqautorisent l\*(Aqaccès qu\*(Aqaux client s\*(Aqidentifiant de manière spécifique\&.\&.
+.RE
+.PP
+https
+.RS 4
+URI HTTPS\&. Les options de contrôle de cache, de délai limite, d\*(Aqautorisation de redirection, de Dl\-Limit et de mandataire (proxy) sont les mêmes que pour la méthode
+http\&. Les valeurs par défaut sont les mêmes que pour l\*(Aqoption
+http
+sauf si des valeurs spécifiques à https sont indiquées\&. L\*(Aqoption
+Pipeline\-Depth
+n\*(Aqest pas encore gérée\&.
+.sp
+La sous\-option
+CaInfo
+spécifie le fichier contenant les informations sur les certificats de confiance\&. La sous\-option booléenne
+Verify\-Peer
+précise si le certificat d\*(Aqhôte du serveur doit être confronté aux certificats de confiance ou pas\&. La sous\-option booléenne
+Verify\-Host
+précise s\*(Aqil faut vérifier ou pas le nom d\*(Aqhôte du serveur\&.
+SslCert
+détermine le certificat à utiliser pour l\*(Aqauthentification du client\&.
+SslKey
+détermine quelle clef privée doit être utilisée pour l\*(Aqauthentification du client\&.
+SslForceVersion
+surcharge la valeur par défaut pour la version de SSL à utiliser et peut contenir l\*(Aqune des chaînes \*(AqTLSv1\*(Aq ou \*(AqSSLv3\*(Aq\&.
.RE
.PP
ftp
.RS 4
-URI FTP ; ftp::Proxy est le serveur mandataire par défaut à utiliser\&. Il se présente sous la forme standard\ \&:
-ftp://[[user][:pass]@]host[:port]/\ \&; il est remplacé par la variable d\'environnement
-\fBftp_proxy\fR\&. Pour utiliser un mandataire ftp, vous devez renseigner l\'entrée
+URI FTP\ \&; ftp::Proxy est le mandataire (proxy) FTP à utiliser par défaut\&. Il se présente sous la forme standard\ \&:
+ftp://[[user][:pass]@]host[:port]/\&. On peut spécifier un mandataire particulier par hôte distant en utilisant la syntaxe\ \&:
+ftp::Proxy::<hôte>\&. Le mot\-clé spécial
+DIRECT
+indique alors de n\*(Aqutiliser aucun mandataire pour l\*(Aqhôte\&. Si aucun des paramètres précédents n\*(Aqest définis, la variable d\*(Aqenvironnement
+\fBftp_proxy\fR
+annule et replace toutes les options de mandataire FTP\&. Pour utiliser un mandataire FTP, vous devrez renseigner l\*(Aqentrée
ftp::ProxyLogin
-dans le fichier de configuration\&. Cette entrée spécifie les commandes qui disent au serveur mandataire comment se connecter\&. Voyez
-\fI/usr/share/doc/apt/examples/configure\-index\&.gz\fR
+dans le fichier de configuration\&. Cette entrée spécifie les commandes à envoyer au mandataire pour lui préciser à 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 à un élément de l\'URI\&.
+$(SITE)
+et
+$(SITE_PORT)\&. Chacune correspond à l\*(Aqélément respectif de l\*(AqURI\&.
.sp
-L\'option
+L\*(Aqoption
timeout
-positionne le compteur de temps mort (timeout) utilisé par la méthode\ \&: cela vaut pour tout (connexion, données)\&.
+positionne le compteur d\*(Aqexpiration du délai (timeout) utilisé par la méthode\&. Cela vaut pour tout, connexion et données\&.
.sp
-Plusieurs options de configuration sont fournies pour contrôler le mode passif\&. Généralement, c\'est plus sûr d\'activer le mode passif\ \&; cela marche dans presque tous les environnements\&. Cependant, certaines situations nécessitent que le mode passif soit désactivé et que le mode \(Fo\ \&port\ \&\(Fc de ftp soit utilisé à la place\&. On peut le faire globalement, pour des connexions qui passent par un mandataire ou pour une machine spécifique (examinez le modèle de fichier de configuration)\&.
+Plusieurs options de configuration sont fournies pour contrôler le mode passif\&. Il est généralement plus sûr d\*(Aqactiver le mode passif et cela marche dans presque tous les environnements\&. Cependant, certaines situations nécessitent que le mode passif soit désactivé et que le mode \(Fo\ \&port\ \&\(Fc de ftp soit utilisé à la place\&. On peut le faire globalement, pour des connexions qui passent par un mandataire ou pour une machine spécifique (examinez le modèle de fichier de configuration)\&.
.sp
-On peut utiliser un mandataire FTP pour atteindre une cible HTTP en positionnant la variable d\'environnement
+Il est possible de faire transiter le trafic FTP par un mandataire HTTP en positionnant la variable d\*(Aqenvironnement
\fBftp_proxy\fR
-à une url http \-\- consultez la méthode http ci\-dessus pour la syntaxe\&. On ne peut pas fixer cette variable dans le fichier de configuration et il n\'est pas recommandé d\'utiliser HTTP par FTP à cause de son peu d\'efficacité\&.
+à une URL HTTP \-\- consultez la méthode http ci\-dessus pour la syntaxe\&. On ne peut pas le faire dans le fichier de configuration et il n\*(Aqest de toute façon pas recommandé d\*(Aqutiliser FTP au travers de HTTP en raison de la faible efficacité de cette méthode\&.
.sp
-L\'option
+L\*(Aqoption
ForceExtended
-contrôle l\'utilisation des commandes liées à la RFC 2428,
+contrôle l\*(Aqutilisation des commandes liées à la RFC 2428,
EPSV
et
-EPRT\&. Par défaut, elle vaut \(Fo\ \&false\ \&\(Fc\ \&; ce qui signifie que ces commandes ne sont utilisées que pour une connexion de type IPv6\&. Quand elle vaut \(Fo\ \&true\ \&\(Fc, on les utilise même si la connexion est de type IPv4\&. La plupart des serveurs FTP ne suivent pas la RFC 2428\&.
+EPRT\&. Par défaut, elle vaut \(Fo\ \&false\ \&\(Fc ce qui signifie que ces commandes ne sont utilisées que pour une connexion de type IPv6\&. Quand elle vaut \(Fo\ \&true\ \&\(Fc, on les utilise même si la connexion est de type IPv4\&. La plupart des serveurs FTP ne suivent pas la RFC 2428\&.
.RE
.PP
cdrom
.RS 4
-URI CDROM\ \&; la seule option de configuration pour les URI de CDROM est le point de montage\ \&:
-cdrom::Mount\ \&; il doit représenter le point de montage du lecteur de cédérom indiqué dans
-\fI/etc/fstab\fR\&. On peut fournir d\'autres commandes de montage et de démontage quand le point de montage ne peut être listé dans le fichier
-\fI/etc/fstab\fR
+URI CD\ \&; la seule option de configuration pour les URI de CD est le point de montage\ \&:
+cdrom::Mount\ \&; il doit représenter le point de montage du lecteur de CD\-ROM indiqué dans
+/etc/fstab\&. D\*(Aqautres commandes de montage et de démontage 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
.sp
+.if n \{\
.RS 4
+.\}
.nf
-"/cdrom/"::Mount "foo";
+/cdrom/::Mount "foo";
.fi
+.if n \{\
.RE
+.\}
.sp
-dans le bloc cdrom\&. La barre oblique finale est importante\&. Les commandes de démontage peuvent être spécifiées en utilisant
+dans le bloc cdrom\&. La barre oblique finale est importante\&. Les commandes de démontage peuvent être spécifiées en utilisant
UMount\&.
.RE
.PP
gpgv
.RS 4
-URI GPGV ; la seule option pour les URI GPGV est celle qui permet de passer des paramètres à gpgv\&.
-gpgv::Options
-Options supplémentaires passées à gpgv\&.
+URI GPGV\ \&; la seule option pour les URI GPGV est celle qui permet de passer des paramètres à gpgv\&.
+gpgv::Options\ \&: options supplémentaires passées à gpgv\&.
.RE
-.SH "LES RÉPERTOIRES"
.PP
-Les répertoires de la section
+CompressionTypes
+.RS 4
+Cette option indique la liste des types de compression comprises par les méthodes d\*(Aqacquisition\&. Des fichiers comme
+Packages
+peuvent être disponibles dans divers formats de compression\&. Par défaut, les méthodes d\*(Aqacquisition décompressent les fichiers compressés avec
+\fBbzip2\fR,
+\fBlzma\fR
+et
+\fBgzip\fR\&. Ce réglage permet d\*(Aqajouter à la volée des formats supplémentaires ou de modifier la méthode utilisée\&. La syntaxe à utiliser est\ \&:\ \&
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+Acquire::CompressionTypes::\fIExtensionFichier\fR "\fINomMethode\fR";
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Le sous\-groupe
+Order
+peut être également utilisé pour définir l\*(Aqordre dans lequel le système d\*(Aqacquisition tentera de télécharger les fichiers compressés\&. Le premier système mentionné sera essayé en premier, puis le suivant en cas d\*(Aqéchec\&. Ainsi, pour privilégier un format par rapport à un autre, il suffit de le placer en premier dans cette liste\&. Les types par défaut qui ne sont pas déjà indiqués seront ajoutés en fin de liste au moment de l\*(Aqexécution\&. Ainsi, par exemple,
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+Acquire::CompressionTypes::Order:: "gz";
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+
+peut être utiliser de préférence les fichiers compressés avec
+\fBgzip\fR
+par rapport à
+\fBbzip2\fR
+et
+\fBlzma\fR\&. Si l\*(Aqobjectif est d\*(Aqutiliser
+\fBlzma\fR
+en priorité par rapport à
+\fBgzip\fR
+et
+\fBbzip2\fR, ce réglage doit ressembler à
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+Acquire::CompressionTypes::Order { "lzma"; "gz"; };
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+\&. Il est inutile d\*(Aqajouter explicitement
+bz2
+à liste car il sera ajouté automatiquement\&.
+.sp
+Veuillez noter qu\*(Aqà l\*(Aqexécution,
+Dir::Bin::\fIMethodname\fR
+sera vérifié\ \&: si ce réglage existe, la méthode ne sera utilisée que si ce fichier existe\&. Ainsi, pour la méthode bzip2, le réglage (utilisé en interne) est
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+Dir::Bin::bzip2 "/bin/bzip2";
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+\&. Veuillez également noter que les éléments de liste indiqués à la ligne de commande seront ajoutés à la fin de la liste indiquée dans les fichiers de configuration, mais avant les valeurs par défaut\&. Dans ce cas, pour établir une préférence par rapport aux types mentionnés dans les fichiers de configuration, il est possible de placer l\*(Aqoption directement, pas sous forme de liste\&. Cela ne remplacera pas la liste par défaut mais elle sera simplement préfixée avec l\*(Aqoption en question\&.
+.sp
+Bien qu\*(Aqil soit possible d\*(Aqajouter un type vide de compression à la liste ordonnée, APT ne l\*(Aqinterprétera pas correctement et affichera de nombreux messages d\*(Aqavertissement à propos d\*(Aqéchec de téléchargement, qui sont le plus souvent des avertissements sans conséquences\&. Dans de futures versions, il deviendra réellement possible d\*(Aqétablir une préférence pour des fichiers non compressés afin de gérer des miroirs locaux\&.
+.RE
+.SH "LES RéPERTOIRES"
+.PP
+Les répertoires de la section
Dir::State
-concernent le système local\&.
+concernent le système local\&.
lists
-est le répertoire où placer les listes de paquets téléchargés et
+est le répertoire où placer les listes de paquets téléchargés et
status
-est le nom du fichier d\'état de Dpkg\&.
+est le nom du fichier d\*(Aqétat de
+\fBdpkg\fR(1)\&.
preferences
-concerne APT\ \&: c\'est le nom du fichier des préférences\&.
+concerne APT\ \&: c\*(Aqest le nom du fichier des préférences\&.
Dir::State
-contient le répertoire par défaut préfixé à tous les sous\-éléments, quand ceux\-ci ne commencent pas par
-\fI/\fR
+contient le répertoire par défaut préfixé à tous les sous\-éléments, quand ceux\-ci ne commencent pas par
+/
ou
-\fI\&./\fR\&.
+\&./\&.
.PP
-
Dir::Cache
contient les emplacements qui renseignent sur le cache local\ \&: par exemple, les deux caches de paquets
srcpkgcache
et
-pkgcache, et aussi l\'endroit où sont placées les archives téléchargées,
-Dir::Cache::archives\&. On peut empêcher la création des caches en laissant leur nom en blanc\&. Cela ralentit le démarrage mais cela sauve de l\'espace disque\&. Il vaut mieux se passer du cache
+pkgcache, ainsi que l\*(Aqendroit où sont placées les archives téléchargées,
+Dir::Cache::archives\&. On peut empêcher la création des caches en saisissant un nom vide\&. Cela ralentit le démarrage mais économise de l\*(Aqespace disque\&. Il vaut mieux se passer du cache
pkgcache
-plutôt que se passer du cache
+plutôt que se passer du cache
srcpkgcache\&. Comme pour
-Dir::State, le répertoire par défaut est contenu dans
+Dir::State, le répertoire par défaut est contenu dans
Dir::Cache\&.
.PP
-
Dir::Etc
-contient l\'emplacement des fichiers de configuration,
+contient l\*(Aqemplacement des fichiers de configuration,
sourcelist
-indique l\'emplacement de la liste de sources et
+indique l\*(Aqemplacement de la liste de sources et
main
-est le fichier de configuration par défaut (le modifier n\'a aucun effet, à moins qu\'on ne le modifie avec le fichier de configuration indiqué par la variable
+est le fichier de configuration par défaut (le modifier n\*(Aqa aucun effet, à moins qu\*(Aqon ne le modifie avec le fichier de configuration indiqué par la variable
\fBAPT_CONFIG\fR)\&.
.PP
-
Dir::Parts
-lit, par ordre d\'entrée, tous les fragments de configuration dans le répertoire indiqué\&. Ensuite, le fichier principal de configuration est chargé\&.
+lit, par ordre d\*(Aqentrée, tous les fragments de configuration dans le répertoire indiqué\&. Ensuite, le fichier principal de configuration est chargé\&.
.PP
-Les programmes binaires sont pointés par
-Dir::Bin\&. L\'emplacement des gestionnaires de méthodes est indiqué par
+Les programmes binaires sont pointés par
+Dir::Bin\&. L\*(Aqemplacement des gestionnaires de méthodes est indiqué par
Dir::Bin::Methods\ \&;
gzip,
-Dpkg,
+bzip2,
+lzma,
+dpkg,
apt\-get,
dpkg\-source,
dpkg\-buildpackage
et
apt\-cache
-indiquent l\'emplacement des programmes correspondants\&.
+indiquent l\*(Aqemplacement des programmes correspondants\&.
+.PP
+L\*(Aqoption de configuration
+RootDir
+a une signification particulière\&. Lorsqu\*(Aqelle est définie, tous les chemins déclarés dans
+Dir::
+sont considérés relativement à
+RootDir,
+\fImême les chemins spécifiés de manière absolue\fR\&. Ainsi par exemple si
+RootDir
+est défini comme
+/tmp/staging, et que chemin du fichier d\*(Aqétat
+Dir::State::status
+est déclaré comme
+/var/lib/dpkg/status
+alors ce fichier sera cherché dans
+/tmp/staging/var/lib/dpkg/status\&.
.SH "APT ET DSELECT"
.PP
-Quand APT est utilisé comme une méthode de
-\fBdselect\fR(8), plusieurs directives contrôlent le comportement par défaut\&. On les trouve dans la section
+Quand APT est utilisé comme une méthode de
+\fBdselect\fR(1), plusieurs directives contrôlent le comportement par défaut\&. On les trouve dans la section
DSelect\&.
.PP
Clean
.RS 4
-Mode de nettoyage du cache\ \&; cette variable peut prendre l\'une des valeurs suivantes\ \&: \(Fo\ \&always\ \&\(Fc, \(Fo\ \&prompt\ \&\(Fc, \(Fo\ \&auto\ \&\(Fc, \(Fo\ \&pre\-auto\ \&\(Fc et \(Fo\ \&never\ \&\(Fc\&. \(Fo\ \&always\ \&\(Fc et \(Fo\ \&prompt\ \&\(Fc suppriment tous les paquets du cache après la mise à niveau\ \&; \(Fo\ \&prompt\ \&\(Fc (valeur par défaut) les supprime après une demande et \(Fo\ \&auto\ \&\(Fc ne supprime que les archives qui ne peuvent plus être téléchargées (remplacées, par exemple, par une nouvelle version)\&. \(Fo\ \&pre\-auto\ \&\(Fc les supprime avant de récupérer de nouveaux paquets\&.
+Mode de nettoyage du cache\ \&; cette variable peut prendre l\*(Aqune des valeurs suivantes\ \&: \(Fo\ \&always\ \&\(Fc, \(Fo\ \&prompt\ \&\(Fc, \(Fo\ \&auto\ \&\(Fc, \(Fo\ \&pre\-auto\ \&\(Fc et \(Fo\ \&never\ \&\(Fc\&. \(Fo\ \&always\ \&\(Fc et \(Fo\ \&prompt\ \&\(Fc suppriment tous les paquets du cache après la mise à niveau\ \&; \(Fo\ \&prompt\ \&\(Fc (valeur par défaut) les supprime après une demande et \(Fo\ \&auto\ \&\(Fc ne supprime que les archives qui ne peuvent plus être téléchargées (remplacées, par exemple, par une nouvelle version)\&. \(Fo\ \&pre\-auto\ \&\(Fc les supprime avant de récupérer de nouveaux paquets\&.
.RE
.PP
-Options
+options
.RS 4
-Le contenu de cette variable est passé à
+Le contenu de cette variable est passé comme options de ligne de commande à
\fBapt-get\fR(8)
-avec les options de la ligne de commande quand ce programme est utilisé dans la phase d\'installation\&.
+lors de la phase d\*(Aqinstallation\&.
.RE
.PP
UpdateOptions
.RS 4
-Le contenu de cette variable est passé à
+Le contenu de cette variable est passé comme options de ligne de commande à
\fBapt-get\fR(8)
-avec les options de la ligne de commande quand ce programme est utilisé dans la phase de mise à jour\&.
+lors de la phase de mise à jour\&.
.RE
.PP
PromptAfterUpdate
.RS 4
-Si cette option est \(Fo\ \&vraie\ \&\(Fc, l\'opération [U]pdate de
-\fBdselect\fR(8)
-interroge toujours l\'utilisateur avant de continuer\&. Par défaut, ce n\'est qu\'en cas d\'erreur que l\'on propose à l\'utilisateur d\'intervenir\&.
+Si cette option est \(Fo\ \&true\ \&\(Fc, l\*(Aqopération [U]pdate de
+\fBdselect\fR(1)
+interroge toujours l\*(Aqutilisateur avant de continuer\&. Par défaut, ce n\*(Aqest qu\*(Aqen cas d\*(Aqerreur que l\*(Aqon propose à l\*(Aqutilisateur d\*(Aqintervenir\&.
.RE
-.SH "COMMENT APT APPELLE DPKG"
+.SH "MéTHODE D'APPEL DE DPKG(1) PAR APT"
.PP
-Plusieurs directives de configuration contrôlent la manière dont APT invoque
-\fBdpkg\fR(8)\ \&: elles figurent dans la section
+Plusieurs directives de configuration contrôlent la manière dont APT invoque
+\fBdpkg\fR(1)\ \&: elles figurent dans la section
DPkg\&.
.PP
-Options
+options
.RS 4
-Il s\'agit d\'une liste d\'options à passer à dpkg\&. Les options doivent être déclarées en utilisant la notation de liste et chaque élément de liste est passé comme un seul argument à
-\fBdpkg\fR(8)\&.
+Il s\*(Aqagit d\*(Aqune liste d\*(Aqoptions à passer à
+\fBdpkg\fR(1)\&. Les options doivent être déclarées en utilisant la notation de liste et chaque élément de la liste est passé comme un seul paramètre à
+\fBdpkg\fR(1)\&.
.RE
.PP
Pre\-Invoke, Post\-Invoke
.RS 4
-Il s\'agit d\'une liste de commandes shell à exécuter avant ou après l\'appel de
-\fBdpkg\fR(8)\&. Tout comme pour
-Options, on doit utiliser la notation de liste\&. Les commandes sont appelées dans l\'ordre, en utilisant
-\fI/bin/sh\fR\ \&: APT s\'arrête dès que l\'une d\'elles échoue\&.
+Il s\*(Aqagit d\*(Aqune liste de commandes shell à exécuter avant ou après l\*(Aqappel de
+\fBdpkg\fR(1)\&. Tout comme pour
+Options, on doit utiliser la notation de liste\&. Les commandes sont appelées dans l\*(Aqordre, en utilisant
+/bin/sh\ \&: APT s\*(Aqarrête dès que l\*(Aqune d\*(Aqelles échoue\&.
.RE
.PP
Pre\-Install\-Pkgs
.RS 4
-Il s\'agit d\'une liste de commandes shell à exécuter avant d\'appeler Dpkg\&. Tout comme pour
-Options, on doit utiliser la notation de liste\&. Les commandes sont appelées dans l\'ordre, en utilisant
-\fI/bin/sh\fR\ \&: APT s\'arrête dès que l\'une d\'elles échoue\&. Sur l\'entrée standard, APT transmet aux commandes les noms de tous les fichiers \&.deb qu\'il va installer, à raison d\'un par ligne\&.
+Il s\*(Aqagit d\*(Aqune liste de commandes shell à exécuter avant d\*(Aqappeler
+\fBdpkg\fR(1)\&. Tout comme pour
+Options, on doit utiliser la notation de liste\&. Les commandes sont appelées dans l\*(Aqordre, en utilisant
+/bin/sh\ \&: APT s\*(Aqarrête dès que l\*(Aqune d\*(Aqelles échoue\&. Sur l\*(Aqentrée standard, APT transmet aux commandes les noms de tous les fichiers \&.deb qu\*(Aqil va installer, à raison d\*(Aqun par ligne\&.
.sp
-La deuxième version de ce protocole donne plus de renseignements\ \&: on obtient la version du protocole, la configuration de APT et les paquets, fichiers ou versions qui ont changé\&. On autorise cette version en positionnant
+La deuxième version de ce protocole donne plus de renseignements\ \&: on obtient la version du protocole, la configuration de APT et les paquets, fichiers ou versions qui ont changé\&. On autorise cette version en positionnant
DPkg::Tools::Options::cmd::Version
-à 2\&.
+à 2\&.
cmd
-est une commande passée à
+est une commande passée à
Pre\-Install\-Pkgs\&.
.RE
.PP
Run\-Directory
.RS 4
-APT se place dans ce répertoire avant d\'appeler Dpkg\ \&; par défaut c\'est le répertoire
-\fI/\fR\&.
+APT se place dans ce répertoire avant d\*(Aqappeler
+\fBdpkg\fR(1)\ \&; par défaut, c\*(Aqest le répertoire
+/\&.
.RE
.PP
-Build\-Options
+Build\-options
.RS 4
-Ces options sont passées à
+Ces options sont passées à
\fBdpkg-buildpackage\fR(1)
-lors de la compilation des paquets\ \&; par défaut la signature est désactivée et tous les binaires sont créés\&.
+lors de la compilation des paquets\ \&; par défaut la signature est désactivée et tous les binaires sont créés\&.
+.RE
+.SS "utilisation des actions différées (\(Fo\ \&triggers\ \&\(Fc) de dpkg (et options associées)"
+.PP
+APT peut lancer dpkg pour utiliser les actions différées de manière agressive entre les appels successifs à dpkg\&. Sans options supplémentaires, dpkg n\*(Aqutilisera les actions différées que dans le cadre de sa propre exécution\&. Si ces options sont utilisées, le temps d\*(Aqexécution peut diminuer fortement dans les actions d\*(Aqinstallation ou de mise à jour\&. Il est prévu de les activer par défaut dans le futur mais étant donné qu\*(Aqelles changent notablement la méthode qu\*(Aqutilise APT pour lancer dpkg, elles ont besoin d\*(Aqimportantes validations\&.
+\fICes options sont donc expérimentales et ne devraient pas être utilisées avec des environnements de production\&.\fR\&. 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\&.
+.PP
+Veuillez noter que rien ne garantit qu\*(AqAPT gérera encore ces options dans le futur ou qu\*(Aqelles ne provoqueront pas de nombreux dégâts\&. 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 créer un nouveau fichier de configuration et essayer une combinaison de ces options\&. Veuillez signaler tout bogue, problèmes ou suggestions d\*(Aqamélioration en prenant soin de mentionner les options utilisées\&. Utiliser l\*(Aqaide apportée par dpkg peut également être utile pour le débogage, par exemple
+\fBdpkg \-\-audit\fR\&. Une combinaison intéressante d\*(Aqoptions pourrait être
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+DPkg::NoTriggers "true";
+PackageManager::Configure "smart";
+DPkg::ConfigurePending "true";
+DPkg::TriggersPending "true";
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+\&.
+.PP
+DPkg::NoTriggers
+.RS 4
+Ajoute l\*(Aqoption \(Fo\ \&no\-triggers\ \&\(Fc à tous les appels à dpkg (hormis l\*(Aqappel \(Fo\ \&ConfigurePending\ \&\(Fc)\&. Voir
+\fBdpkg\fR(1)
+pour plus d\*(Aqinformations sur la signification de cette option\&. En résumé, dpkg n\*(Aqeffectuera pas les actions différées (\(Fo\ \&triggers\ \&\(Fc) si cette option est utilisée sauf si cela est demandé explicitement dans une invocation supplémentaire\&. Cette option existe en fait déjà (mais n\*(Aqest pas documentée) dans de plus anciennes version d\*(AqAPT avec une signification légèrement différente\ \&: elle n\*(Aqajoutait l\*(Aqoption \(Fo\ \&\-\-no\-triggers\ \&\(Fc qu\*(Aqaux appels de dpkg avec \(Fo\ \&configure\ \&\(Fc alors que cela sera désormais utilisé également avec les appels à dpkg avec les options \(Fo\ \&unpack\ \&\(Fc et \(Fo\ \&remove\ \&\(Fc\&.
.RE
-.SH "LES OPTIONS DE DÉBOGAGE"
.PP
-La plupart des options de la section
-debug
-n\'ont aucun intérêt pour le simple utilisateur\ \&; cependant,
+PackageManager::Configure
+.RS 4
+Les valeurs possibles sont \(Fo\ \&all\ \&\(Fc, \(Fo\ \&smart\ \&\(Fc et \(Fo\ \&no\ \&\(Fc\&. La valeur par défaut est \(Fo\ \&all\ \&\(Fc où APT configure explicitement tous les paquets\&. La valeur \(Fo\ \&smart\ \&\(Fc permet de ne configurer que les paquets qui ont besoin de l\*(Aqêtre avant la décompaction d\*(Aqun autre paquet (à cause d\*(Aqune pré\-dépendance)\ \&; les autres configurations sont laissées pour un appel ultérieur à dpkg\&. L\*(Aqoption \(Fo\ \&no\ \&\(Fc ne provoquera aucune configuration et s\*(Aqen remettra totalement à dpkg pour ces opérations (ce qui échouera en cas de pré\-dépendances)\&. Si cette option est définie sur une valeur différente de \(Fo\ \&all\ \&\(Fc, l\*(Aqoption suivante sera activée par défaut pour éviter de placer le système dans un état non configuré et donc éventuellement non amorçable\&.
+.RE
+.PP
+DPkg::ConfigurePending
+.RS 4
+Si cette option est choisie, APT lancera
+\fBdpkg \-\-configure \-\-pending\fR
+pour laisser dpkg gérer les configurations de paquets et les actions différées\&. Cette option est automatiquement activée si l\*(Aqoption précédente a une valeur différente de \(Fo\ \&all\ \&\(Fc\&. Il peut par contre être utile de la désactiver pour lancer APT plusieurs fois successives, par exemple quand il est utilisé depuis un outil d\*(Aqinstallation\&. Dans ce cas, seul le dernier de tous les appels successifs peut conserver l\*(Aqoption active\&.
+.RE
+.PP
+DPkg::TriggersPending
+.RS 4
+Cette option est utile pour la configuration en mode \(Fo\ \&smart\ \&\(Fc\&. En effet, un paquet qui a des actions différées (\(Fo\ \&triggers\ \&\(Fc) en attente n\*(Aqest pas considéré comme installé (état \(Fo\ \&installed\ \&\(Fc) et dpkg le considère actuellement comme simplement décompacté (état \(Fo\ \&unpacked\ \&\(Fc) ce qui empêche une gestion correcte des pré\-dépendances (voir le bogue Debian #526774)\&. Veuillez noter que cette option provoquera la gestion de toutes les actions différées, pas seulement celles concernant le paquet en cours de traitement\&.
+.RE
+.PP
+PackageManager::UnpackAll
+.RS 4
+Cette option permet de ne trier les opérations de décompactage qu\*(Aqen fonction de leur criticité (c\*(Aqest à dire en ne considérant que les pré\-dépendances) dans le cas où la configuration des paquets est différée pour n\*(Aqêtre effectuée qu\*(Aqà la fin par dpkg\&. Cette option est active par défaut, ce qui revient à la méthode traditionnelle où les opérations ont lieu en plusieurs étapes, selon l\*(Aqensemble des critères de tri\&. Bien que les deux méthodes existent même dans les versions, la méthode \(Fo\ \&OrderCritical\ \&\(Fc n\*(Aqétait pas utilisée\&. Elle doit donc être considérée comme très expérimentale et a besoin de nombreuses améliorations avant de devenir réellement utile\&. (Note du traducteur\ \&:\ \&la version originale de cette partie des pages de manuel est très confuse\&. Il est donc conseillé de s\*(Aqy reporter en cas de doute car le contresens de traduction n\*(Aqest pas exclu\&.\&.\&.)\&.
+.RE
+.PP
+OrderList::Score::Immediate
+.RS 4
+Les paquets essentiels (et leurs dépendances) devraient être configurés après avoir été décompressés\&. Il est conseillé que cette opération ait lieu le plus tôt possible dans le processus de mise à jour car ces opérations de configuration nécessitent également
+DPkg::TriggersPending, ce qui peut conduire à l\*(Aqexécution de certains actions différées qui ne sont pas nécessairement utiles\&. Les paquets essentiels obtiennent par défaut un score élevé mais le marqueur \(Fo\ \&immédiat\ \&\(Fc implique un score assez bas (par exemple un paquet qui comporte des prédépendances obtient un score plus élevé)\&. Cette option et les options du même groupe permettent de modifier la façon d\*(Aqattribuer un score\&. L\*(Aqexemple ci\-dessous indique ces réglages avec leurs valeurs par défaut\&.
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+OrderList::Score {
+ Delete 500;
+ Essential 200;
+ Immediate 10;
+ PreDepends 50;
+};
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+.RE
+.SH "OPTIONS \(Fo\ \&PERIODIC\ \&\(Fc ET \(Fo\ \&ARCHIVE\ \&\(Fc"
+.PP
+Les groupes d\*(Aqoptions
+APT::Periodic
+et
+APT::Archive
+configurent les comportements périodiques réalisés par le script
+/etc/cron\&.daily/apt, lancé quotidiennement\&.
+.SH "LES OPTIONS DE DéBOGAGE"
+.PP
+Les options de la section
+Debug::
+servent soit à provoquer l\*(Aqaffichage d\*(Aqinformations de débogage sur la sortie d\*(Aqerreur standard du programme qui utilise les librairies APT, soit à activer des modes de fonctionnement spéciaux qui sont principalement utiles pour déboguer le comportement de
+APT\&. La plupart de ces options n\*(Aqont pas d\*(Aqintérêt pour un utilisateur normal, mais certaines peuvent tout de même être utiles\ \&:
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
Debug::pkgProblemResolver
-affiche d\'intéressantes informations sur les décisions que prend la commande dist\-upgrade\&.
+affiche d\*(Aqintéressantes informations sur les décisions prises par les commandes
+dist\-upgrade, upgrade, install, remove et purge\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
Debug::NoLocking
-désactive le verrouillage de fichier de manière à ce que APT puisse effectuer quelques opérations sans être \(Fo\ \&root\ \&\(Fc et
+désactive le verrouillage de fichier de manière à ce qu\*(AqAPT puisse effectuer quelques opérations (telles que
+apt\-get \-s install) sans avoir les privilèges du superutilisateur\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
Debug::pkgDPkgPM
-affiche la ligne de commande à chaque appel de Dpkg\&.
+affiche la ligne de commande à chaque appel de
+\fBdpkg\fR(1)\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+
Debug::IdentCdrom
-désactive l\'inclusion de données de type statfs dans les ID de CDROM\&.
+désactive l\*(Aqinclusion de données de type statfs dans les identifiants de CD\&.
+.RE
+.PP
+Liste complète des options de débogage de APT\ \&:
+.PP
+Debug::Acquire::cdrom
+.RS 4
+Affiche les informations concernant les sources de type
+cdrom://
+.RE
+.PP
+Debug::Acquire::ftp
+.RS 4
+Affiche les informations concernant le téléchargement de paquets par FTP\&.
+.RE
+.PP
+Debug::Acquire::http
+.RS 4
+Affiche les informations concernant le téléchargement de paquets par HTTP\&.
+.RE
+.PP
+Debug::Acquire::https
+.RS 4
+Print information related to downloading packages using HTTPS\&.
+.RE
+.PP
Debug::Acquire::gpgv
-Débogage de la méthode gpgv\&.
+.RS 4
+Affiche les informations relatives à la vérification de signatures cryptographiques avec
+gpg\&.
+.RE
+.PP
+Debug::aptcdrom
+.RS 4
+Affiche des informations concernant l\*(Aqaccès aux collections de paquets stockées sur CD\&.
+.RE
+.PP
+Debug::BuildDeps
+.RS 4
+Décrit le processus de résolution des dépendances pour la construction de paquets source (\ \&\(Fo\ \&build\-dependencies\ \&\(Fc\ \&) par
+\fBapt-get\fR(8)\&.
+.RE
+.PP
+Debug::Hashes
+.RS 4
+Affiche toutes les clefs de hachage cryptographiques créées par les librairies d\*(Aqapt\&.
+.RE
+.PP
+Debug::IdentCDROM
+.RS 4
+Désactive l\*(Aqinclusion des données de type
+statfs
+pour la génération des identifiants de CD, c\*(Aqest\-à\-dire le nombre de blocs libres et utilisés sur le système de fichier du CD\&.
+.RE
+.PP
+Debug::NoLocking
+.RS 4
+Désactive le verrouillage de fichiers\&. Cela permet par exemple de lancer deux instances de
+\(lqapt\-get update\(rq
+en même temps\&.
+.RE
+.PP
+Debug::pkgAcquire
+.RS 4
+Trace les ajouts et suppressions d\*(Aqéléments de la queue globale de téléchargement\&.
+.RE
+.PP
+Debug::pkgAcquire::Auth
+.RS 4
+Affiche les détails de la vérification des sommes de contrôle et des signatures cryptographiques des fichiers téléchargés, ainsi que les erreurs éventuelles\&.
+.RE
+.PP
+Debug::pkgAcquire::Diffs
+.RS 4
+Affiche les informations de téléchargement et de prise en compte des fichiers différentiels des indexes de paquets, ainsi que les erreurs éventuelles\&.
+.RE
+.PP
+Debug::pkgAcquire::RRed
+.RS 4
+Affiche les détails de l\*(Aqapplication des fichiers de différences aux listes de paquets d\*(AqAPT quand ces fichiers de différences sont téléchargés à la place des fichiers complets\&.
+.RE
+.PP
+Debug::pkgAcquire::Worker
+.RS 4
+Affiche toutes les interactions avec les processus enfants qui se chargent effectivement des téléchargements\&.
+.RE
+.PP
+Debug::pkgAutoRemove
+.RS 4
+Affiche les changements concernant le marquage des paquets comme installés automatiquement, et la suppression des paquets inutiles\&.
+.RE
+.PP
+Debug::pkgDepCache::AutoInstall
+.RS 4
+Crée les informations de débogage décrivant quels paquets sont installés automatiquement pour satisfaire les dépendances\&. Cela concerne la passe initiale d\*(Aqinstallation automatique effectuée par exemple par
+apt\-get install
+et pas le système de résolution de dépendances complet de APT\ \&; voir
+Debug::pkgProblemResolver
+pour ce dernier\&.
+.RE
+.PP
+Debug::pkgDepCache::Marker
+.RS 4
+Crée les informations de débogage décrivant quels paquets sont gardés/installés/supprimés pendant le travail de l\*(Aqoutil de résolution de problèmes\&. Chaque ajout ou suppression peut impliquer des actions supplémentaires\ \&;\ \&elles sont alors indiquées avec une indentation de deux espaces de plus que l\*(Aqaction qui les a déclenchées\&. Le format de chaque ligne est
+MarkKeep,
+MarkDelete
+ou
+MarkInstall
+suivi de
+nom\-paquet <a\&.b\&.c \-> d\&.e\&.f | x\&.y\&.z> (section)
+où
+a\&.b\&.c
+est la version actuelle du paquet,
+d\&.e\&.f
+la version devant être installée et
+x\&.y\&.z
+une version plus récente qui n\*(Aqest pas prévue pour être installée (à cause d\*(Aqun score plus faible)\&. Ces deux derniers éléments peuvent ne pas être mentionnés s\*(Aqils ne sont pas pertinents où lorsque ils sont identiques à la version installée\&.
+section
+est le nom de la section où figure le paquet\&.automatiquement pour satisfaire les dépendances\&. Cela concerne la passe initiale d\*(Aqinstallation automatique effectuée par exemple par
+apt\-get install
+et pas le système de résolution de dépendances complet de APT\ \&; voir
+Debug::pkgProblemResolver
+pour ce dernier\&.
+.RE
+.PP
+Debug::pkgInitConfig
+.RS 4
+Affiche, au lancement, l\*(Aqensemble de la configuration sur la sortie d\*(Aqerreur standard\&.
+.RE
+.PP
+Debug::pkgDPkgPM
+.RS 4
+Affiche la commande exacte d\*(Aqinvocation de
+\fBdpkg\fR(1)
+à chaque appel\ \&; les paramètres sont séparés par des espaces\&.
+.RE
+.PP
+Debug::pkgDPkgProgressReporting
+.RS 4
+Affiche l\*(Aqensemble des informations reçues de
+\fBdpkg\fR(1)
+par l\*(Aqintermédiaire du descripteur de fichier d\*(Aqétat, et les éventuelles erreurs d\*(Aqanalyse de ce fichier\&.
+.RE
+.PP
+Debug::pkgOrderList
+.RS 4
+Affiche les étapes de l\*(Aqalgorithme utilisé pour choisir l\*(Aqordre dans lequel
+apt
+passe les paquets à
+\fBdpkg\fR(1)\&.
+.RE
+.PP
+Debug::pkgPackageManager
+.RS 4
+Affiche le détail des opérations liées à l\*(Aqinvocation de
+\fBdpkg\fR(1)\&.
+.RE
+.PP
+Debug::pkgPolicy
+.RS 4
+Affiche, au lancement, la priorité de chaque liste de paquets\&.
+.RE
+.PP
+Debug::pkgProblemResolver
+.RS 4
+Affiche la trace d\*(Aqexécution du système de résolution de dépendances (ne concerne que les cas où un problème de dépendances complexe se présente)\&.
+.RE
+.PP
+Debug::pkgProblemResolver::ShowScores
+.RS 4
+Affiche la liste de tous les paquets installés avec leur score calculé par l\*(Aqoutil de résolution de problèmes\&. La description du paquet est celle qui est décrite dans
+Debug::pkgDepCache::Marker\&.
+.RE
+.PP
+Debug::sourceList
+.RS 4
+Affiche les fournisseurs déclarés dans le fichier
+/etc/apt/vendors\&.list\&.
+.RE
.SH "EXEMPLES"
.PP
Le fichier
-\fI/usr/share/doc/apt/examples/configure\-index\&.gz\fR
-contient un modèle de fichier montrant les valeurs par défaut de toutes les options possibles\&.
+/usr/share/doc/apt/examples/configure\-index\&.gz
+contient un modèle de fichier montrant des exemples pour toutes les options existantes\&.
.SH "FICHIERS"
.PP
-
-\fI/etc/apt/apt\&.conf\fR
+/etc/apt/apt\&.conf
+.RS 4
+Fichier de configuration d\*(AqAPT\&. Élément de configuration\ \&:
+Dir::Etc::Main\&.
+.RE
+.PP
+/etc/apt/apt\&.conf\&.D/
+.RS 4
+Fragments du fichier de configuration d\*(AqAPT\&. Élément de configuration\ \&:
+Dir::Etc::Parts\&.
+.RE
.SH "VOIR AUSSI"
.PP
\fBapt_preferences\fR(5)\&.
.SH "BOGUES"
.PP
-Voyez la
-\fI page concernant les bogues d\'APT\fR\&[1]\&. Si vous voulez signaler un bogue, consultez le texte
-\fI/usr/share/doc/debian/bug\-reporting\&.txt\fR
-ou utilisez la commande
+\m[blue]\fBPage des bogues d\*(AqAPT\fR\m[]\&\s-2\u[1]\d\s+2\&. Si vous souhaitez signaler un bogue à propos d\*(AqAPT, veuillez lire
+/usr/share/doc/debian/bug\-reporting\&.txt
+ou utiliser la commande
\fBreportbug\fR(1)\&.
-.SH "TRADUCTION"
+.SH "TRADUCTEURS"
+.PP
+Jérôme Marant, Philippe Batailler, Christian Perrier
+bubulle@debian\&.org
+(2000, 2005, 2009, 2010), Équipe de traduction francophone de Debian
+debian\-l10n\-french@lists\&.debian\&.org
.PP
-Jérôme Marant\&. 2000\ \&; mise à jour : Philippe Batailler\&. 2005\&.
-<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 légèrement en retard sur le contenu d\*(Aqorigine\&.
.SH "AUTHORS"
.PP
\fBJason Gunthorpe\fR
-.sp -1n
-.IP "" 4
-Auteur.
-.PP
-\fBAPT team\fR
-.sp -1n
-.IP "" 4
-Auteur.
+.RS 4
+.RE
+.PP
+\fBÉquipe de développement d\*(AqAPT\fR
+.RS 4
+.RE
+.PP
+\fBDaniel Burrows\fR <\&dburrows@debian\&.org\&>
+.RS 4
+Initial documentation of Debug::*\&.
+.RE
.SH "NOTES"
.IP " 1." 4
-page concernant les bogues d'APT
+Page des bogues d'APT
.RS 4
\%http://bugs.debian.org/src:apt
.RE
projects / apt-legacy.git / blobdiff