]> git.saurik.com Git - apt.git/blob - doc/fr/apt_preferences.fr.5.xml
* removed the pragma mess
[apt.git] / doc / fr / apt_preferences.fr.5.xml
1 <?xml version="1.0" encoding="iso-8859-15" standalone="no"?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4
5 <!ENTITY % aptent SYSTEM "apt.ent.fr">
6 %aptent;
7
8 ]>
9
10 <refentry lang="fr">
11
12 <refentryinfo>
13 &apt-author.team;
14 &apt-email;
15 &apt-product;
16 <!-- The last update date -->
17 <date>29 Février 2004</date>
18 </refentryinfo>
19
20 <refmeta>
21 <refentrytitle>apt_preferences</refentrytitle>
22 <manvolnum>5</manvolnum>
23 </refmeta>
24
25 <refnamediv>
26 <refname>apt_preferences</refname>
27 <refpurpose>Un fichier de contrôle des préférences pour APT</refpurpose>
28 </refnamediv>
29
30 <refsect1><title>Description</title>
31 <para>
32 Le fichier d'APT, <filename>/etc/apt/preferences</filename>, peut être utilisé pour
33 choisir la version des paquets que l'on veut installer.</para>
34 <para>
35 Quand le fichier &sources-list; contient des références à plusieurs
36 distributions (par exemple, <literal>stable</literal> et
37 <literal>testing</literal>), plusieurs versions d'un paquet peuvent être
38 installées. APT affecte une priorité à chaque version disponible. La commande
39 <command>apt-get</command>, tenant compte des contraintes de
40 dépendance, installe la version qui possède la priorité la plus haute.
41 Le fichier des préférences annule les priorités assignées par défaut
42 aux versions des paquets&nbsp;: ainsi l'utilisateur peut choisir la version
43 qu'il veut installer.
44 </para>
45 <para>
46 Si le fichier &sources-list; contient, pour une même distribution,
47 des références à plusieurs sites de téléchargement, il peut exister plusieurs
48 exemplaires de la même version d'un paquet. Dans ce cas,
49 <command>apt-get</command> télécharge l'exemplaire qui apparaît en premier
50 dans le fichier &sources-list;. Le fichier des préférences n'influe pas sur
51 le choix des exemplaires, seulement sur le choix de la version.
52 </para>
53
54 <refsect2><title>Les priorités affectées par défaut</title>
55 <para>
56 Quand le fichier des préférences n'existe pas, ou quand aucune entrée
57 de ce fichier ne s'applique à une version précise, la priorité affectée à
58 cette version est la priorité de la distribution à laquelle elle appartient.
59 On peut distinguer une distribution et lui donner une priorité plus haute
60 que celle des autres distributions&nbsp;: on l'appelle la distribution par
61 défaut ou «&nbsp;target release&nbsp;» et elle peut être définie sur la ligne
62 de commande de <command>apt-get</command> ou dans le fichier de configuration
63 d'APT, <filename>/etc/apt/apt.conf</filename>.
64 Par exemple&nbsp;:
65
66 <programlisting>
67 <command>apt-get install -t testing <replaceable>paquet</replaceable></command>
68 </programlisting>
69
70 <programlisting>
71 APT::Default-Release "stable";
72 </programlisting>
73 </para>
74 <para>
75 Quand une distribution par défaut a été indiquée, APT utilise
76 l'algorithme suivant pour déterminer la priorité des versions d'un
77 paquet&nbsp;:
78
79 <variablelist>
80 <varlistentry><term>une priorité égale à 100</term>
81 <listitem><simpara>est affectée à la version déjà installée (si elle existe).</simpara></listitem>
82 </varlistentry>
83
84 <varlistentry><term>une priorité égale à 500</term>
85 <listitem><simpara>est affectée aux versions qui ne sont pas installées et
86 qui n'appartiennent pas à la distribution par défaut.</simpara></listitem>
87 </varlistentry>
88
89 <varlistentry><term>une priorité égale à 990</term>
90 <listitem><simpara>est affectée aux versions qui ne sont pas installées et
91 qui appartiennent à la distribution par défaut.</simpara></listitem>
92 </varlistentry>
93 </variablelist>
94 </para>
95 <para>
96 Quand aucune distribution par défaut n'a été indiquée, APT affecte
97 simplement une priorité égale à 100 à toute version installée d'un paquet
98 et une priorité égale à 500 à tout version non installée.
99 </para>
100 <para>
101 Puis APT applique les règles suivantes pour déterminer la version
102 du paquet qu'il faut installer (elles sont listées par ordre de priorité)&nbsp;:
103
104 <itemizedlist>
105 <listitem><simpara>
106 Ne jamais revenir en arrière, sauf si la priorité d'une
107 version disponible dépasse 1000. «&nbsp;Revenir en arrière&nbsp;» signifie
108 installer une version moins récente que la version installée. Il
109 faut noter qu'aucune des priorités par défaut n'excède 1000&nbsp;; de telles
110 valeurs ne peuvent être définies que dans le fichier des préférences. Notez
111 aussi qu'il est risqué de revenir en arrière.
112 </simpara></listitem>
113 <listitem><simpara>
114 Installer la version qui possède la priorité la plus
115 haute.
116 </simpara></listitem>
117 <listitem><simpara>
118 Quand deux (ou plus) versions ont la même priorité,
119 installer la version la plus récente (c.-à-d. celle dont le numéro de
120 version est le plus grand).
121 </simpara></listitem>
122 <listitem><simpara>
123 Quand deux (ou plus) versions ont la même priorité et le
124 même numéro de version, mais soit les paquets diffèrent par certaines
125 métadonnées, soit l'option <literal>--reinstall</literal> a été donnée, installer la
126 version qui n'est pas installée.
127 </simpara></listitem>
128 </itemizedlist>
129 </para>
130 <para>
131 En général, la version installée d'un paquet (priorité 100) n'est
132 pas aussi récente que les versions disponibles dans les sources
133 listées dans le fichier &sources-list; (priorité 500 ou 990). Et donc le
134 paquet sera mis à niveau avec la commande&nbsp;:
135 <command>apt-get install <replaceable>paquet</replaceable></command> ou
136 <command>apt-get dist-upgrade</command>.
137 </para>
138 <para>
139 La version installée d'un paquet peut être - rarement -
140 <emphasis>plus</emphasis> récente que tout autre version disponible. Les commandes
141 <command>apt-get install <replaceable>paquet</replaceable></command> ou
142 <command>apt-get upgrade</command> ne provoquent pas de retour en arrière.
143 </para>
144 <para>
145 Parfois, la version installée d'un paquet est plus récente que la
146 version appartenant à la distribution par défaut, mais moins récente que
147 la version appartenant à une autre distribution. Une telle version sera mise
148 à niveau par les commandes
149 <command>apt-get install <replaceable>paquet</replaceable></command> ou
150 <command>apt-get upgrade</command> car au moins <emphasis>l'une</emphasis> des versions
151 disponibles possède une plus haute priorité que celle de la version installée.
152 </para>
153 </refsect2>
154
155 <refsect2><title>Conséquences des préférences</title>
156 <para>
157 Le fichier des préférences permet à l'administrateur système de
158 contrôler l'affectation des priorités. Ce fichier est constitué d'une ou
159 plusieurs entrées séparées par des lignes blanches. Ces entrées peuvent avoir
160 deux formes, une forme particulière et une forme générale.
161 <itemizedlist>
162 <listitem><simpara>
163 La forme particulière affecte une priorité
164 (<emphasis>Pin-Priority</emphasis>) à un paquet précis, à une version précise
165 ou à un intervalle spécifiant plusieurs versions. Par exemple, l'entrée
166 suivante affecte une priorité haute à toutes les versions du paquet
167 <filename>perl</filename> dont le numéro de version commence par <literal>5.8</literal>.
168 </simpara>
169
170 <programlisting>
171 Package: perl
172 Pin: version 5.8*
173 Pin-Priority: 1001
174 </programlisting>
175 </listitem>
176
177 <listitem><simpara>
178 La forme générale affecte une priorité à toutes les versions d'un paquet dans
179 une distribution donnée (c'est-à-dire, à toutes les versions d'un paquet qui
180 sont listées dans un fichier <filename>Release</filename>), ou à toutes les versions
181 d'un paquet provenant d'un site internet identifié par un nom complètement
182 qualifié.
183 </simpara>
184 <simpara>
185 Cette forme générale des entrées du fichier des préférences
186 s'applique seulement aux groupes de paquets. Par exemple, l'entrée suivante
187 affecte une priorité haute à toutes les versions disponibles dans le
188 site local.
189 </simpara>
190
191 <programlisting>
192 Package: *
193 Pin: origin ""
194 Pin-Priority: 999
195 </programlisting>
196
197 <simpara>Attention ! le mot-clé utilisé ici, <literal>origin</literal>, ne doit pas
198 être confondu avec l'Origine d'une distribution indiquée dans
199 un fichier <filename>Release</filename>. Ce qui suit l'étiquette «&nbsp;Origin:&nbsp;»
200 dans un fichier <filename>Release</filename> n'est pas une adresse internet
201 mais le nom d'un auteur ou d'un distributeur, comme Debian ou Ximian.
202 </simpara>
203 <simpara>L'entrée suivante affecte une priorité basse à toutes les versions
204 d'un paquet appartenant à toute distribution dont le nom
205 d'«&nbsp;Archive&nbsp;» est <literal>unstable</literal>.
206 </simpara>
207
208 <programlisting>
209 Package: *
210 Pin: release a=unstable
211 Pin-Priority: 500
212 </programlisting>
213
214 <simpara>L'entrée suivante affecte une priorité haute à toutes les versions
215 d'un paquet appartenant à toute distribution dont le nom
216 d'«&nbsp;Archive&nbsp;» est <literal>stable</literal> et dont le numéro
217 de «&nbsp;Version&nbsp;» est <literal>3.0</literal>.
218 </simpara>
219
220 <programlisting>
221 Package: *
222 Pin: release a=stable, v=3.0
223 Pin-Priority: 500
224 </programlisting>
225 </listitem>
226 </itemizedlist>
227 </para>
228
229 </refsect2>
230
231 <refsect2><title>Comment APT interprète-t-il les priorités&nbsp;?</title>
232 <para>
233 Les priorités (P) indiquées dans le fichier des préférences doivent
234 être des entiers positifs ou négatifs. Ils sont interprétés à peu près
235 comme suit&nbsp;:
236
237 <variablelist>
238 <varlistentry><term>P &gt; 1000</term>
239 <listitem><simpara>
240 Cette priorité entraîne l'installation du paquet même s'il
241 s'agit d'un retour en arrière.
242 </simpara></listitem>
243 </varlistentry>
244
245 <varlistentry><term>990 &lt; P &lt;=1000</term>
246 <listitem><simpara>
247 La version sera installée, même si elle n'appartient pas à
248 la distribution par défaut&nbsp;; mais elle ne sera pas installée si la
249 version installée est plus récente.
250 </simpara></listitem>
251 </varlistentry>
252
253 <varlistentry><term>500 &lt; P &lt;=990</term>
254 <listitem><simpara>
255 La version sera installée, sauf s'il existe une version
256 appartenant à la distribution par défaut ou si la version installée est plus
257 récente.
258 </simpara></listitem>
259 </varlistentry>
260
261 <varlistentry><term>100 &lt; P &lt;=500</term>
262 <listitem><simpara>
263 La version sera installée, sauf s'il existe une version
264 appartenant à une autre distribution ou si la version installée est plus
265 récente.
266 </simpara></listitem>
267 </varlistentry>
268
269 <varlistentry><term>0 &lt; P &lt;=100</term>
270 <listitem><simpara>
271 La version sera installée si aucune version du paquet
272 n'est installée.
273 </simpara></listitem>
274 </varlistentry>
275
276 <varlistentry><term>P &lt; 0</term>
277 <listitem><simpara>
278 Cette priorité empêche l'installation de la version.
279 </simpara></listitem>
280 </varlistentry>
281 </variablelist>
282 </para>
283 <para>
284 Si l'une des entrées de forme particulière correspond à la version
285 disponible d'un paquet, la première entrée trouvée détermine la priorité de
286 cette version. S'il n'en existe pas, et si l'une des entrées de forme générale
287 correspond à la version disponible d'un paquet, la première entrée trouvée
288 détermine la priorité.
289 </para>
290 <para>
291 Supposons par exemple que le fichier des préférences contienne les trois
292 entrées décrites ci-dessous&nbsp;:
293 </para>
294
295 <programlisting>
296 Package: perl
297 Pin: version 5.8*
298 Pin-Priority: 1001
299
300 Package: *
301 Pin: origin ""
302 Pin-Priority: 999
303
304 Package: *
305 Pin: release unstable
306 Pin-Priority: 50
307 </programlisting>
308
309 <para>
310 Alors&nbsp;:
311
312 <itemizedlist>
313 <listitem><simpara>
314 La version la plus récente du paquet <literal>perl</literal> sera
315 installé pour autant que son numéro de version commence par <literal>5.8</literal>.
316 Si l'<emphasis>une</emphasis> des versions 5.8* existe et si la version installée est
317 une version 5.9*, il y aura un retour en arrière.
318 </simpara></listitem>
319 <listitem><simpara>
320 Les versions des paquets (autres que <literal>perl</literal>)
321 disponibles dans le site local ont priorité sur les autres versions,
322 même celles appartenant à la distribution par défaut.
323 </simpara></listitem>
324 <listitem><simpara>
325 La version d'un paquet dont l'origine n'est pas le site
326 local mais un site internet listé dans &sources-list; et qui appartient à une
327 distribution <literal>unstable</literal>, ne sera installée que si aucune version
328 du paquet n'est déjà installée.
329 </simpara></listitem>
330 </itemizedlist>
331 </para>
332 </refsect2>
333
334 <refsect2><title>Détermination de la version des paquets et des propriétés des
335 distributions</title>
336 <para>
337 Chaque source listée dans le fichier &sources-list; doit fournir
338 les fichiers <filename>Packages</filename> et <filename>Release</filename>
339 qui décrivent les paquets disponibles à cet endroit.
340 </para>
341 <para>Le fichier <filename>Packages</filename> se trouve normalement dans le
342 répertoire
343 <filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>, par exemple,
344 <filename>.../dists/stable/main/binary-i386/Packages</filename>. Il consiste
345 en entrées composées de lignes, une pour chaque paquet disponible dans le
346 répertoire. Seules deux lignes des entrées sont pertinentes pour la
347 détermination des priorités&nbsp;:
348 <variablelist>
349 <varlistentry>
350 <term>La ligne <literal>Package:</literal> </term>
351 <listitem><simpara>
352 donne le nom du paquet
353 </simpara></listitem>
354 </varlistentry>
355 <varlistentry>
356 <term>La ligne <literal>Version:</literal> </term>
357 <listitem><simpara>
358 donne le numéro de version du paquet
359 </simpara></listitem>
360 </varlistentry>
361 </variablelist>
362 </para>
363 <para>
364 Le fichier <filename>Release</filename> se trouve normalement dans le
365 répertoire
366 <filename>.../dists/<replaceable>dist-name</replaceable></filename>, par exemple, <filename>.../dists/stable/Release</filename>, ou <filename>.../dists/woody/Release</filename>.
367 Il consiste en une seule entrée composée de plusieurs lignes qui s'applique à
368 <emphasis>tous</emphasis> les paquets situés dans les répertoires sous
369 le répertoire parent. Contrairement au fichier <filename>Packages</filename>, presque
370 toutes les lignes du fichier <filename>Release</filename> sont pertinentes pour
371 déterminer les priorités&nbsp;:
372
373 <variablelist>
374 <varlistentry>
375 <term>La ligne <literal>Archive:</literal> </term>
376 <listitem><simpara>
377 nomme l'archive à laquelle appartiennent tous les
378 paquets situés dans les répertoires. Par exemple, la ligne
379 <literal>Archive: stable</literal> indique que tous les paquets dans les répertoires
380 situés sous le répertoire parent du fichier <filename>Release</filename> appartiennent
381 à l'archive <literal>stable</literal>. Indiquer cette valeur dans le fichier des
382 préférences demanderait cette ligne&nbsp;:
383 </simpara>
384 <programlisting>
385 Pin: release a=stable
386 </programlisting>
387 </listitem>
388 </varlistentry>
389
390 <varlistentry>
391 <term>La ligne <literal>Version:</literal> </term>
392 <listitem><simpara>
393 indique la version de la distribution. Par exemple, les
394 paquets dans les répertoires peuvent appartenir à la
395 distribution Debian GNU/Linux version 3.0. Il n'y a pas de numéro de version
396 pour les distributions <literal>testing</literal> et <literal>unstable</literal> car elles
397 n'ont pas encore été publiées. Indiquer cette valeur dans le fichier des préférences demanderait
398 ces lignes&nbsp;:
399 </simpara>
400 <programlisting>
401 Pin: release v=3.0
402 Pin: release a=stable, v=3.0
403 Pin: release 3.0
404 </programlisting>
405 </listitem>
406 </varlistentry>
407
408 <varlistentry>
409 <term>La ligne <literal>Component:</literal></term>
410 <listitem><simpara>
411 nomme un composant qui indique le type de licence associée
412 aux paquets situés dans les répertoires sous le fichier
413 <filename>Release</filename>. Par exemple, la ligne <literal>Component: main</literal> indique
414 que tous les exemplaires dans les répertoires appartiennent au composant
415 <literal>main</literal>, c'est-à-dire que leur licence est en accord avec les
416 Directives Debian pour le logiciel libre. Indiquer ce composant dans le
417 fichier des préférences demanderait cette ligne&nbsp;:
418 </simpara>
419 <programlisting>
420 Pin: release c=main
421 </programlisting>
422 </listitem>
423 </varlistentry>
424
425 <varlistentry>
426 <term>La ligne <literal>Origin:</literal> </term>
427 <listitem><simpara>
428 nomme l'origine des paquets situés
429 dans les répertoires sous le fichier <filename>Release</filename>. En général, c'est
430 <literal>Debian</literal>. Indiquer cette origine dans le fichier des préférences
431 demanderait cette ligne&nbsp;:
432 </simpara>
433 <programlisting>
434 Pin: release o=Debian
435 </programlisting>
436 </listitem>
437 </varlistentry>
438
439 <varlistentry>
440 <term>La ligne <literal>Label:</literal> </term>
441 <listitem><simpara>
442 indique un label pour les paquets qui se trouvent
443 dans les répertoires sous le fichier <filename>Release</filename>. En général, c'est
444 <literal>Debian</literal>. Indiquer cette origine dans le fichier des préférences
445 demanderait cette ligne&nbsp;:
446 </simpara>
447 <programlisting>
448 Pin: release l=Debian
449 </programlisting>
450 </listitem>
451 </varlistentry>
452 </variablelist>
453 </para>
454 <para>Tous les fichiers <filename>Packages</filename> et
455 <filename>Release</filename> récupérés dans des sources listées par le
456 fichier &sources-list; sont conservés dans le répertoire
457 <filename>/var/lib/apt/lists</filename> ou dans le fichier spécifié par la
458 variable <literal>Dir::State::Lists</literal> dans le fichier <filename>apt.conf</filename>.
459 Par exemple, le fichier
460 <filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename>
461 contient le fichier <filename>Release</filename> du site
462 <literal>debian.lcs.mit.edu</literal>, architecture <literal>binary-i386</literal> et
463 composant <literal>contrib</literal> de la distribution <literal>unstable</literal>.
464 </para>
465 </refsect2>
466
467 <refsect2><title>Lignes facultatives dans le fichier des préférences</title>
468 <para>
469 Toute entrée du fichier des préférences peut commencer par une ou
470 plusieurs lignes contenant le mot <literal>Explanation:</literal>. Cela permet des
471 commentaires.
472 </para>
473 <para>La ligne <literal>Pin-Priority:</literal> d'une entrée est facultative. Si elle
474 n'existe pas, APT affecte une priorité inférieure de 1 à la valeur spécifiée
475 sur une ligne commençant par <literal>Pin-Priority: release ...</literal>.
476 </para>
477 </refsect2>
478
479 </refsect1>
480
481 <refsect1><title>Exemples</title>
482 <refsect2><title>Comment suivre Stable&nbsp;?</title>
483 <para>
484 Le fichier des préférences suivant affecte une priorité plus haute que
485 la priorité par défaut (500) à tous les exemplaires appartenant à la
486 distribution <literal>stable</literal> et une priorité prohibitivement basse à tous
487 les exemplaires appartenant à d'autres distributions <literal>Debian</literal>.
488
489 <programlisting>
490 Explanation: Ne pas installer des exemplaires d'origine Debian
491 Explanation: sauf ceux de la distribution stable
492 Package: *
493 Pin: release a=stable
494 Pin-Priority: 900
495
496 Package: *
497 Pin: release o=Debian
498 Pin-Priority: -10
499 </programlisting>
500 </para>
501 <para>
502 Avec le fichier des préférences ci-dessus et un fichier &sources-list;
503 adéquat, les commandes suivantes utiliseront les versions les plus récentes
504 de <literal>stable</literal> pour faire la mise à niveau&nbsp;:
505
506 <programlisting>
507 apt-get install <replaceable>paquet</replaceable>
508 apt-get upgrade
509 apt-get dist-upgrade
510 </programlisting>
511 </para>
512 <para>
513 La commande suivante utilisera la version la plus récente de la
514 distribution <literal>testing</literal> pour mettre à niveau le paquet spécifié&nbsp;;
515 cependant les mises à niveau ultérieures du paquet ne se feront pas
516 à moins de relancer la commande.
517
518 <programlisting>
519 apt-get install <replaceable>paquet</replaceable>/testing
520 </programlisting>
521 </para>
522 </refsect2>
523
524 <refsect2><title>Comment suivre Testing ou Unstable&nbsp;?</title>
525 <para>
526 Le fichier des préférences suivant affecte une priorité haute aux
527 versions des paquets appartenant à la distribution <literal>testing</literal>, une
528 priorité moindre aux versions appartenant à la distribution <literal>unstable</literal>
529 et une priorité prohibitivement basse aux versions appartenant à d'autres
530 distributions <literal>Debian</literal>.
531
532 <programlisting>
533 Package: *
534 Pin: release a=testing
535 Pin-Priority: 900
536
537 Package: *
538 Pin: release a=unstable
539 Pin-Priority: 800
540
541 Package: *
542 Pin: release o=Debian
543 Pin-Priority: -10
544 </programlisting>
545 </para>
546 <para>
547 Avec un fichier &sources-list; approprié et le fichier des préférences
548 ci-dessus, les commandes suivantes
549 utiliseront les versions les plus récentes de <literal>testing</literal> pour faire
550 la mise à niveau&nbsp;:
551
552 <programlisting>
553 apt-get install <replaceable>paquet</replaceable>
554 apt-get upgrade
555 apt-get dist-upgrade
556 </programlisting>
557 </para>
558 <para>
559 La commande suivante utilisera la version la plus récente de la
560 distribution <literal>unstable</literal> pour mettre à niveau le paquet spécifié&nbsp;;
561 Par la suite, <command>apt-get upgrade</command> mettra le paquet à jour
562 avec la plus récente version dans <literal>testing</literal> si elle est plus récente
563 que la version installée ou avec la plus récente version dans
564 <literal>unstable</literal> si elle est plus récente que la version installée.
565
566 <programlisting>
567 apt-get install <replaceable>paquet</replaceable>/unstable
568 </programlisting>
569 </para>
570 </refsect2>
571 </refsect1>
572
573 <refsect1><title>See Also</title>
574 <para>
575 &apt-get; &apt-cache; &apt-conf; &sources-list;
576 </para>
577 </refsect1>
578
579 &manbugs;
580 &traducteur;
581 </refentry>