doc/fr/apt_preferences.5

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