doc/fr/apt_preferences.fr.5.sgml

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