doc/fr/apt_preferences.fr.5.sgml

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