doc/fr/apt-ftparchive.fr.1.sgml

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