summaryrefslogtreecommitdiff
path: root/doc/fr/apt.conf.fr.5.xml
blob: f4d8eddb803fc723807c6700db696d5cd55609ee (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
<?xml version="1.0" encoding="iso-8859-15" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

<!ENTITY % aptent SYSTEM "apt.ent.fr">
%aptent;

]>

<refentry lang="fr">

 <refentryinfo>
   &apt-author.jgunthorpe;
   &apt-author.team;
   &apt-email;
   &apt-product;
   <!-- The last update date -->
   <date>11 juillet 2008</date>
 </refentryinfo>

<refmeta>
<refentrytitle>apt.conf</refentrytitle>
<manvolnum>5</manvolnum>
</refmeta>

<refnamediv><refname>apt.conf</refname>
<refpurpose>Fichier de configuration pour APT</refpurpose>
</refnamediv>

<refsect1><title>Description</title>
<para>   
Le fichier <filename>apt.conf</filename> est le principal fichier de configuration 
de la collection d'outils que constitue APT&nbsp;; 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 la configuration d�sign�e par variable d'environnement 
<envar>APT_CONFIG</envar> (si elle existe), puis il lit les fichiers situ�s dans 
<literal>Dir::Etc::Parts</literal> ainsi que le principal fichier de configuration
indiqu� par <literal>Dir::Etc::main</literal>&nbsp;; enfin il applique les options de 
la ligne de commande qui pr�valent sur les directives de configuration, chargeant
si n�cessaire d'autres fichiers de configuration.
   </para>
<para>
Le fichier de configuration est construit comme un arbre d'options
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</literal> est
une option pour le groupe d'outils APT, destin�e � l'outil Get. Il n'y a pas d'h�ritage
des options des groupes parents.
   </para>
<para>
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 <literal>//</literal> est trait�e comme un commentaire et ignor�e, de
m�me que les sections de texte plac�es entre <literal>/*</literal> et
<literal>*/</literal>, tout comme les commentaires C/C++.
Chaque ligne est de la forme&nbsp;:
<informalexample><programlisting>
<literal>APT::Get::Assume-Yes "true";</literal> 
     </programlisting></informalexample>
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&nbsp;:
</para>

<informalexample><programlisting>   
APT {
  Get {
    Assume-Yes "true";
    Fix-Broken "true";
  };
};
</programlisting></informalexample>

<para>
avec des retours � la ligne pour faciliter la lecture. On peut cr�er une liste
en ouvrant un champ d'action et en y ins�rant une cha�ne entre guillemets suivie
d'un point virgule pour chaque �l�ment de la liste.
</para>

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

<para>
Les mod�les <filename>&docdir;examples/apt.conf</filename> et &configureindex;
montrent � quoi devrait ressembler le fichier de configuration.
   </para>
<para>
Les identifiants des options de configuration ne sont pas sensibles � la casse.
Dans l'exemple pr�c�dent, on pourrait donc aussi bien utiliser 
<literal>dpkg::pre-install-pkgs</literal>.
   </para>
<para>
Deux �l�ments sp�ciaux sont autoris�s&nbsp;: <literal>#include</literal> et 
<literal>#clear</literal>. <literal>#include</literal> inclut le fichier donn� en
argument, � moins que le nom ne se termine par une barre oblique auquel cas le
r�pertoire entier est inclus. <literal>#clear</literal> sert � 
effacer une partie de l'arbre de configuration. L'�l�ment d�sign� et tout ses
descendants sont supprim�s.
   </para>
<para>
Tous les outils d'APT poss�dent une option <option>-o</option> qui permet de 
sp�cifier une configuration arbitraire depuis la ligne de commande. La 
syntaxe consiste en un nom complet d'option (par exemple 
<literal>APT::Get::Assume-Yes</literal>) suivi par un signe �gal, puis par la nouvelle 
valeur de l'option. On peut compl�ter une liste en ajoutant un �&nbsp;::&nbsp;� au nom 
de la liste.
   </para>
</refsect1>

<refsect1><title>Le groupe APT</title>
<para>
Ce groupe d'options contr�le le comportement global d'APT et contient �galement
des options communes � tous les outils.
</para>
   <variablelist>
<varlistentry><term>Architecture</term>
<listitem><para>
L'architecture du syst�me&nbsp;; cette option positionne l'architecture � utiliser 
pour r�cup�rer des fichiers et analyser des listes de paquets. La valeur interne par
d�faut est l'architecture pour laquelle APT a �t� compil�.
     </para></listitem>
</varlistentry>

<varlistentry><term>Default-Release</term>
<listitem><para>
Indique la distribution � utiliser par d�faut lors de l'installation d'un
paquet si plusieurs versions sont disponibles. La valeur peut �tre un nom de
distribution ou un num�ro de version. Exemples&nbsp;: �&nbsp;stable&nbsp;�,
�&nbsp;testing&nbsp;�, �&nbsp;4.0&nbsp;�, �&nbsp;5.0*&nbsp;�. Les noms de codes
des distributions (�&nbsp;etch&nbsp;�, �&nbsp;lenny&nbsp;�, etc.) ne sont pas
permis pour l'instant. Voir aussi &apt-preferences;.
     </para></listitem>
</varlistentry>

<varlistentry><term>Ignore-Hold</term><listitem>
<para>
Ignore les paquets �&nbsp;gel�s&nbsp;�&nbsp;; cette option globale indique au 
syst�me de r�solution de ne pas tenir compte des paquets �&nbsp;gel�s&nbsp;� 
dans sa prise de d�cision.
     </para></listitem>
</varlistentry>

<varlistentry><term>Clean-Installed</term>
<listitem><para>
Avec cette option qui est activ�e par d�faut, la fonctionnalit� �&nbsp;autoclean&nbsp;�
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.
     </para></listitem>
</varlistentry>

<varlistentry><term>Immediate-Configure</term>
<listitem><para>
D�sactive la configuration imm�diate&nbsp;; 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;. �a peut �tre n�cessaire sur des syst�mes
� un seul utilisateur extr�mement lents, mais cette option est tr�s dangereuse et
peut faire �chouer les scripts d'installation, voire pire.
Utilisez-la � vos risques et p�rils.
     </para></listitem>
</varlistentry>

<varlistentry><term>Force-LoopBreak</term>
<listitem><para>
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&nbsp;: 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.
     </para></listitem>
</varlistentry>

<varlistentry><term>Cache-Limit</term>
<listitem><para>
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 pour le chargement de ce cache.
     </para></listitem>
</varlistentry>

<varlistentry><term>Build-Essential</term>
<listitem><para>
     Cette option d�finit les paquets qui sont consid�r�s comme faisant partie
des d�pendances essentielles pour la construction de paquets.
     </para></listitem>
</varlistentry>

<varlistentry><term>Get</term>
<listitem><para>La sous-section <literal>Get</literal> contr�le l'outil &apt-get;, 
veuillez consulter sa documentation pour avoir plus d'informations sur les options
en question.
     </para></listitem>
</varlistentry>

<varlistentry><term>Cache</term>
<listitem><para>La sous-section <literal>Cache</literal> contr�le l'outil
&apt-cache;, veuillez consulter sa documentation pour avoir plus d'informations
sur les options en question.
     </para></listitem>
</varlistentry>

<varlistentry><term>CDROM</term>
<listitem><para>La sous-section <literal>CDROM</literal> contr�le l'outil
&apt-cdrom;, veuillez consulter sa documentation pour avoir plus d'informations
sur les options en question.
     </para></listitem>
</varlistentry>
</variablelist>
 </refsect1>

<refsect1><title>Le groupe Acquire</title>
<para>   
Le groupe d'options <literal>Acquire</literal> contr�le le t�l�chargement des paquets et
les gestionnaires d'URI.

   <variablelist>
<varlistentry><term>PDiffs</term>
<listitem><para>Essayer de t�l�charger les fichiers diff�rentiels appel�s
<literal>PDiffs</literal> pour les paquets ou les fichiers sources, plut�t que
de les t�l�charger enti�rement. Par d�faut � �&nbsp;true&nbsp;�.
     </para></listitem>
</varlistentry>

<varlistentry><term>Queue-Mode</term>
<listitem><para>
Le mode de file d'attente&nbsp;; <literal>Queue-Mode</literal> peut prendre les
valeurs <literal>host</literal> ou <literal>access</literal> et cela d�termine
comment APT parall�lise les connexions sortantes. <literal>Host</literal> signifie
qu'une connexion par cible sera initi�e, tandis que <literal>access</literal> signifie
qu'une connexion par type d'URI sera initi�e.
     </para></listitem>
</varlistentry>

<varlistentry><term>Retries</term>
<listitem><para>
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�.
     </para></listitem>
</varlistentry>

<varlistentry><term>Source-Symlinks</term>
<listitem><para>
Utilise des liens symboliques pour les archives de sources. Positionn�e � 
�&nbsp;true&nbsp;�,  cette option cr�e si possible des liens symboliques vers 
les archives de sources au lieu de les copier. 
Par d�faut � �&nbsp;true&nbsp;�.
     </para></listitem>
</varlistentry>

<varlistentry><term>http</term>
<listitem><para>
URI HTTP&nbsp;; http::Proxy est le mandataire (proxy) HTTP � utiliser par d�faut.
Il se pr�sente sous la forme standard&nbsp;:
<literal>http://[[user][:pass]@]host[:port]/</literal>. On peut sp�cifier un
mandataire particulier par h�te distant en utilisant la syntaxe&nbsp;:
<literal>http::Proxy::&lt;h�te&gt;</literal>. Le mot-cl� sp�cial
<literal>DIRECT</literal> indique alors de n'utiliser aucun mandataire pour
l'h�te.
Lorsqu'elle est d�finie, la variable d'environnement <envar>http_proxy</envar>
annule et remplace toutes les options de mandataire HTTP.
     </para>
<para>
Trois options de configuration sont fournies pour le contr�le des caches compatibles
avec HTTP/1.1. <literal>No-Cache</literal> signifie que le mandataire ne doit jamais
utiliser les r�ponses qu'il a stock�es&nbsp;; <literal>Max-Age</literal>
sert uniquement pour les fichiers d'index&nbsp;: 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'index de mani�re quotidienne&nbsp;; la
valeur par d�faut est donc de 1 jour. <literal>No-Store</literal> sert uniquement
pour les fichiers d'archive&nbsp; 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&nbsp;: Squid 2.0.2 ne prend en compte aucune de 
ces options.
     </para>
<para>
L'option <literal>timeout</literal> positionne le compteur de temps mort (timeout)
utilis� par la m�thode. Cela vaut pour tout, connexion et donn�es.
     </para>
<para>
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). <literal>Acquire::http::Pipeline-Depth </literal> a une valeur
comprise entre 0 et 5&nbsp;: 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.
     </para></listitem>
</varlistentry>

<varlistentry><term>https</term>
<listitem><para>
URI HTTPS. Les options de contr�le de cache et de mandataire (proxy) sont les
m�mes que pour la m�thode <literal>http</literal>. L'option
<literal>Pipeline-Depth</literal> n'est pas encore support�e.
     </para>

<para>La sous-option <literal>CaInfo</literal> sp�cifie le fichier contenant
les informations sur les certificats de confiance.
La sous-option bool�enne <literal>Verify-Peer</literal> pr�cise si le
certificat d'h�te du serveur doit �tre confront� aux certificats de confiance
ou pas. La sous-option bool�enne <literal>Verify-Host</literal> pr�cise s'il
faut v�rifier ou pas le nom d'h�te du serveur. <literal>SslCert</literal>
d�termine le certificat � utiliser pour l'authentification du client.
<literal>SslKey</literal> d�termine quelle clef priv�e doit �tre utilis�e pour
l'authentification du client. <literal>SslForceVersion</literal> surcharge la
valeur par d�faut pour la version de SSL � utiliser et peut contenir l'une des
cha�nes 'TLSv1' ou 'SSLv3'.
     </para>
<para>Chacune de ces options peut �tre sp�cifi�e pour un h�te particulier en
utilisant <literal>&lt;h�te&gt;::CaInfo</literal>,
<literal>&lt;h�te&gt;::Verify-Peer</literal>,
<literal>&lt;h�te&gt;::Verify-Host</literal>,
<literal>&lt;h�te&gt;::SslCert</literal>,
<literal>&lt;h�te&gt;::SslKey</literal> et
<literal>&lt;h�te&gt;::SslForceVersion</literal> respectivement.
     </para></listitem>
</varlistentry>

<varlistentry><term>ftp</term>
<listitem><para>
URI FTP&nbsp;; ftp::Proxy est le mandataire (proxy) FTP � utiliser par d�faut.
Il se pr�sente sous la forme standard&nbsp;: 
<literal>ftp://[[user][:pass]@]host[:port]/</literal>. On peut sp�cifier un
mandataire particulier par h�te distant en utilisant la syntaxe&nbsp;:
<literal>ftp::Proxy::&lt;h�te&gt;</literal>. Le mot-cl� sp�cial
<literal>DIRECT</literal> indique alors de n'utiliser aucun mandataire pour
l'h�te. Lorsqu'elle est d�finie, la variable d'environnement
<envar>ftp_proxy</envar> annule et replace toutes les options de mandataire
FTP. Pour utiliser un mandataire FTP, vous devrez renseigner l'entr�e
<literal>ftp::ProxyLogin</literal> 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 &configureindex; pour savoir comment faire. Les
variables de substitution disponibles sont&nbsp;:
<literal>$(PROXY_USER)</literal>, <literal>$(PROXY_PASS)</literal>,
<literal>$(SITE_USER)</literal>, <literal>$(SITE_PASS)</literal>,
<literal>$(SITE)</literal> et <literal>$(SITE_PORT)</literal>. Chacune
correspond � l'�l�ment respectif de l'URI.
     </para>
<para>
L'option <literal>timeout</literal> positionne le compteur de temps mort
(timeout) utilis� par la m�thode. Cela vaut pour tout, connexion et donn�es.
     </para>
<para>
Plusieurs options de configuration sont fournies pour contr�ler le mode 
passif. Il est g�n�ralement plus s�r d'activer 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 
�&nbsp;port&nbsp;� 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).
     </para>
<para>
Il est possible de faire transiter le trafic FTP par un mandataire HTTP en
positionnant la variable d'environnement <envar>ftp_proxy</envar> � 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'est de toute fa�on pas recommand�
d'utiliser FTP au travers de HTTP en raison la faible efficacit� de cette
m�thode.
     </para>
<para>
L'option <literal>ForceExtended</literal> contr�le l'utilisation des commandes li�es 
� la RFC 2428, <literal>EPSV</literal> et <literal>EPRT</literal>. Par d�faut, elle vaut 
�&nbsp;false&nbsp;� ce qui signifie que ces commandes ne sont 
utilis�es que pour une connexion de type IPv6. Quand elle vaut 
�&nbsp;true&nbsp;�, on les utilise m�me si la connexion est de type IPv4. La 
plupart des serveurs FTP ne suivent pas la RFC 2428.
     </para></listitem>
</varlistentry>

<varlistentry><term>cdrom</term>
<listitem><para>
URI c�d�rom&nbsp;; la seule option de configuration pour les URI de c�d�rom
est le point de montage&nbsp;: <literal>cdrom::Mount</literal>&nbsp;; il doit 
repr�senter le point de montage du lecteur de c�d�rom indiqu� dans 
<filename>/etc/fstab</filename>. 
On peut fournir d'autres commandes de montage et de d�montage quand le
point de montage ne peut �tre list� dans le fichier <filename>/etc/fstab</filename>
(par exemple, un montage SMB). Syntaxiquement, il faut placer
<literallayout>"/cdrom/"::Mount "foo";</literallayout> dans le bloc cdrom.
La barre oblique finale est importante. Les commandes de d�montage
peuvent �tre sp�cifi�es en utilisant <literal>UMount</literal>.
     </para></listitem>
</varlistentry>

     <varlistentry><term>gpgv</term>
     <listitem><para>
URI GPGV&nbsp;; la seule option pour les URI GPGV est celle qui permet de
     passer des param�tres � gpgv.
     <literal>gpgv::Options</literal>&nbsp;: options suppl�mentaires pass�es �
     gpgv.
</para>
	  </listitem>
	</varlistentry>
</variablelist>
 </para>
</refsect1>

<refsect1><title>Les r�pertoires</title>
<para>   
Les r�pertoires de la section <literal>Dir::State</literal> concernent le syst�me
local. <literal>lists</literal> est le r�pertoire o� placer les listes de paquets
t�l�charg�s et <literal>status</literal> est le nom du fichier d'�tat de
&dpkg;.
<literal>preferences</literal> concerne APT&nbsp;: c'est le nom du fichier des 
pr�f�rences.
<literal>Dir::State</literal> contient le r�pertoire par d�faut pr�fix� � tous les
sous-�l�ments, quand ceux-ci ne commencent pas par <filename>/</filename> 
ou <filename>./</filename>.
   </para>
<para>
<literal>Dir::Cache</literal> contient les emplacements qui renseignent sur le
cache local&nbsp;: par exemple, les deux caches de paquets 
<literal>srcpkgcache</literal> et <literal>pkgcache</literal>, et aussi l'endroit o� sont 
plac�es les archives t�l�charg�es, <literal>Dir::Cache::archives</literal>. On peut 
emp�cher la cr�ation des caches en saisissant un nom vide. Cela ralentit 
le d�marrage mais sauve de l'espace disque. Il vaut mieux se passer du 
cache <literal>pkgcache</literal> plut�t que se passer du cache <literal>srcpkgcache</literal>. 
Comme pour <literal>Dir::State</literal>, le r�pertoire par d�faut est contenu dans
<literal>Dir::Cache</literal>.
   </para>
<para>
<literal>Dir::Etc</literal> contient l'emplacement des fichiers de configuration,
<literal>sourcelist</literal> indique l'emplacement de la liste de sources et 
<literal>main</literal> 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 <envar>APT_CONFIG</envar>). 
   </para>
<para>
<literal>Dir::Parts</literal> lit, par ordre d'entr�e, tous les fragments de 
configuration dans le r�pertoire indiqu�. Ensuite, le fichier principal
de configuration est charg�.
   </para>
<para>
Les programmes binaires sont point�s par <literal>Dir::Bin</literal>.
L'emplacement des gestionnaires de m�thodes est indiqu� par
<literal>Dir::Bin::Methods</literal>&nbsp;; <literal>gzip</literal>, 
<literal>dpkg</literal>, <literal>apt-get</literal>,
<literal>dpkg-source</literal>, <literal>dpkg-buildpackage</literal> 
et <literal>apt-cache</literal>
indiquent l'emplacement des programmes correspondants.
   </para>
<para>
L'option de configuration <literal>RootDir</literal> a une signification
particuli�re. Lorsqu'elle est d�finie, tous les chemins d�clar�s dans
<literal>Dir::</literal> sont consid�r�s relativement �
<literal>RootDir</literal>, <emphasis>m�me les chemins sp�cifi�s de mani�re
absolue</emphasis>. Ainsi par exemple si <literal>RootDir</literal> est
d�fini comme <filename>/tmp/staging</filename>, et que chemin du fichier d'�tat
<literal>Dir::State::status</literal> est d�clar� comme
<filename>/var/lib/dpkg/status</filename> alors ce fichier sera cherch�
dans <filename>/tmp/staging/var/lib/dpkg/status</filename>.
   </para>
</refsect1>

<refsect1><title>APT et DSelect</title>
<para>   
Quand APT est utilis� comme une m�thode de &dselect;, plusieurs directives 
contr�lent le comportement par d�faut. On les trouve dans la section
<literal>DSelect</literal>.
   </para>

   <variablelist>
<varlistentry><term>Clean</term>
<listitem><para>
Mode de nettoyage du cache&nbsp;; cette variable peut prendre l'une des valeurs
suivantes&nbsp;: �&nbsp;always&nbsp;�, �&nbsp;prompt&nbsp;�, 
�&nbsp;auto&nbsp;�, �&nbsp;pre-auto&nbsp;� et �&nbsp;never&nbsp;�. 
�&nbsp;always&nbsp;� et �&nbsp;prompt&nbsp;� suppriment tous les paquets du 
cache apr�s la mise � niveau&nbsp;; �&nbsp;prompt&nbsp;� (valeur par d�faut) 
les supprime apr�s une demande et �&nbsp;auto&nbsp;� ne supprime que les 
archives qui ne peuvent plus �tre t�l�charg�es (remplac�es, par exemple, par 
une nouvelle version). �&nbsp;pre-auto&nbsp;� les supprime avant de r�cup�rer 
de nouveaux paquets.
     </para></listitem>
</varlistentry>

<varlistentry><term>Options</term>
<listitem><para>
Le contenu de cette variable est pass� comme options de ligne de commande �
&apt-get; lors de la phase d'installation.
     </para></listitem>
</varlistentry>
<varlistentry><term>UpdateOptions</term>
<listitem><para>
Le contenu de cette variable est pass� comme options de ligne de commande �
&apt-get; lors de la phase de mise � jour.
     </para></listitem>
</varlistentry>

<varlistentry><term>PromptAfterUpdate</term>
<listitem><para>
Si cette option est �&nbsp;vraie&nbsp;�, l'op�ration [U]pdate de &dselect; 
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.
     </para></listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1><title>Comment APT appelle &dpkg;</title>
<para>   
Plusieurs directives de configuration contr�lent la mani�re dont APT
invoque &dpkg;&nbsp;: elles figurent dans la section <literal>DPkg</literal>.
</para>
   <variablelist>
<varlistentry><term>Options</term>
<listitem><para>
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 la liste est
pass� comme un seul argument � &dpkg;.
     </para></listitem>
</varlistentry>
<varlistentry><term>Pre-Invoke</term><term>Post-Invoke</term>
<listitem><para>
Il s'agit d'une liste de commandes shell � ex�cuter avant ou apr�s l'appel de
&dpkg;. Tout comme pour <literal>Options</literal>, on doit utiliser la notation de
liste. Les commandes sont appel�es dans l'ordre, en utilisant 
<filename>/bin/sh</filename>&nbsp;: APT s'arr�te d�s que l'une d'elles �choue.
     </para></listitem>
</varlistentry>
<varlistentry><term>Pre-Install-Pkgs</term>
<listitem><para>
Il s'agit d'une liste de commandes shell � ex�cuter avant d'appeler &dpkg;. 
Tout comme pour <literal>Options</literal>, on doit utiliser la notation de liste.
Les commandes sont appel�es dans l'ordre, en utilisant 
<filename>/bin/sh</filename>&nbsp;: 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.
     </para>
<para>
La deuxi�me version de ce protocole donne plus de renseignements&nbsp;: 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
<literal>DPkg::Tools::Options::cmd::Version</literal> � 2. <literal>cmd</literal> est une 
commande pass�e � <literal>Pre-Install-Pkgs</literal>.
     </para></listitem>
</varlistentry>
<varlistentry><term>Run-Directory</term>
<listitem><para>
APT se place dans ce r�pertoire avant d'appeler &dpkg;&nbsp;; par d�faut c'est 
le r�pertoire <filename>/</filename>.
     </para></listitem>
</varlistentry>
<varlistentry><term>Build-Options</term>
<listitem><para>
Ces options sont pass�es � &dpkg-buildpackage; lors de la compilation des
paquets&nbsp;; par d�faut la signature est d�sactiv�e et tous les binaires sont
cr��s.
     </para></listitem>
</varlistentry>
</variablelist>
 </refsect1>

<refsect1>
<title>Options �&nbsp;Periodic&nbsp;� et �&nbsp;Archive&nbsp;�</title>
<para>
Les groupes d'options <literal>APT::Periodic</literal> et
<literal>APT::Archive</literal> configurent les comportements p�riodiques
r�alis�s par le script <literal>/etc/cron.daily/apt</literal>, lanc�
quotidiennement.
   </para>
<variablelist>
<varlistentry><term>APT::Periodic</term>
<para>Les options de cette section permettent de configurer la fr�quence
d'ex�cution des t�ches APT lanc�es automatiquement. Ces param�tre prennent
comme valeurs des p�riodicit�s d'ex�cution en nombre de jours.
   </para>
<listitem><para>
<literal>Update-Package-List</literal>&nbsp;: p�riodicit� de mise � jour de la
liste des paquets disponibles. (0 = d�sactiv�)
     </para></listitem>
<listitem><para>
<literal>Download-Upgradable-Packages</literal>&nbsp;: p�riodicit� de
t�l�chargement dans le cache des paquets pour lesquels une mise � jour est
disponible. (0 = d�sactiv�)
     </para></listitem>
<listitem><para>
<literal>AutocleanInterval</literal>&nbsp;: p�riodicit� des
�&nbsp;autoclean&nbsp;�, c'est � dire de la suppression du cache des paquets
qui ne peuvent plus �tre t�l�charg�s. (0 = d�sactiv�)
     </para></listitem>
<listitem><para>
<literal>Unattended-Upgrade</literal>&nbsp;: p�riodicit� de mise � jour
automatique du syst�me sans intervention humaine. Le paquet
<literal>unattended-upgrades</literal> doit �tre install� pour que cette t�che
s'ex�cute. Le cas �ch�ant un fichier journal est �crit dans
<literal>/var/log/unattended-upgrades</literal>. (0 = d�sactiv�)
     </para></listitem>
</varlistentry>
<varlistentry><term>APT::Archive</term>
<para>Les options de la section APT::Archive permettent de contr�ler la taille
du cache de paquets.
   </para>
<listitem><para>
<literal>MaxAge</literal>&nbsp;: anciennet� maximale d'un paquet dans le cache,
en nombre de jours. Les paquets plus anciens sont supprim�s. (0 = d�sactiv�)
     </para></listitem>
<listitem><para>
<literal>MaxSize</literal>&nbsp;: taille maximale du cache en Mo. (0 =
d�sactive) Si ce maximum est d�pass�, des paquets sont supprim�s jusqu'� ce
que la taille du cache repasse sous la limite. Les paquets les plus volumineux
sont supprim�s en premier.
     </para></listitem>
<listitem><para>
<literal>MinAge</literal>&nbsp;: age minimum d'un paquet du cache, en nombre de
jours (0 = d�sactiv�). Un paquet plus r�cent ne sera pas supprim�. Cette option
est utile pour garder � disposition une version des paquets en cas de probl�me
grave.
     </para></listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1><title>Les options de d�bogage</title>
<para>
Les options de la section <literal>Debug::</literal> servent soit � provoquer
l'affichage d'informations de d�bogage sur la sortie d'erreur 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 <literal>APT</literal>. La plupart de ces options n'ont pas
d'int�r�t pour un utilisateur normal, mais certaines peuvent tout de m�me �tre
utiles&nbsp;:
   </para>
<itemizedlist>
<listitem><para>
<literal>Debug::pkgProblemResolver</literal> affiche d'int�ressantes
informations sur les d�cisions prises par les commandes <literal>dist-upgrade,
upgrade, install, remove et purge</literal>.
     </para></listitem>
<listitem><para>
<literal>Debug::NoLocking</literal> d�sactive le verrouillage de fichier de
mani�re � ce que APT puisse effectuer quelques op�rations (telles que
<literal>apt-get -s install</literal>) sans �tre �&nbsp;root&nbsp;�.
     </para></listitem>
<listitem><para>
<literal>Debug::pkgDPkgPM</literal> affiche la ligne de commande � chaque appel
de &dpkg;.
     </para></listitem>
<listitem><para>
<literal>Debug::IdentCdrom</literal> d�sactive l'inclusion de donn�es de type
statfs dans les ID de c�d�rom.
     </para></listitem>
</itemizedlist>

<para>Voici une liste compl�te des options de d�bogage de APT.</para>
<variablelist>
<varlistentry><term>Debug::Acquire::cdrom</term>
<listitem><para>
Affiche les informations concernant les sources de type cdrom://
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::Acquire::ftp</term>
<listitem><para>
Affiche les informations concernant le t�l�chargement de paquets par FTP.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::Acquire::http</term>
<listitem><para>
Affiche les informations concernant le t�l�chargement de paquets par HTTP.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::Acquire::https</term>
<listitem><para>
Affiche les informations concernant le t�l�chargement de paquets par HTTPS.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::Acquire::gpgv</term>
<listitem><para>
Affiche les informations relatives � la v�rification de signatures
cryptographiques avec <literal>gpg</literal>.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::aptcdrom</term>
<listitem><para>
Affiche des informations concernant l'acc�s aux collections de paquets
stock�es sur c�d�rom.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::BuildDeps</term>
<listitem><para>
D�crit le processus de r�solution des d�pendances pour la construction de
paquets source (&nbsp;�&nbsp;build-dependencies&nbsp;�&nbsp;) par &apt-get;.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::Hashes</term>
<listitem><para>
Affiche toutes les clefs de hachage cryptographiques g�n�r�es par les
librairies APT.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::IdentCdrom</term>
<listitem><para>D�sactive l'inclusion des donn�es de type
<literal>statfs</literal> pour la g�n�ration des ID de c�d�rom, � savoir le
nombre de blocs libres et utilis�s sur le syst�me de fichier du c�d�rom.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::NoLocking</term>
<listitem><para>
D�sactive le verrouillage de fichiers. Cela permet par exemple de lancer deux
instances de �&nbsp;apt-get update&nbsp;� en m�me temps.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgAcquire</term>
<listitem><para>
Trace les ajouts et suppressions d'�l�ments de la queue globale de
t�l�chargement.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgAcquire::Auth</term>
<listitem><para>
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.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgAcquire::Diffs</term>
<listitem><para>
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.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgAcquire::RRed</term>
<listitem><para>
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.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgAcquire::Worker</term>
<listitem><para>
Affiche toutes les interactions avec les processus enfants qui se chargent
effectivement des t�l�chargements.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgAcquire::pkgAutoRemove</term>
<listitem><para>
Affiche les changements concernant le marquage des paquets comme install�s
automatiquement, et la suppression des paquets inutiles. 
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgDepCache::AutoInstall</term>
<listitem><para>
G�n�re les informations de d�bogage d�crivant quels paquets sont install�s
automatiquement pour satisfaire les d�pendances. Cela concerne la passe
initiale d'installation automatique effectu�e par exemple par
<literal>apt-get install</literal> et pas le syst�me de r�solution de
d�pendances complet de APT&nbsp;; voir
<literal>Debug::pkgProblemResolver</literal> pour ce dernier.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgInitConfig</term>
<listitem><para>
Au lancement, affiche l'ensemble de la configuration sur la sortie d'erreur
standard.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgDPkgPM</term>
<listitem><para>
Affiche la commande exacte d'invocation de &dpkg; � chaque appel&nbsp;; les
arguments sont s�par�s par des espaces.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgDPkgProgressReporting</term>
<listitem><para> Affiche l'ensemble des informations re�ues de &dpkg; par
l'interm�diaire du descripteur de fichier d'�tat, et les �ventuelles erreurs
d'analyse de ce fichier.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgOrderList</term>
<listitem><para>
Affiche les �tapes de l'algorithme utilis� pour choisir l'ordre dans lequel APT
passe les paquets � &dpkg;.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgPackageManager</term>
<listitem><para>
Affiche le d�tail des op�rations li�es � l'invocation de &dpkg;. 
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgPolicy</term>
<listitem><para>
Au lancement, affiche la priorit� de chaque liste de paquets.
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::pkgProblemResolver</term>
<listitem><para>
Affiche la trace d'ex�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).
     </para></listitem>
</varlistentry>
<varlistentry><term>Debug::sourceList</term>
<listitem><para>
Affiche les fournisseurs d�clar�s dans le fichier
<filename>/etc/apt/vendors.list</filename>.
     </para></listitem>
</varlistentry>
<!-- 2009/07/11 Utilis� nulle part actuellement, le code est comment�.
<varlistentry><term>Debug::Vendor</term>
<listitem><para>
Affiche les informations sur la recherche de fournisseurs.
     </para></listitem>
</varlistentry>
-->
</variablelist>

</refsect1>

<refsect1><title>Exemples</title>
<para>
Le fichier &configureindex; contient un mod�le de fichier montrant des exemples
pour toutes les options existantes.
 </para>
</refsect1>

<refsect1><title>Fichiers</title>
<para>   <filename>/etc/apt/apt.conf</filename>
 </para>
</refsect1>
<refsect1><title>Voir aussi</title>
<para>
&apt-cache;, &apt-config;<!-- ? reading apt.conf -->, &apt-preferences;.</para>
</refsect1>

&manbugs;
&deux-traducteurs;
</refentry>