diff options
Diffstat (limited to 'doc/fr/apt-ftparchive.fr.1.xml')
| -rw-r--r-- | doc/fr/apt-ftparchive.fr.1.xml | 631 |
1 files changed, 631 insertions, 0 deletions
diff --git a/doc/fr/apt-ftparchive.fr.1.xml b/doc/fr/apt-ftparchive.fr.1.xml new file mode 100644 index 000000000..61cdfa2ec --- /dev/null +++ b/doc/fr/apt-ftparchive.fr.1.xml @@ -0,0 +1,631 @@ +<?xml version="1.0" encoding="iso-8859-15" standalone="no"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang="fr"> + + <refentryinfo> + &apt-author.jgunthorpe; + &apt-author.team; + &apt-email; + &apt-product; + <!-- The last update date --> + <date>29 Février 2004</date> + </refentryinfo> + +<refmeta> +<refentrytitle>apt-ftparchive</refentrytitle> +<manvolnum>1</manvolnum> +</refmeta> + +<refnamediv><refname>apt-ftparchive</refname> +<refpurpose>Un outil pour créer des index + </refpurpose> +</refnamediv> + +<refsynopsisdiv> +<cmdsynopsis> +<command>apt-ftparchive</command> +<arg><option>-hvdsq</option></arg><arg> +<option>--md5</option></arg><arg> +<option>--delink</option></arg> +<arg><option>--readonly</option></arg> +<arg><option>--contents</option></arg> +<arg><option>-o=<replaceable>option de configuration</replaceable></option></arg> +<arg><option>-c=<replaceable>fichier</replaceable></option></arg> +<group choice="req"> +<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> +<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> +<arg>contents <arg choice="plain"><replaceable>chemin</replaceable></arg></arg> +<arg>release <arg choice="plain"><replaceable>chemin</replaceable></arg></arg> +<arg>generate <arg choice="plain"><replaceable>fichier-de-configuration</replaceable></arg><arg choice="plain" rep="repeat"><replaceable>section</replaceable></arg></arg> +<arg>clean <arg choice="plain"><replaceable>fichier-de-configuration</replaceable></arg></arg> +</group> +</cmdsynopsis> +</refsynopsisdiv> + +<refsect1><title>Description</title> +<para> +<command>apt-ftparchive</command> est l'outil en ligne de commande qui crée les index +dont APT se sert pour accéder aux sources des distributions. Un index doit +être créé pour un site et basé sur le contenu de ce site. + </para> +<para><command>apt-ftparchive</command> est un ensemble comprenant le programme +&dpkg-scanpackages; et toutes ses fonctionnalités via la commande +<literal>packages</literal> ; il comprend aussi un générateur de fichier +« Contents », la commande <literal>contents</literal>, et une technique +élaborée pour « scripter » le processus de création d'une archive +complète. + </para> +<para> +<command>Apt-ftparchive</command> peut utiliser lui-même des bases de données binaires +pour « cacher » le contenu d'un fichier .deb ; il n'a pas +besoin de programmes extérieurs, sauf &gzip;. Lors d'une exécution, il +vérifie les changements dans les fichiers et crée les fichiers compressés +voulus. + </para> +<para> +À moins que l'option <option>-h</option> ou <option>--help</option> ne soit donnée, l'une des +commandes suivantes doit être présente : + + <variablelist> +<varlistentry><term>packages</term> +<listitem><para> +La commande <literal>packages</literal> crée un fichier « Packages » à partir d'une +arborescence. Elle recherche récursivement à travers le répertoire donné +les fichiers .deb et, pour chaque fichier trouvé, envoie une entrée pour ce +paquet sur la sortie standard. Cette commande est approximativement +équivalente à &dpkg-scanpackages;. + </para> +<para> +On peut se servir de l'option <option>--db</option> pour demander un cache binaire. + </para></listitem> +</varlistentry> + +<varlistentry><term>sources</term> +<listitem><para> +La commande <literal>sources</literal> crée un index des sources à partir d'une +arborescence. Elle recherche récursivement à travers le répertoire donné +les fichiers .dsc et, pour chaque fichier trouvé, envoie une entrée pour ce +paquet sur la sortie standard. Cette commande est approximativement +équivalente à &dpkg-scansources;. + </para> +<para> +Quand on précise un fichier « override », c'est un fichier source +avec une extension .src qui est recherché. On peut se servir de l'option +<option>--source-override</option> pour changer de fichier source d'« override ». + </para></listitem> +</varlistentry> + +<varlistentry><term>contents</term> +<listitem><para> +La commande <literal>contents</literal> crée un fichier « Contents » à partir d'une +arborescence. Elle recherche récursivement à travers le répertoire donné +les fichiers .deb et, pour chaque fichier trouvé, lit la liste des +fichiers. Elle trie la liste des fichiers correspondant à des paquets et +l'envoie sur la sortie standard. Les répertoires ne font pas partie du +résultat. Quand un fichier appartient à plusieurs paquets, une virgule +sépare les paquets. + </para> +<para>On peut se servir de l'option <option>--db</option> pour demander un cache binaire. + </para></listitem> +</varlistentry> + + <varlistentry><term>release</term> + <listitem><para> +La commande <literal>release</literal> crée un fichier Releases à partir +d'un répertoire. Elle cherche récursivement dans ce répertoire les +fichiers Packages, Packages.gz, Packages.bz2, Sources, Sources.gz, +Sources.bz2, Release et md5sum.txt. Elle envoie alors un fichier Release +sur la sortie standard avec un résumé MD5 et un résumé SHA1 pour chaque +fichier. +</para> + <para> +La valeur des autres champs du fichier Release est tirée de la valeur +correspondante dans <literal>APT::FTPArchive::Release</literal>, +p. ex. <literal>APT::FTPArchive::Release::Origin</literal>. Les champs reconnus +sont : <literal>Origin</literal>, <literal>Label</literal>, <literal>Suite</literal>, +<literal>Version</literal>, <literal>Codename</literal>, <literal>Date</literal>, +<literal>Architectures</literal>, <literal>Components</literal>, +<literal>Description</literal>. +</para></listitem> + + </varlistentry> + +<varlistentry><term>generate</term> +<listitem><para> +La commande <literal>generate</literal> est conçue pour être exécutable par le +programme cron et elle crée un index en suivant le fichier de configuration +donné. Le langage de configuration fournit un moyen souple de préciser +index et répertoires aussi bien que les paramètres requis. + </para></listitem> +</varlistentry> + +<varlistentry><term>clean</term> +<listitem><para> +La commande <literal>clean</literal> range les bases de données utilisées par le +fichier de configuration en supprimant les enregistrements qui ne sont +plus nécessaires. + </para></listitem> +</varlistentry> +</variablelist> +</para> +</refsect1> + +<refsect1><title>Configuration de la commande generate</title> +<para> +La commande <literal>generate</literal> utilise un fichier de configuration pour +décrire l'archive qui va être créée. Le format de ce fichier est le format +ISC classique utilisé par des outils ISC comme bind 8 et dhcpd. Le fichier &apt-conf; +décrit ce format. Il faut noter que l'analyse de ce fichier se fait +par section tandis que celle d'&apt-conf; se fait par arborescence. Cela +n'affecte que l'usage de l'étiquette de visée (scope tag). + </para> +<para> +Ce fichier de configuration possède quatre sections, décrites ci-dessous. + </para> + +<refsect2><title>La section Dir</title> +<para> +La section <literal>Dir</literal> définit les répertoires standards où situer les +fichiers nécessaires au processus de création. Ces répertoires sont +précédés de chemins relatifs définis dans les sections suivantes de manière +à produire un chemin absolu et complet. +</para> + <variablelist> +<varlistentry><term>ArchiveDir</term> +<listitem><para> +Indique la racine de l'archive FTP ; Pour une configuration Debian +classique, +c'est le répertoire qui contient le fichier <filename>ls-LR</filename> et les noeuds +des distributions. + </para></listitem> +</varlistentry> +<varlistentry><term>OverrideDir</term> +<listitem><para> +Indique l'emplacement des fichiers d'« override ». + </para></listitem> +</varlistentry> +<varlistentry><term>CacheDir</term> +<listitem><para> +Indique l'emplacement des fichiers de cache. + </para></listitem> +</varlistentry> +<varlistentry><term>FileListDir</term> +<listitem><para> +Indique l'emplacement des fichiers contenant la liste des fichiers (si on se +sert de la valeur <literal>FileList</literal> définie plus bas). + </para></listitem> +</varlistentry> +</variablelist> + </refsect2> + +<refsect2><title>La section Default</title> +<para> +La section <literal>Default</literal> précise les valeurs par défaut et les paramètres +qui contrôlent la marche du générateur. Ces valeurs peuvent être annulées dans +d'autres sections (paramètrage par section). +</para> + <variablelist> +<varlistentry><term>Packages::Compress</term> +<listitem><para> +Indique comment sont compressés les fichiers d'index. C'est une chaîne qui +contient des valeurs séparées par des espaces ; elle contient au moins +l'une des valeurs suivantes : « . » (pas de compression), +« gzip », « bzip2 ». +Par défaut, c'est la chaîne « . gzip ». + </para></listitem> +</varlistentry> +<varlistentry><term>Packages::Extensions</term> +<listitem><para> +Indique la liste par défaut des extensions de fichier qui constituent des +paquets. Par défaut, c'est « .deb ». + </para></listitem> +</varlistentry> +<varlistentry><term>Sources::Compress</term> +<listitem><para> +Identique à <literal>Packages::Compress</literal> mais précise comment sont compressés +les fichiers sources. + </para></listitem> +</varlistentry> +<varlistentry><term>Sources::Extensions</term> +<listitem><para> +Indique la liste par défaut des extensions de fichier qui constituent des +fichiers sources. Par défaut, c'est « .dsc ». + </para></listitem> +</varlistentry> +<varlistentry><term>Contents::Compress</term> +<listitem><para> +Identique à <literal>Packages::Compress</literal> mais précise comment sont compressés +les fichiers « Contents ». + </para></listitem> +</varlistentry> +<varlistentry><term>DeLinkLimit</term> +<listitem><para> +Indique le nombre de kilooctets à délier (et à remplacer par des liens en dur) +pour chaque exécution. On s'en sert, pour chaque section, avec le paramètre +<literal>External-Links</literal>. + </para></listitem> +</varlistentry> +<varlistentry><term>FileMode</term> +<listitem><para> +Indique le système de permissions des fichiers d'index créés. Par défaut, +c'est le mode 0644. Tous les fichiers d'index ont ce mode et le masque +utilisateur (umasq) est ignoré. + </para></listitem> +</varlistentry> +</variablelist> +</refsect2> + +<refsect2><title>La section TreeDefault</title> +<para> +On indique les valeurs par défaut particulières à la section +<literal>Tree</literal>. Toutes ces variables sont des variables de +substitution ; les chaînes $(DIST), +$(SECTION) et $(ARCH) sont remplacées par leur valeur respective. +</para> + <variablelist> +<varlistentry><term>MaxContentsChange</term> +<listitem><para> +Indique le nombre de kilooctets de fichiers « Contents » qui sont +créés chaque jour. Les fichiers « Contents » sont tirés au sort +selon le système <emphasis>round-robin</emphasis> de manière que, sur +plusieurs jours, tous soient reconstruits. + </para></listitem> +</varlistentry> +<varlistentry><term>ContentsAge</term> +<listitem><para> +Contrôle le nombre de jours pendant lequel un fichier « Contents » +peut être utilisé sans actualisation. Quand cette limite est franchie, +le « mtime » du fichier « Contents » est mis à jour. Cela +peut arriver quand un fichier est modifié sans que cela modifie le fichier +« Contents » (modification par « override » par exemple). +Un délai est permis dans l'espoir que de nouveaux « .deb » seront +installés, exigeant un nouveau « Contents ». Par +défaut ce nombre vaut 10, l'unité étant le jour. + </para></listitem> +</varlistentry> +<varlistentry><term>Directory</term> +<listitem><para> +Indique la racine de l'arborescence des « .deb ». Par défaut, c'est +<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>. + </para></listitem> +</varlistentry> + + <varlistentry><term>SrcDirectory</term> + <listitem><para> + Indique la racine de l'arborescence des paquets source. Par défaut, c'est + <filename>$(DIST)/$(SECTION)/source/</filename>. +</para></listitem> + </varlistentry> + +<varlistentry><term>Packages</term> +<listitem><para> +Indique le fichier « Packages » créé. Par défaut, c'est +<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>. + </para></listitem> +</varlistentry> + +<varlistentry><term>Sources</term> +<listitem><para> +Indique le fichier « Packages » crée. Par défaut, c'est +<filename>$(DIST)/$(SECTION)/source/Sources</filename>. + </para></listitem> +</varlistentry> + +<varlistentry><term>InternalPrefix</term> +<listitem><para>Indique un préfixe de chemin ; ce préfixe fait qu'un lien symbolique sera +considéré comme un lien interne plutôt que comme un lien externe. Par défaut, +c'est <filename>$(DIST)/$(SECTION)/</filename>. + </para></listitem> +</varlistentry> + +<varlistentry><term>Contents</term> +<listitem><para> +Indique le fichier « Contents » créé. Par défaut, c'est +<filename>$(DIST)/Contents-$(ARCH)</filename>. Quand le paramètrage fait que +différents fichiers « Packages » se réfèrent à un seul fichier +« Contents », <command>apt-ftparchive</command> les intègre automatiquement. + </para></listitem> +</varlistentry> + +<varlistentry><term>Contents::Header</term> +<listitem><para> +Indique l'en-tête à préfixer au fichier « Contents » créé. + </para></listitem> +</varlistentry> + +<varlistentry><term>BinCacheDB</term> +<listitem><para> +Indique la base de données binaire servant de cache pour cette section. +Différentes sections peuvent partager cette base de données. + </para></listitem> +</varlistentry> +<varlistentry><term>FileList</term> +<listitem><para> +Indique qu'au lieu de lire l'arborescence, <command>apt-ftparchive</command> doit lire +la liste de fichiers dans le fichier donné en argument. Les noms relatifs +sont préfixés par le répertoire de l'archive. + </para></listitem> +</varlistentry> +<varlistentry><term>SourceFileList</term> +<listitem><para> +Indique qu'au lieu de lire l'arborescence, <command>apt-ftparchive</command> doit lire +la liste de fichiers dans le fichier donné en argument. Les noms relatifs +sont préfixés par le répertoire de l'archive. On s'en sert pour traiter les +index de sources. + </para></listitem> +</varlistentry> +</variablelist> + +</refsect2> + +<refsect2><title>La section Tree</title> +<para> +La section <literal>Tree</literal> définit une arborescence debian classique avec +un répertoire de base, différentes sections dans ce répertoire et +différentes architectures dans chaque section. Le chemin exact est défini +par la variable de substitution <literal>Directory</literal>. + </para> +<para> +La section <literal>Tree</literal> accepte une étiquette de visée (scope tag) qui +détermine la variable <literal>$(DIST)</literal> et la racine de l'arborescence +(le chemin est préfixé par <literal>ArchiveDir</literal>). C'est par exemple : +<filename>dists/woody</filename>. + </para> +<para>Tous les paramètres définis dans la section <literal>TreeDefault</literal> peuvent +s'utiliser dans la section <literal>Tree</literal> ainsi que les trois nouvelles +variables suivantes. + </para> +<para> +Quand il exécute la section <literal>Tree</literal>, <command>apt-ftparchive</command> +agit ainsi : +<informalexample><programlisting> +for i in Sections do + for j in Architectures do + Generate for DIST=scope SECTION=i ARCH=j +</programlisting></informalexample> +</para> + + <variablelist> +<varlistentry><term>Sections</term> +<listitem><para> +C'est une liste de sections séparées par des espaces qui appartiennent à une +distribution ; classiquement, on trouve <literal>main contrib non-free</literal>. + </para></listitem> +</varlistentry> + +<varlistentry><term>Architectures</term> +<listitem><para> +C'est une liste de toutes les architectures qui appartiennent à chaque +section. L'architecture spéciale « source » indique que +l'arborescence est une arborescence de sources. + </para></listitem> +</varlistentry> + +<varlistentry><term>BinOverride</term> +<listitem><para> +Indique le fichier binaire d'« override ». Ce fichier contient +des informations sur la section, la priorité et le responsable du paquet. + </para></listitem> +</varlistentry> + +<varlistentry><term>SrcOverride</term> +<listitem><para> +Indique le fichier source d'« override ». Ce fichier +contient des informations sur la section. + </para></listitem> +</varlistentry> + +<varlistentry><term>ExtraOverride</term> +<listitem><para> +Indique un autre fichier d'« override » pour les binaires. + </para></listitem> +</varlistentry> + +<varlistentry><term>SrcExtraOverride</term> +<listitem><para> +Indique un autre fichier d'« override » pour les sources. + </para></listitem> +</varlistentry> +</variablelist> +</refsect2> + +<refsect2><title>La section BinDirectory</title> +<para> +La section <literal>bindirectory</literal> définit une arborescence binaire sans +structure particulière. L'étiquette de visée (scope tag) indique l'emplacement +du répertoire binaire et le paramètrage est identique à celui pour la +section <literal>Tree</literal> sans substitution de variables ou au paramètrage de +<literal>Section</literal><literal>Architecture</literal>. + </para> + <variablelist> +<varlistentry><term>Packages</term> +<listitem><para> +Indique le fichier « Packages » créé. + </para></listitem> +</varlistentry> + +<varlistentry><term>SrcPackages</term> +<listitem><para> +Indique le fichier « Sources » créé. L'un des deux fichiers, +<literal>Packages</literal> ou <literal>SrcPackages</literal> est nécessaire. + </para></listitem> +</varlistentry> + +<varlistentry><term>Contents</term> +<listitem><para> +Indique le fichier « Contents » créé. + </para></listitem> +</varlistentry> +<varlistentry><term>Binoverride</term> +<listitem><para> +Indique le fichier d'« override » pour les binaires. + </para></listitem> +</varlistentry> + +<varlistentry><term>SrcOverride</term> +<listitem><para> +Indique le fichier d'« override » pour les sources. + </para></listitem> +</varlistentry> + +<varlistentry><term>ExtraOverride</term> +<listitem><para> +Indique un autre fichier d'« override » pour les binaires. + </para></listitem> +</varlistentry> + +<varlistentry><term>SrcExtraOverride</term> +<listitem><para> +Indique un autre fichier d'« override » pour les sources. + </para></listitem> +</varlistentry> + +<varlistentry><term>BinCacheDB</term> +<listitem><para> +Indique une base de données cache. + </para></listitem> +</varlistentry> + +<varlistentry><term>PathPrefix</term> +<listitem><para> +Ajoute un chemin à tous les chemins créés. + </para></listitem> +</varlistentry> +<varlistentry><term>FileList, SourceFileList</term> +<listitem><para> +Indique le fichier contenant la liste des fichiers. + </para></listitem> +</varlistentry> +</variablelist> +</refsect2> +</refsect1> + +<refsect1><title>Le fichier d'« Override » pour les binaires.</title> +<para> +Le fichier d'« Override » est pleinement compatible avec +&dpkg-scanpackages;. Il contient quatre champs séparés par des espaces. Le +premier est le nom du paquet ; le deuxième est la priorité à donner à ce +paquet ; le troisième est sa section et le dernier champ est un champ +pour changer le nom du responsable de paquet. + </para> +<para>Le champ du responsable est de cette forme : + <literallayout>old [// oldn]* => new</literallayout> + ou simplement, + <literallayout>new</literallayout> +La première forme permet de spécifier de vieilles adresses dans une liste (le +séparateur est la double barre oblique). Si l'une de ces deux formes est +rencontrée, la valeur de new remplace la valeur du champ. La deuxième forme +remplace inconditionnellement le champ. + </para> +</refsect1> + +<refsect1><title>Le fichier d'« Override » pour les sources</title> +<para> +Le fichier d'« Override » est pleinement compatible avec +&dpkg-scansources;. Il contient deux champs. Le premier est le nom du paquet +source ; le second, sa section. + </para> +</refsect1> + +<refsect1><title>Le fichier supplémentaire d'« Override »</title> +<para> +Le fichier supplémentaire d'« Override » permet d'ajouter ou de +remplacer des étiquettes sur la sortie. Il possède trois colonnes : +la première représente le paquet, la seconde est une étiquette et la +troisième en fin de ligne est la nouvelle valeur. + </para> +</refsect1> + +<refsect1><title>Les options</title> +&apt-cmdblurb; + +<variablelist> +<varlistentry><term><option>--md5</option></term> +<listitem><para> +Créer la somme de contrôle MD5. Cette option est activée par défaut. Quand +elle est désactivée, les fichiers d'index n'ont pas les champs MD5Sum là où +c'est possible. +Élément de configuration : <literal>APT::FTPArchive::MD5</literal>. + </para></listitem> +</varlistentry> + +<varlistentry><term><option>-d</option></term><term><option>--db</option></term> +<listitem><para> +Utiliser une base de données binaire pour cache. Cela n'a aucun effet sur la +commande generate. +Élément de configuration : <literal>APT::FTPArchive::DB</literal>. + </para></listitem> +</varlistentry> + +<varlistentry><term><option>-q</option></term><term><option>--quiet</option></term> +<listitem><para> +Mode silencieux ; cette commande produit une sortie destinée à +l'enregistrement dans un fichier-journal en omettant les indicateurs de +progression. Un plus grand nombre de « q » (2 au plus) produit un +plus grand silence. +On peut aussi utiliser <option>-q=#</option> pour positionner le niveau de silence, +et annuler le fichier de configuration. +Élément de configuration : <literal>quiet</literal>. + </para></listitem> +</varlistentry> + +<varlistentry><term><option>--delink</option></term> +<listitem><para> +Faire une déliaison. Si <literal>External-Links</literal> est activé, cette option +permet réellement la déliaison des fichiers. Par défaut, elle est activée mais +elle peut être désactivée avec l'option <option>--no-delink</option>. +Élément de configuration : <literal>APT::FTPArchive::DeLinkAct</literal>. + </para></listitem> +</varlistentry> + +<varlistentry><term><option>--contents</option></term> +<listitem><para> +Permettre la création d'un fichier « Contents ». Quand cette option +est activée et que les index sont créés sous forme de base de données binaire, +la liste des fichiers est aussi extraite et conservée dans la base de données +pour un usage futur. Avec la commande generate, cette option permet la +création de fichiers « Contents ». Par défaut, elle est activée. +Élément de configuration : <literal>APT::FTPArchive::Contents</literal>. + </para></listitem> +</varlistentry> + +<varlistentry><term><option>-s</option></term><term><option>--source-override</option></term> +<listitem><para> +Indique le fichier d'« override » à utiliser avec la commande +<literal>sources</literal>. +Élément de configuration : <literal>APT::FTPArchive::SourceOverride</literal>. + </para></listitem> +</varlistentry><varlistentry><term><option>--readonly</option></term> +<listitem><para> +N'autoriser que la lecture pour les bases de données de cache. +Élément de configuration : <literal>APT::FTPArchive::ReadOnlyDB</literal>. + </para></listitem> +</varlistentry> + +&apt-commonoptions; +</variablelist> +</refsect1> + +<refsect1><title>Voir aussi</title> +<para>&apt-conf; + </para> +</refsect1> + +<refsect1><title>Diagnostics</title> +<para> +<command>apt-ftparchive</command> retourne zéro si tout se passe bien, le nombre +décimal 100 en cas d'erreur. + </para> +</refsect1> + +&manbugs; +&traducteur; + +</refentry>
\ No newline at end of file |