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