- initial import of revision 374 from cnc
[apt.git] / doc / fr / apt.conf.fr.5.sgml
1 <!-- -*- mode: sgml; mode: fold -*- -->
2 <!-- translation of version 1.9 -->
3 <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
4
5 <!ENTITY % aptent SYSTEM "apt.ent.fr">
6 %aptent;
7
8 ]>
9
10 <refentry lang=fr>
11  &apt-docinfo;
12  
13  <refmeta>
14    <refentrytitle>apt.conf</>
15    <manvolnum>5</>
16  </refmeta>
17  
18  <!-- Man page title -->
19  <refnamediv>
20     <refname>apt.conf</>
21     <refpurpose>Fichier de configuration pour APT</>
22  </refnamediv>
23  
24  <RefSect1><Title>Description</>
25    <para>   
26    <filename/apt.conf/ est le principal fichier de configuration de la 
27 collection d'outils que constitue APT&nbsp;; tous les outils font appel à ce 
28 fichier de configuration et utilisent un analyseur syntaxique en ligne de 
29 commande commun afin de fournir un environnement uniforme. Quand un outil
30 d'APT démarre, il lit (si elle existe) la variable d'environnement 
31 <envar/APT_CONFIG/&nbsp;; puis il lit les fichiers situés dans 
32 <literal/Dir::Etc::Parts/ ainsi que le principal fichier de configuration
33 indiqué par <literal/Dir::Etc::main/&nbsp;; enfin il applique les options de 
34 la ligne de commande qui annulent les directives de configuration, chargeant,
35 si nécessaire, d'autres fichiers de configuration.
36    <para>
37 Le fichier de configuration est construit comme un arbre d'options
38 organisées en groupes fonctionnels. On se sert du double deux points («&nbsp;::&nbsp;») pour indiquer une option&nbsp;; par exemple, <literal/APT::Get::Assume-Yes/ est
39 une option pour le groupe d'outils APT, destinée à l'outil Get. Les options
40 n'héritent pas des groupes de leurs parents.
41    <para>
42 Syntaxiquement, le langage de configuration est conçu sur le même modèle
43 que les langages utilisés par des outils ISC tels que bind et dhcp. Chaque 
44 ligne est de la forme&nbsp;:
45    <literallayout>APT::Get::Assume-Yes "true";</literallayout> 
46 Le point-virgule final est obligatoire et les guillemets sont optionnels.
47 On peut déclarer un nouveau champ d'action avec des accolades, comme 
48 suit&nbsp;:
49 <informalexample><programlisting>   
50 APT {
51   Get {
52     Assume-Yes "true";
53     Fix-Broken "true";
54   };
55 };
56 </programlisting></informalexample>
57 avec des retours à la ligne pour faciliter la lecture. On peut créer des 
58 listes en ouvrant un champ d'action et en mettant un seul mot entre 
59 apostrophes suivi d'un point-virgule. On peut mettre plusieurs entrées,
60 séparées par un point-virgule.
61 <informalexample><programlisting>   
62 DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
63 </programlisting></informalexample>
64    <para>
65 Les modèles <filename>&docdir;examples/apt.conf</> &configureindex;
66 montrent à quoi devrait ressembler le fichier de configuration.
67    <para>
68 Deux éléments spéciaux sont autorisés&nbsp;: <literal/#include/ et 
69 <literal/#clear/. <literal/#include/ inclut le fichier donné en argument, à 
70 moins que le nom ne se termine par une barre oblique. <literal/#clear/ sert à 
71 effacer une liste de noms.
72    <para>
73 Tous les outils d'APT possèdent une option <option>-o</> qui permet de 
74 spécifier une configuration arbitraire depuis la ligne de commande. La 
75 syntaxe consiste en un nom complet d'option (par exemple 
76 <literal/APT::Get::Assume-Yes/) suivi par un signe égal, puis par la nouvelle 
77 valeur de l'option. On peut compléter une liste en ajoutant un «&nbsp;::&nbsp;» au nom 
78 de la liste.
79  </RefSect1>
80
81  <RefSect1><Title>Le groupe APT</>
82    <para>   
83 Ce groupe d'options contrôle aussi bien le comportement global d'APT que
84 la prise en compte des options pour chaque outil.
85
86    <VariableList>
87      <VarListEntry><Term>Architecture</Term>
88      <ListItem><Para>
89 L'architecture du système&nbsp;; cette option positionne l'architecture à utiliser 
90 pour récupérer des fichiers et analyser des listes de paquets. L'architecture 
91 interne par défaut est celle pour laquelle APT a été compilé.
92      </VarListEntry>
93      
94      <VarListEntry><Term>Ignore-Hold</Term>
95      <ListItem><Para>
96 Ignore les paquets «&nbsp;gelés&nbsp;»&nbsp;; cette option globale indique au 
97 système de résolution de ne pas tenir compte des paquets «&nbsp;gelés&nbsp;» 
98 dans sa prise de décision.
99      </VarListEntry>
100
101      <VarListEntry><Term>Clean-Installed</Term>
102      <ListItem><Para>
103 Avec cette option qui est activée par défaut, la fonctionnalité «&nbsp;autoclean&nbsp;»
104 supprime tout paquet qui ne peut plus être récupéré dans le cache.
105 Quand cette option est désactivée, les paquets qui sont installés localement
106 sont aussi exclus du nettoyage - mais notez que APT ne fournit aucun moyen
107 direct pour les réinstaller.
108      </VarListEntry>
109
110      <VarListEntry><Term>Immediate-Configure</Term>
111      <ListItem><Para>
112 Désactive la configuration immédiate&nbsp;; cette dangereuse option désactive
113 une partie du code de mise en ordre de APT pour que ce dernier effectue le
114 moins d'appels possible à Dpkg. C'est peut-être nécessaire sur des systèmes
115 lents à un seul utilisateur mais c'est extrêmement dangereux et cela peut 
116 faire échouer les scripts d'installation, voire pire.
117 Utilisez-la à vos risques et périls.
118      </VarListEntry>
119
120      <VarListEntry><Term>Force-LoopBreak</Term>
121      <ListItem><Para>
122 Ne jamais activer cette option à moins que vous ne sachiez - réellement - ce 
123 que vous faites. Elle autorise APT à supprimer temporairement un paquet
124 essentiel pour mettre fin à une boucle Conflicts / Conflicts ou
125 Conflicts / Pre-Depends entre deux paquets essentiels. UNE TELLE BOUCLE
126 NE DOIT JAMAIS SE PRODUIRE&nbsp;: C'EST UN BOGUE SÉRIEUX. Cette option 
127 fonctionne si les paquets essentiels ne sont pas tar, gzip, libc, dpkg, bash 
128 ou tous les paquets dont ces paquets dépendent.
129      </VarListEntry>
130
131      <VarListEntry><Term>Cache-Limit</Term>
132      <ListItem><Para>
133 APT utilise un fichier cache d'une taille mémoire fixe pour ranger les
134 informations du fichier «&nbsp;available&nbsp;». Cette option fixe la taille 
135 de ce cache.
136      </VarListEntry>
137
138      <VarListEntry><Term>Build-Essential</Term>
139      <ListItem><Para>
140      Cette option définit les paquets qui sont considérés comme faisant partie
141 des dépendances essentielles pour la construction des paquets.
142      </VarListEntry>
143
144      <VarListEntry><Term>Get</Term>
145      <ListItem><Para>
146 La sous-section <literal/Get/ contrôle l'outil &apt-get;, veuillez consulter
147 sa documentation pour avoir plus d'informations sur les options en question.
148      </VarListEntry>
149
150      <VarListEntry><Term>Cache</Term>
151      <ListItem><Para>
152 La sous-section <literal/Cache/ contrôle l'outil &apt-cache;, veuillez 
153 consulter sa documentation pour avoir plus d'informations sur les options en 
154 question.
155      </VarListEntry>
156
157      <VarListEntry><Term>CDROM</Term>
158      <ListItem><Para>
159 La sous-section <literal/CDROM/ contrôle l'outil &apt-cdrom;, veuillez 
160 consulter sa documentation pour avoir plus d'informations sur les options en 
161 question.
162      </VarListEntry>
163    </VariableList>
164  </RefSect1>
165
166  <RefSect1><Title>Le groupe Acquire</>
167    <para>   
168 Le groupe d'options <literal/Acquire/ contrôle le téléchargement des paquets et
169 les gestionnaires d'URI.
170
171    <VariableList>
172      <VarListEntry><Term>Queue-Mode</Term>
173      <ListItem><Para>
174 Le mode file d'attente&nbsp;; <literal/Queue-Mode/ peut prendre une valeur 
175 parmi <literal/host/ ou <literal/access/ et cela détermine comment APT 
176 parallélise les connexions sortantes. <literal/host/ signifie qu'une 
177 connexion par cible sera initiée, tandis que <literal/access/ signifie qu'une 
178 connexion par type d'URI sera initiée.
179      </VarListEntry>
180
181      <VarListEntry><Term>Retries</Term>
182      <ListItem><Para>
183 Nombre d'essais à effectuer. Si ce nombre n'est pas nul, APT essaie de
184 récupérer, le nombre donné de fois, les fichiers dont la récupération a échoué.
185      </VarListEntry>
186
187      <VarListEntry><Term>Source-Symlinks</Term>
188      <ListItem><Para>
189 Utilise des liens symboliques pour les archives de sources. Positionnée à 
190 «&nbsp;true&nbsp;»,  cette option crée si possible des liens symboliques vers 
191 les archives de sources au lieu de les copier. 
192 Par défaut à «&nbsp;true&nbsp;».
193      </VarListEntry>
194
195      <VarListEntry><Term>http</Term>
196      <ListItem><Para>
197 HTTP URIs; http::Proxy est le mandataire (proxy) http à utiliser par défaut.
198 Il se présente sous la forme standard&nbsp;:
199 <literal>http://[[user][:pass]@]host[:port]/</>. En utilisant la syntaxe&nbsp;:
200 <literal/http::Proxy::&lt;host&gt;/, où le mot-clé spécial <literal/DIRECT/
201 indique de n'utiliser aucun mandataire, on peut spécifier un mandataire
202 pour chaque machine distante. La variable d'environnement <envar/http_proxy/
203 remplace tous ces paramètres.
204      <para>
205 Trois options de configuration sont fournies pour le contrôle des caches qui
206 sont compatibles avec HTTP/1.1. <literal/No-Cache/ signifie que le mandataire
207 ne doit pas du tout utiliser les réponses qu'il a stockées&nbsp;; <literal/Max-Age/
208 sert uniquement pour les fichiers d'index&nbsp;: cela demande au cache de les 
209 mettre à jour quand leur ancienneté est supérieure au nombre de secondes 
210 donné. Debian met à jour son fichier d'index de manière journalière, la
211 valeur par défaut est donc de 1 jour. <literal/No-Store/ sert uniquement
212 pour les fichiers d'archive&nbsp;: cela demande au cache de ne jamais garder 
213 la requête. Cela peut éviter de polluer un cache mandataire avec des 
214 fichiers .deb très grands. Note&nbsp;: Squid 2.0.2 ne prend en compte aucune de 
215 ces options.
216      <para>
217 L'option <literal/timeout/ positionne le compteur de temps mort (timeout)
218 utilisé par la méthode&nbsp;: cela vaut pour tout (connexion, données).
219      <para>
220 Une option de configuration est fournie pour contrôler la profondeur du tube
221 pour le cas où un serveur distant n'est pas conforme à la RFC ou est bogué
222 (comme Squid 2.0.2). Acquire::http::Pipeline-Depth a une valeur
223 comprise entre 0 et 5&nbsp;: elle indique le nombre de requêtes en attente qui 
224 peuvent être émises. Quand la machine distante ne conserve pas correctement
225 les connexions TCP, on DOIT donner une valeur égale à 0 -- sinon des
226 données seront corrompues. Les machines qui ont besoin de cette option
227 ne respectent pas la RFC 2068.
228      </VarListEntry>
229
230      <VarListEntry><Term>ftp</Term>
231      <ListItem><Para>
232 FTP URIs&nbsp;; ftp::Proxy est le serveur mandataire par défaut à utiliser. Il se
233 présente sous la forme standard&nbsp;: 
234 <literal>ftp://[[user][:pass]@]host[:port]/</>&nbsp;; il est remplacé par la 
235 variable d'environnement <envar/ftp_proxy/. Pour utiliser un mandataire ftp,
236 vous devez renseigner l'entrée <literal/ftp::ProxyLogin/ dans le fichier de
237 configuration. Cette entrée spécifie les commandes qui disent au serveur
238 mandataire comment se connecter. Voyez &configureindex; pour savoir
239 comment faire. Les variables de substitution disponibles sont&nbsp;:
240 <literal/$(PROXY_USER)/, <literal/$(PROXY_PASS)/, <literal/$(SITE_USER)/,
241 <literal/$(SITE_PASS)/, <literal/$(SITE)/, et <literal/$(SITE_PORT)/.
242 Chacune correspond à un élément de l'URI.
243      <para>
244 L'option <literal/timeout/ positionne le compteur de temps mort (timeout)
245 utilisé par la méthode&nbsp;: cela vaut pour tout (connexion, données).
246      <para>
247 Plusieurs options de configuration sont fournies pour contrôler le mode 
248 passif. Généralement, c'est plus sûr d'activer le mode passif&nbsp;; cela 
249 marche dans presque tous les environnements. Cependant, certaines situations
250 nécessitent que le mode passif soit désactivé et que le mode 
251 «&nbsp;port&nbsp;» de ftp
252 soit utilisé à la place. On peut le faire globalement, pour des
253 connexions qui passent par un mandataire ou pour une machine
254 spécifique (examinez le modèle de fichier de configuration).
255      <para>
256 On peut utiliser un mandataire FTP pour atteindre une cible HTTP en
257 positionnant la variable d'environnement <envar/ftp_proxy/ à une url http --
258 consultez la méthode http ci-dessus pour la syntaxe. On ne peut pas fixer
259 cette variable dans le fichier de configuration et il n'est pas recommandé
260 d'utiliser HTTP par FTP à cause de son peu d'efficacité.
261      <para>
262 L'option <literal/ForceExtended/ contrôle l'utilisation des commandes liées 
263 à la RFC 2428, <literal/EPSV/ et <literal/EPRT/. Par défaut, elle vaut 
264 «&nbsp;false&nbsp;»&nbsp;; ce qui signifie que ces commandes ne sont 
265 utilisées que pour une connexion de type IPv6. Quand elle vaut 
266 «&nbsp;true&nbsp;», on les utilise même si la connexion est de type IPv4. La 
267 plupart des serveurs FTP ne suivent pas la RFC 2428.
268      </VarListEntry>
269
270      <VarListEntry><Term>cdrom</Term>
271      <ListItem><Para>
272 CDROM URIs&nbsp;; la seule option de configuration pour les URIs de CDROM
273 est le point de montage&nbsp;: <literal/cdrom::Mount/&nbsp;; il doit 
274 représenter le point de montage du lecteur de cédérom indiqué dans 
275 <filename>/etc/fstab</>. 
276 On peut fournir d'autres commandes de montage et de démontage quand le
277 point de montage ne peut être listé dans le fichier <filename>/etc/fstab</>
278 (par exemple, un montage SMB ou ...). Syntaxiquement, il faut placer
279 <literallayout>"/cdrom/"::Mount "foo";</literallayout> dans le bloc cdrom.
280 La barre oblique finale est importante. Les commandes de démontage
281 peuvent être spécifiées en utilisant <literal/UMount/.
282      </VarListEntry>
283    </VariableList>
284  </RefSect1>
285
286  <RefSect1><Title>Les répertoires</>
287    <para>   
288 Les répertoires de la section <literal/Dir::State/ concernent le système
289 local. <literal/lists/ est le répertoire où placer les listes de paquets
290 téléchargés et <literal/status/ est le nom du fichier d'état de Dpkg.
291 <literal/preferences/ concerne APT&nbsp;: c'est le nom du fichier des 
292 préférences.
293 <literal/Dir::State/ contient le répertoire par défaut préfixé à tous les
294 sous-éléments, quand ceux-ci ne commencent pas par <filename>/</> 
295 ou <filename>./</>.
296    <para>
297 <literal/Dir::Cache/ contient les emplacements qui renseignent sur le
298 cache local&nbsp;: par exemple, les deux caches de paquets 
299 <literal/srcpkgcache/ et <literal/pkgcache/, et aussi l'endroit où sont 
300 placées les archives téléchargées, <literal/Dir::Cache::archives/. On peut 
301 empêcher la création des caches en laissant leur nom en blanc. Cela ralentit 
302 le démarrage mais cela sauve de l'espace disque. Il vaut mieux se passer du 
303 cache <literal/pkgcache/ plutôt que se passer du cache <literal/srcpkgcache/. 
304 Comme pour <literal/Dir::State/, le répertoire par défaut est contenu dans
305 <literal/Dir::Cache/.
306    <para>
307 <literal/Dir::Etc/ contient l'emplacement des fichiers de configuration,
308 <literal/sourcelist/ indique l'emplacement de la liste de sources et 
309 <literal/main/ est le fichier de configuration par défaut (le modifier
310 n'a aucun effet, à moins qu'on ne le modifie avec le fichier de 
311 configuration indiqué par la variable <envar/APT_CONFIG/). 
312    <para>
313 <literal/Dir::Parts/ lit, par ordre d'entrée, tous les fragments de 
314 configuration dans le répertoire indiqué. Ensuite, le fichier principal
315 de configuration est chargé.
316    <para>
317 Les programmes binaires sont pointés par <literal/Dir::Bin/.
318 L'emplacement des gestionnaires de méthodes est indiqué par
319 <literal/methods/&nbsp;; <literal/gzip/, <literal/Dpkg/, <literal/apt-get/,
320 <literal/dpkg-source/, <literal/dpkg-buildpackage/ et <literal/apt-cache/
321 indiquent l'emplacement des programmes correspondants.
322  </RefSect1>
323  
324  <RefSect1><Title>APT et DSelect</>
325    <para>   
326 Quand APT est utilisé comme une méthode de &dselect;, plusieurs directives 
327 contrôlent le comportement par défaut. On les trouve dans la section
328 <literal/DSelect/.
329    
330    <VariableList>
331      <VarListEntry><Term>Clean</Term>
332      <ListItem><Para>
333 Mode de nettoyage du cache&nbsp;; cette variable peut prendre l'une des valeurs
334 suivantes&nbsp;: «&nbsp;always&nbsp;», «&nbsp;prompt&nbsp;», 
335 «&nbsp;auto&nbsp;», «&nbsp;pre-auto&nbsp;» et «&nbsp;never&nbsp;». 
336 «&nbsp;always&nbsp;» et «&nbsp;prompt&nbsp;» suppriment tous les paquets du 
337 cache après la mise à niveau&nbsp;; «&nbsp;prompt&nbsp;» (valeur par défaut) 
338 les supprime après une demande et «&nbsp;auto&nbsp;» ne supprime que les 
339 archives qui ne peuvent plus être téléchargées (remplacées, par exemple, par 
340 une nouvelle version). «&nbsp;pre-auto&nbsp;» les supprime avant de récupérer 
341 de nouveaux paquets.
342      </VarListEntry>
343      
344      <VarListEntry><Term>Options</Term>
345      <ListItem><Para>
346 Le contenu de cette variable est passé à &apt-get; avec les options de la ligne
347 de commande quand ce programme est utilisé dans la phase d'installation.
348      </VarListEntry>
349
350      <VarListEntry><Term>UpdateOptions</Term>
351      <ListItem><Para>
352 Le contenu de cette variable est passé à &apt-get; avec les options de la 
353 ligne de commande quand ce programme est utilisé dans la phase de mise à jour.
354      </VarListEntry>
355
356      <VarListEntry><Term>PromptAfterUpdate</Term>
357      <ListItem><Para>
358 Si cette option est «&nbsp;vraie&nbsp;», l'opération [U]pdate de &dselect; 
359 interroge toujours l'utilisateur avant de continuer. Par défaut, ce n'est 
360 qu'en cas d'erreur que l'on propose à l'utilisateur d'intervenir.
361      </VarListEntry>
362    </VariableList>
363  </RefSect1>
364  
365  <RefSect1><Title>Comment APT appelle Dpkg</>
366    <para>   
367 Plusieurs directives de configuration contrôlent la manière dont APT
368 invoque &dpkg;&nbsp;: elles figurent dans la section <literal/DPkg/.
369
370    <VariableList>
371      <VarListEntry><Term>Options</Term>
372      <ListItem><Para>
373 Il s'agit d'une liste d'options à passer à dpkg. Les options doivent être
374 déclarées en utilisant la notation de liste et chaque élément de liste est
375 passé comme un seul argument à &dpkg;.
376      </VarListEntry>
377      
378      <VarListEntry><Term>Pre-Invoke</Term><Term>Post-Invoke</Term>
379      <ListItem><Para>
380 Il s'agit d'une liste de commandes shell à exécuter avant ou après l'appel de
381 &dpkg;. Tout comme pour <literal/Options/, on doit utiliser la notation de
382 liste. Les commandes sont appelées dans l'ordre, en utilisant 
383 <filename>/bin/sh</>&nbsp;: APT s'arrête dès que l'une d'elles échoue.
384      </VarListEntry>
385
386      <VarListEntry><Term>Pre-Install-Pkgs</Term>
387      <ListItem><Para>
388 Il s'agit d'une liste de commandes shell à exécuter avant d'appeler Dpkg. 
389 Tout comme pour <literal/Options/, on doit utiliser la notation de liste.
390 Les commandes sont appelées dans l'ordre, en utilisant 
391 <filename>/bin/sh</>&nbsp;: APT s'arrête dès que l'une d'elles échoue. Sur 
392 l'entrée standard, APT transmet aux commandes les noms de tous les fichiers 
393 .deb qu'il va installer, à raison d'un par ligne.
394      <para>
395 La deuxième version de ce protocole donne plus de renseignements&nbsp;: on 
396 obtient la version du protocole, la configuration de APT et les paquets, 
397 fichiers ou versions qui ont changé. On autorise cette version en positionnant
398 <literal/DPkg::Tools::Options::cmd::Version/ à 2. <literal/cmd/ est une 
399 commande passée à <literal/Pre-Install-Pkgs/.
400      </VarListEntry>
401
402      <VarListEntry><Term>Run-Directory</Term>
403      <ListItem><Para>
404 APT se place dans ce répertoire avant d'appeler Dpkg&nbsp;; par défaut c'est 
405 le répertoire <filename>/</>.
406      </VarListEntry>
407
408      <VarListEntry><Term>Build-Options</Term>
409      <ListItem><Para>
410 Ces options sont passées à &dpkg-buildpackage; lors de la compilation des
411 paquets&nbsp;; par défaut la signature est désactivée et tous les binaires sont
412 créés.
413      </VarListEntry>
414    </VariableList>
415  </RefSect1>
416
417  <RefSect1><Title>Les options de débogage</>
418    <para>   
419 La plupart des options de la section <literal/debug/ n'ont aucun intérêt
420 pour le simple utilisateur&nbsp;; cependant, 
421 <literal/Debug::pkgProblemResolver/ affiche d'intéressantes informations sur 
422 les décisions que prend la commande dist-upgrade. <literal/Debug::NoLocking/ 
423 désactive le verrouillage de fichier de manière à ce que APT puisse effectuer 
424 quelques opérations sans être «&nbsp;root&nbsp;» et 
425 <literal/Debug::pkgDPkgPM/ affiche la ligne de commande à chaque appel de 
426 Dpkg. <literal/Debug::IdentCdrom/ désactive l'inclusion de 
427 données de type statfs dans les ID de CDROM.
428  </RefSect1>
429  
430  <RefSect1><Title>Exemples</>
431    <para>
432    &configureindex; contient un modèle de fichier montrant les valeurs par
433 défaut de toutes les options possibles.
434  </RefSect1>
435  
436  <RefSect1><Title>Fichiers</>
437    <para>
438    <filename>/etc/apt/apt.conf</>
439  </RefSect1>
440  
441  <RefSect1><Title>Voir aussi</>
442    <para>
443    &apt-cache;, &apt-config;, &apt-preferences;.
444  </RefSect1>
445
446  &manbugs;
447  &manauthor;
448  &deux-traducteurs;
449
450 </refentry>