doc/fr/apt-ftparchive.fr.1.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.jgunthorpe;
  14    &apt-author.team;
  15    &apt-email;
  16    &apt-product;
  17    <!-- The last update date -->
  18    <date>29 Février 2004</date>
  19  </refentryinfo>
  20
  21 <refmeta>
  22 <refentrytitle>apt-ftparchive</refentrytitle>
  23 <manvolnum>1</manvolnum>
  24 </refmeta>
  25
  26 <refnamediv><refname>apt-ftparchive</refname>
  27 <refpurpose>Un outil pour créer des index
  28  </refpurpose>
  29 </refnamediv>
  30
  31 <refsynopsisdiv>
  32 <cmdsynopsis>
  33 <command>apt-ftparchive</command>
  34 <arg><option>-hvdsq</option></arg><arg>
  35 <option>--md5</option></arg><arg>
  36 <option>--delink</option></arg>
  37 <arg><option>--readonly</option></arg>
  38 <arg><option>--contents</option></arg>
  39 <arg><option>-o=<replaceable>option de configuration</replaceable></option></arg>
  40 <arg><option>-c=<replaceable>fichier</replaceable></option></arg>
  41 <group choice="req">
  42 <arg>packages<arg choice="plain" rep="repeat"><replaceable>chemin</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>préfixe-de-chemin</replaceable></arg></arg></arg>
  43 <arg>sources<arg choice="plain" rep="repeat"><replaceable>chemin</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>préfixe-de-chemin</replaceable></arg></arg></arg>
  44 <arg>contents <arg choice="plain"><replaceable>chemin</replaceable></arg></arg>
  45 <arg>release <arg choice="plain"><replaceable>chemin</replaceable></arg></arg>
  46 <arg>generate <arg choice="plain"><replaceable>fichier-de-configuration</replaceable></arg><arg choice="plain" rep="repeat"><replaceable>section</replaceable></arg></arg>
  47 <arg>clean <arg choice="plain"><replaceable>fichier-de-configuration</replaceable></arg></arg>
  48 </group>
  49 </cmdsynopsis>
  50 </refsynopsisdiv>
  51
  52 <refsect1><title>Description</title>
  53 <para>
  54 <command>apt-ftparchive</command> est l'outil en ligne de commande qui crée les index
  55 dont APT se sert pour accéder aux sources des distributions. Un index doit
  56 être créé pour un site et basé sur le contenu de ce site.
  57    </para>
  58 <para><command>apt-ftparchive</command> est un ensemble comprenant le programme
  59 &dpkg-scanpackages; et toutes ses fonctionnalités via la commande
  60 <literal>packages</literal>&nbsp;; il comprend aussi un générateur de fichier
  61 «&nbsp;Contents&nbsp;», la commande <literal>contents</literal>, et une technique
  62 élaborée pour «&nbsp;scripter&nbsp;» le processus de création d'une archive
  63 complète.
  64    </para>
  65 <para>
  66 <command>Apt-ftparchive</command> peut utiliser lui-même des bases de données binaires
  67 pour «&nbsp;cacher&nbsp;» le contenu d'un fichier .deb&nbsp;; il n'a pas
  68 besoin de programmes extérieurs, sauf &gzip;. Lors d'une exécution, il
  69 vérifie les changements dans les fichiers et crée les fichiers compressés
  70 voulus.
  71    </para>
  72 <para>
  73 À moins que l'option <option>-h</option> ou <option>--help</option> ne soit donnée, l'une des
  74 commandes suivantes doit être présente&nbsp;:
  75
  76    <variablelist>
  77 <varlistentry><term>packages</term>
  78 <listitem><para>
  79 La commande <literal>packages</literal> crée un fichier «&nbsp;Packages&nbsp;» à partir d'une
  80 arborescence. Elle recherche récursivement à travers le répertoire donné
  81 les fichiers .deb et, pour chaque fichier trouvé, envoie une entrée pour ce
  82 paquet sur la sortie standard. Cette commande est approximativement
  83 équivalente à &dpkg-scanpackages;.
  84      </para>
  85 <para>
  86 On peut se servir de l'option <option>--db</option> pour demander un cache binaire.
  87      </para></listitem>
  88 </varlistentry>
  89
  90 <varlistentry><term>sources</term>
  91 <listitem><para>
  92 La commande <literal>sources</literal> crée un index des sources à partir d'une
  93 arborescence. Elle recherche récursivement à travers le répertoire donné
  94 les fichiers .dsc et, pour chaque fichier trouvé, envoie une entrée pour ce
  95 paquet sur la sortie standard. Cette commande est approximativement
  96 équivalente à &dpkg-scansources;.
  97      </para>
  98 <para>
  99 Quand on précise un fichier «&nbsp;override&nbsp;», c'est un fichier source
 100 avec une extension .src qui est recherché. On peut se servir de l'option
 101 <option>--source-override</option> pour changer de fichier source d'«&nbsp;override&nbsp;».
 102      </para></listitem>
 103 </varlistentry>
 104
 105 <varlistentry><term>contents</term>
 106 <listitem><para>
 107 La commande <literal>contents</literal> crée un fichier «&nbsp;Contents&nbsp;» à partir d'une
 108 arborescence. Elle recherche récursivement à travers le répertoire donné
 109 les fichiers .deb et, pour chaque fichier trouvé, lit la liste des
 110 fichiers. Elle trie la liste des fichiers correspondant à des paquets et
 111 l'envoie sur la sortie standard. Les répertoires ne font pas partie du
 112 résultat. Quand un fichier appartient à plusieurs paquets, une virgule
 113 sépare les paquets.
 114      </para>
 115 <para>On peut se servir de l'option <option>--db</option> pour demander un cache binaire.
 116      </para></listitem>
 117 </varlistentry>
 118
 119      <varlistentry><term>release</term>
 120      <listitem><para>
 121 La commande <literal>release</literal> crée un fichier Releases à partir
 122 d'un répertoire. Elle cherche récursivement dans ce répertoire les
 123 fichiers Packages, Packages.gz, Packages.bz2, Sources, Sources.gz,
 124 Sources.bz2, Release et md5sum.txt. Elle envoie alors un fichier Release
 125 sur la sortie standard avec un résumé MD5 et un résumé SHA1 pour chaque
 126 fichier.
 127 </para>
 128      <para>
 129 La valeur des autres champs du fichier Release est tirée de la valeur
 130 correspondante dans <literal>APT::FTPArchive::Release</literal>,
 131 p. ex. <literal>APT::FTPArchive::Release::Origin</literal>.  Les champs reconnus
 132 sont : <literal>Origin</literal>, <literal>Label</literal>, <literal>Suite</literal>,
 133 <literal>Version</literal>, <literal>Codename</literal>, <literal>Date</literal>,
 134 <literal>Architectures</literal>, <literal>Components</literal>,
 135 <literal>Description</literal>.
 136 </para></listitem>
 137
 138      </varlistentry>
 139
 140 <varlistentry><term>generate</term>
 141 <listitem><para>
 142 La commande <literal>generate</literal> est conçue pour être exécutable par le
 143 programme cron et elle crée un index en suivant le fichier de configuration
 144 donné. Le langage de configuration fournit un moyen souple de préciser
 145 index et répertoires aussi bien que les paramètres requis.
 146      </para></listitem>
 147 </varlistentry>
 148
 149 <varlistentry><term>clean</term>
 150 <listitem><para>
 151 La commande <literal>clean</literal> range les bases de données utilisées par le
 152 fichier de configuration en supprimant les enregistrements qui ne sont
 153 plus nécessaires.
 154      </para></listitem>
 155 </varlistentry>
 156 </variablelist>
 157 </para>
 158 </refsect1>
 159
 160 <refsect1><title>Configuration de la commande generate</title>
 161 <para>
 162 La commande <literal>generate</literal> utilise un fichier de configuration pour
 163 décrire l'archive qui va être créée. Le format de ce fichier est le format
 164 ISC classique utilisé par des outils ISC comme bind 8 et dhcpd. Le fichier &apt-conf;
 165 décrit ce format. Il faut noter que l'analyse de ce fichier se fait
 166 par section tandis que celle d'&apt-conf; se fait par arborescence. Cela
 167 n'affecte que l'usage de l'étiquette de visée (scope tag).
 168    </para>
 169 <para>
 170 Ce fichier de configuration possède quatre sections, décrites ci-dessous.
 171    </para>
 172
 173 <refsect2><title>La section Dir</title>
 174 <para>
 175 La section <literal>Dir</literal> définit les répertoires standards où situer les
 176 fichiers nécessaires au processus de création. Ces répertoires sont
 177 précédés de chemins relatifs définis dans les sections suivantes de manière
 178 à produire un chemin absolu et complet.
 179 </para>
 180      <variablelist>
 181 <varlistentry><term>ArchiveDir</term>
 182 <listitem><para>
 183 Indique la racine de l'archive FTP&nbsp;; Pour une configuration Debian
 184 classique,
 185 c'est le répertoire qui contient le fichier <filename>ls-LR</filename> et les noeuds
 186 des distributions.
 187       </para></listitem>
 188 </varlistentry>
 189 <varlistentry><term>OverrideDir</term>
 190 <listitem><para>
 191 Indique l'emplacement des fichiers d'«&nbsp;override&nbsp;».
 192       </para></listitem>
 193 </varlistentry>
 194 <varlistentry><term>CacheDir</term>
 195 <listitem><para>
 196 Indique l'emplacement des fichiers de cache.
 197       </para></listitem>
 198 </varlistentry>
 199 <varlistentry><term>FileListDir</term>
 200 <listitem><para>
 201 Indique l'emplacement des fichiers contenant la liste des fichiers (si on se
 202 sert de la valeur <literal>FileList</literal> définie plus bas).
 203       </para></listitem>
 204 </varlistentry>
 205 </variablelist>
 206   </refsect2>
 207
 208 <refsect2><title>La section Default</title>
 209 <para>
 210 La section <literal>Default</literal> précise les valeurs par défaut et les paramètres
 211 qui contrôlent la marche du générateur. Ces valeurs peuvent être annulées dans
 212 d'autres sections (paramètrage par section).
 213 </para>
 214      <variablelist>
 215 <varlistentry><term>Packages::Compress</term>
 216 <listitem><para>
 217 Indique comment sont compressés les fichiers d'index. C'est une chaîne qui
 218 contient des valeurs séparées par des espaces&nbsp;; elle contient au moins
 219 l'une des valeurs suivantes&nbsp;: «&nbsp;.&nbsp;» (pas de compression),
 220 «&nbsp;gzip&nbsp;», «&nbsp;bzip2&nbsp;».
 221 Par défaut, c'est la chaîne «&nbsp;. gzip&nbsp;».
 222       </para></listitem>
 223 </varlistentry>
 224 <varlistentry><term>Packages::Extensions</term>
 225 <listitem><para>
 226 Indique la liste par défaut des extensions de fichier qui constituent des
 227 paquets. Par défaut, c'est «&nbsp;.deb&nbsp;».
 228       </para></listitem>
 229 </varlistentry>
 230 <varlistentry><term>Sources::Compress</term>
 231 <listitem><para>
 232 Identique à <literal>Packages::Compress</literal> mais précise comment sont compressés
 233 les fichiers sources.
 234       </para></listitem>
 235 </varlistentry>
 236 <varlistentry><term>Sources::Extensions</term>
 237 <listitem><para>
 238 Indique la liste par défaut des extensions de fichier qui constituent des
 239 fichiers sources. Par défaut, c'est «&nbsp;.dsc&nbsp;».
 240       </para></listitem>
 241 </varlistentry>
 242 <varlistentry><term>Contents::Compress</term>
 243 <listitem><para>
 244 Identique à <literal>Packages::Compress</literal> mais précise comment sont compressés
 245 les fichiers «&nbsp;Contents&nbsp;».
 246       </para></listitem>
 247 </varlistentry>
 248 <varlistentry><term>DeLinkLimit</term>
 249 <listitem><para>
 250 Indique le nombre de kilooctets à délier (et à remplacer par des liens en dur)
 251 pour chaque exécution. On s'en sert, pour chaque section, avec le paramètre
 252 <literal>External-Links</literal>.
 253       </para></listitem>
 254 </varlistentry>
 255 <varlistentry><term>FileMode</term>
 256 <listitem><para>
 257 Indique le système de permissions des fichiers d'index créés. Par défaut,
 258 c'est le mode 0644. Tous les fichiers d'index ont ce mode et le masque
 259 utilisateur (umasq) est ignoré.
 260       </para></listitem>
 261 </varlistentry>
 262 </variablelist>
 263 </refsect2>
 264
 265 <refsect2><title>La section TreeDefault</title>
 266 <para>
 267 On indique les valeurs par défaut particulières à la section
 268 <literal>Tree</literal>. Toutes ces variables sont des variables de
 269 substitution&nbsp;; les chaînes $(DIST),
 270 $(SECTION) et $(ARCH) sont remplacées par leur valeur respective.
 271 </para>
 272      <variablelist>
 273 <varlistentry><term>MaxContentsChange</term>
 274 <listitem><para>
 275 Indique le nombre de kilooctets de fichiers «&nbsp;Contents&nbsp;» qui sont
 276 créés chaque jour. Les fichiers «&nbsp;Contents&nbsp;» sont tirés au sort
 277 selon le système <emphasis>round-robin</emphasis> de manière que, sur
 278 plusieurs jours, tous soient reconstruits.
 279       </para></listitem>
 280 </varlistentry>
 281 <varlistentry><term>ContentsAge</term>
 282 <listitem><para>
 283 Contrôle le nombre de jours pendant lequel un fichier «&nbsp;Contents&nbsp;»
 284 peut être utilisé sans actualisation. Quand cette limite est franchie,
 285 le «&nbsp;mtime&nbsp;» du fichier «&nbsp;Contents&nbsp;» est mis à jour. Cela
 286 peut arriver quand un fichier est modifié sans que cela modifie le fichier
 287 «&nbsp;Contents&nbsp;» (modification par «&nbsp;override&nbsp;» par exemple).
 288 Un délai est permis dans l'espoir que de nouveaux «&nbsp;.deb&nbsp;» seront
 289 installés, exigeant un nouveau «&nbsp;Contents&nbsp;». Par
 290 défaut ce nombre vaut 10, l'unité étant le jour.
 291       </para></listitem>
 292 </varlistentry>
 293 <varlistentry><term>Directory</term>
 294 <listitem><para>
 295 Indique la racine de l'arborescence des «&nbsp;.deb&nbsp;». Par défaut, c'est
 296 <filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>.
 297       </para></listitem>
 298 </varlistentry>
 299
 300       <varlistentry><term>SrcDirectory</term>
 301       <listitem><para>
 302      Indique la racine de l'arborescence des paquets source. Par défaut, c'est
 303       <filename>$(DIST)/$(SECTION)/source/</filename>.
 304 </para></listitem>
 305       </varlistentry>
 306
 307 <varlistentry><term>Packages</term>
 308 <listitem><para>
 309 Indique le fichier «&nbsp;Packages&nbsp;» créé. Par défaut, c'est
 310 <filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>.
 311       </para></listitem>
 312 </varlistentry>
 313
 314 <varlistentry><term>Sources</term>
 315 <listitem><para>
 316 Indique le fichier «&nbsp;Packages&nbsp;» crée. Par défaut, c'est
 317 <filename>$(DIST)/$(SECTION)/source/Sources</filename>.
 318       </para></listitem>
 319 </varlistentry>
 320
 321 <varlistentry><term>InternalPrefix</term>
 322 <listitem><para>Indique un préfixe de chemin&nbsp;; ce préfixe fait qu'un lien symbolique sera
 323 considéré comme un lien interne plutôt que comme un lien externe. Par défaut,
 324 c'est <filename>$(DIST)/$(SECTION)/</filename>.
 325       </para></listitem>
 326 </varlistentry>
 327
 328 <varlistentry><term>Contents</term>
 329 <listitem><para>
 330 Indique le fichier «&nbsp;Contents&nbsp;» créé. Par défaut, c'est
 331 <filename>$(DIST)/Contents-$(ARCH)</filename>. Quand le paramètrage fait que
 332 différents fichiers «&nbsp;Packages&nbsp;» se réfèrent à un seul fichier
 333 «&nbsp;Contents&nbsp;», <command>apt-ftparchive</command> les intègre automatiquement.
 334       </para></listitem>
 335 </varlistentry>
 336
 337 <varlistentry><term>Contents::Header</term>
 338 <listitem><para>
 339 Indique l'en-tête à préfixer au fichier «&nbsp;Contents&nbsp;» créé.
 340       </para></listitem>
 341 </varlistentry>
 342
 343 <varlistentry><term>BinCacheDB</term>
 344 <listitem><para>
 345 Indique la base de données binaire servant de cache pour cette section.
 346 Différentes sections peuvent partager cette base de données.
 347       </para></listitem>
 348 </varlistentry>
 349 <varlistentry><term>FileList</term>
 350 <listitem><para>
 351 Indique qu'au lieu de lire l'arborescence, <command>apt-ftparchive</command> doit lire
 352 la liste de fichiers dans le fichier donné en argument. Les noms relatifs
 353 sont préfixés par le répertoire de l'archive.
 354       </para></listitem>
 355 </varlistentry>
 356 <varlistentry><term>SourceFileList</term>
 357 <listitem><para>
 358 Indique qu'au lieu de lire l'arborescence, <command>apt-ftparchive</command> doit lire
 359 la liste de fichiers dans le fichier donné en argument. Les noms relatifs
 360 sont préfixés par le répertoire de l'archive. On s'en sert pour traiter les
 361 index de sources.
 362       </para></listitem>
 363 </varlistentry>
 364 </variablelist>
 365
 366 </refsect2>
 367
 368 <refsect2><title>La section Tree</title>
 369 <para>
 370 La section <literal>Tree</literal> définit une arborescence debian classique avec
 371 un répertoire de base, différentes sections dans ce répertoire et
 372 différentes architectures dans chaque section. Le chemin exact est défini
 373 par la variable de substitution <literal>Directory</literal>.
 374      </para>
 375 <para>
 376 La section <literal>Tree</literal> accepte une étiquette de visée (scope tag) qui
 377 détermine la variable <literal>$(DIST)</literal> et la racine de l'arborescence
 378 (le chemin est préfixé par <literal>ArchiveDir</literal>). C'est par exemple&nbsp;:
 379 <filename>dists/woody</filename>.
 380      </para>
 381 <para>Tous les paramètres définis dans la section <literal>TreeDefault</literal> peuvent
 382 s'utiliser dans la section <literal>Tree</literal> ainsi que les trois nouvelles
 383 variables suivantes.
 384      </para>
 385 <para>
 386 Quand il exécute la section <literal>Tree</literal>, <command>apt-ftparchive</command>
 387 agit ainsi&nbsp;:
 388 <informalexample><programlisting>
 389 for i in Sections do
 390    for j in Architectures do
 391       Generate for DIST=scope SECTION=i ARCH=j
 392 </programlisting></informalexample>
 393 </para>
 394
 395      <variablelist>
 396 <varlistentry><term>Sections</term>
 397 <listitem><para>
 398 C'est une liste de sections séparées par des espaces qui appartiennent à une
 399 distribution&nbsp;; classiquement, on trouve <literal>main contrib non-free</literal>.
 400       </para></listitem>
 401 </varlistentry>
 402
 403 <varlistentry><term>Architectures</term>
 404 <listitem><para>
 405 C'est une liste de toutes les architectures qui appartiennent à chaque
 406 section. L'architecture spéciale «&nbsp;source&nbsp;» indique que
 407 l'arborescence est une arborescence de sources.
 408       </para></listitem>
 409 </varlistentry>
 410
 411 <varlistentry><term>BinOverride</term>
 412 <listitem><para>
 413 Indique le fichier binaire d'«&nbsp;override&nbsp;». Ce fichier contient
 414 des informations sur la section, la priorité et le responsable du paquet.
 415       </para></listitem>
 416 </varlistentry>
 417
 418 <varlistentry><term>SrcOverride</term>
 419 <listitem><para>
 420 Indique le fichier source d'«&nbsp;override&nbsp;». Ce fichier
 421 contient des informations sur la section.
 422       </para></listitem>
 423 </varlistentry>
 424
 425 <varlistentry><term>ExtraOverride</term>
 426 <listitem><para>
 427 Indique un autre fichier d'«&nbsp;override&nbsp;» pour les binaires.
 428       </para></listitem>
 429 </varlistentry>
 430
 431 <varlistentry><term>SrcExtraOverride</term>
 432 <listitem><para>
 433 Indique un autre fichier d'«&nbsp;override&nbsp;» pour les sources.
 434       </para></listitem>
 435 </varlistentry>
 436 </variablelist>
 437 </refsect2>
 438
 439 <refsect2><title>La section BinDirectory</title>
 440 <para>
 441 La section <literal>bindirectory</literal> définit une arborescence binaire sans
 442 structure particulière. L'étiquette de visée (scope tag) indique l'emplacement
 443 du répertoire binaire et le paramètrage est identique à celui pour la
 444 section <literal>Tree</literal> sans substitution de variables ou au paramètrage de
 445 <literal>Section</literal><literal>Architecture</literal>.
 446   </para>
 447    <variablelist>
 448 <varlistentry><term>Packages</term>
 449 <listitem><para>
 450 Indique le fichier «&nbsp;Packages&nbsp;» créé.
 451       </para></listitem>
 452 </varlistentry>
 453
 454 <varlistentry><term>Sources</term>
 455 <listitem><para>
 456 Indique le fichier «&nbsp;Sources&nbsp;» créé. L'un des deux fichiers,
 457 <literal>Packages</literal> ou <literal>Sources</literal> est nécessaire.
 458       </para></listitem>
 459 </varlistentry>
 460
 461 <varlistentry><term>Contents</term>
 462 <listitem><para>
 463 Indique le fichier «&nbsp;Contents&nbsp;» créé.
 464       </para></listitem>
 465 </varlistentry>
 466 <varlistentry><term>Binoverride</term>
 467 <listitem><para>
 468 Indique le fichier d'«&nbsp;override&nbsp;» pour les binaires.
 469       </para></listitem>
 470 </varlistentry>
 471
 472 <varlistentry><term>SrcOverride</term>
 473 <listitem><para>
 474 Indique le fichier d'«&nbsp;override&nbsp;» pour les sources.
 475       </para></listitem>
 476 </varlistentry>
 477
 478 <varlistentry><term>ExtraOverride</term>
 479 <listitem><para>
 480 Indique un autre fichier d'«&nbsp;override&nbsp;» pour les binaires.
 481       </para></listitem>
 482 </varlistentry>
 483
 484 <varlistentry><term>SrcExtraOverride</term>
 485 <listitem><para>
 486 Indique un autre fichier d'«&nbsp;override&nbsp;» pour les sources.
 487       </para></listitem>
 488 </varlistentry>
 489
 490 <varlistentry><term>BinCacheDB</term>
 491 <listitem><para>
 492 Indique une base de données cache.
 493       </para></listitem>
 494 </varlistentry>
 495
 496 <varlistentry><term>PathPrefix</term>
 497 <listitem><para>
 498 Ajoute un chemin à tous les chemins créés.
 499       </para></listitem>
 500 </varlistentry>
 501 <varlistentry><term>FileList, SourceFileList</term>
 502 <listitem><para>
 503 Indique le fichier contenant la liste des fichiers.
 504       </para></listitem>
 505 </varlistentry>
 506 </variablelist>
 507 </refsect2>
 508 </refsect1>
 509
 510 <refsect1><title>Le fichier d'«&nbsp;Override&nbsp;» pour les binaires.</title>
 511 <para>
 512 Le fichier d'«&nbsp;Override&nbsp;» est pleinement compatible avec
 513 &dpkg-scanpackages;. Il contient quatre champs séparés par des espaces. Le
 514 premier est le nom du paquet&nbsp;; le deuxième est la priorité à donner à ce
 515 paquet&nbsp;; le troisième est sa section et le dernier champ est un champ
 516 pour changer le nom du responsable de paquet.
 517    </para>
 518 <para>Le champ du responsable est de cette forme&nbsp;:
 519    <literallayout>old [// oldn]* =&gt; new</literallayout>
 520    ou simplement,
 521    <literallayout>new</literallayout>
 522 La première forme permet de spécifier de vieilles adresses dans une liste (le
 523 séparateur est la double barre oblique). Si l'une de ces deux formes est
 524 rencontrée, la valeur de new remplace la valeur du champ. La deuxième forme
 525 remplace inconditionnellement le champ.
 526  </para>
 527 </refsect1>
 528
 529 <refsect1><title>Le fichier d'«&nbsp;Override&nbsp;» pour les sources</title>
 530 <para>
 531 Le fichier d'«&nbsp;Override&nbsp;» est pleinement compatible avec
 532 &dpkg-scansources;. Il contient deux champs. Le premier est le nom du paquet
 533 source&nbsp;; le second, sa section.
 534  </para>
 535 </refsect1>
 536
 537 <refsect1><title>Le fichier supplémentaire d'«&nbsp;Override&nbsp;»</title>
 538 <para>
 539 Le fichier supplémentaire d'«&nbsp;Override&nbsp;» permet d'ajouter ou de
 540 remplacer des étiquettes sur la sortie. Il possède trois colonnes&nbsp;:
 541 la première représente le paquet, la seconde est une étiquette et la
 542 troisième en fin de ligne est la nouvelle valeur.
 543  </para>
 544 </refsect1>
 545
 546 <refsect1><title>Les options</title>
 547 &apt-cmdblurb;
 548
 549 <variablelist>
 550 <varlistentry><term><option>--md5</option></term>
 551 <listitem><para>
 552 Créer la somme de contrôle MD5. Cette option est activée par défaut. Quand
 553 elle est désactivée, les fichiers d'index n'ont pas les champs MD5Sum là où
 554 c'est possible.
 555 Élément de configuration&nbsp;: <literal>APT::FTPArchive::MD5</literal>.
 556      </para></listitem>
 557 </varlistentry>
 558
 559 <varlistentry><term><option>-d</option></term><term><option>--db</option></term>
 560 <listitem><para>
 561 Utiliser une base de données binaire pour cache. Cela n'a aucun effet sur la
 562 commande generate.
 563 Élément de configuration&nbsp;: <literal>APT::FTPArchive::DB</literal>.
 564      </para></listitem>
 565 </varlistentry>
 566
 567 <varlistentry><term><option>-q</option></term><term><option>--quiet</option></term>
 568 <listitem><para>
 569 Mode silencieux&nbsp;; cette commande produit une sortie destinée à
 570 l'enregistrement dans un fichier-journal en omettant les indicateurs de
 571 progression. Un plus grand nombre de «&nbsp;q&nbsp;» (2 au plus) produit un
 572 plus grand silence.
 573 On peut aussi utiliser <option>-q=#</option> pour positionner le niveau de silence,
 574 et annuler le fichier de configuration.
 575 Élément de configuration&nbsp;: <literal>quiet</literal>.
 576      </para></listitem>
 577 </varlistentry>
 578
 579 <varlistentry><term><option>--delink</option></term>
 580 <listitem><para>
 581 Faire une déliaison. Si <literal>External-Links</literal> est activé, cette option
 582 permet réellement la déliaison des fichiers. Par défaut, elle est activée mais
 583 elle peut être désactivée avec l'option <option>--no-delink</option>.
 584 Élément de configuration&nbsp;: <literal>APT::FTPArchive::DeLinkAct</literal>.
 585      </para></listitem>
 586 </varlistentry>
 587
 588 <varlistentry><term><option>--contents</option></term>
 589 <listitem><para>
 590 Permettre la création d'un fichier «&nbsp;Contents&nbsp;». Quand cette option
 591 est activée et que les index sont créés sous forme de base de données binaire,
 592 la liste des fichiers est aussi extraite et conservée dans la base de données
 593 pour un usage futur. Avec la commande generate, cette option permet la
 594 création de fichiers «&nbsp;Contents&nbsp;». Par défaut, elle est activée.
 595 Élément de configuration&nbsp;: <literal>APT::FTPArchive::Contents</literal>.
 596      </para></listitem>
 597 </varlistentry>
 598
 599 <varlistentry><term><option>-s</option></term><term><option>--source-override</option></term>
 600 <listitem><para>
 601 Indique le fichier d'«&nbsp;override&nbsp;» à utiliser avec la commande
 602 <literal>sources</literal>.
 603 Élément de configuration&nbsp;: <literal>APT::FTPArchive::SourceOverride</literal>.
 604      </para></listitem>
 605 </varlistentry><varlistentry><term><option>--readonly</option></term>
 606 <listitem><para>
 607 N'autoriser que la lecture pour les bases de données de cache.
 608 Élément de configuration&nbsp;: <literal>APT::FTPArchive::ReadOnlyDB</literal>.
 609      </para></listitem>
 610 </varlistentry>
 611
 612 &apt-commonoptions;
 613 </variablelist>
 614 </refsect1>
 615
 616 <refsect1><title>Voir aussi</title>
 617 <para>&apt-conf;
 618  </para>
 619 </refsect1>
 620
 621 <refsect1><title>Diagnostics</title>
 622 <para>
 623 <command>apt-ftparchive</command> retourne zéro si tout se passe bien, le nombre
 624 décimal 100 en cas d'erreur.
 625  </para>
 626 </refsect1>
 627
 628 &manbugs;
 629 &traducteur;
 630
 631 </refentry>