<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<refentry lang=fr>
  <refentryinfo>
    <address>
      <email>sjg@debian.org</email>
    </address>
    <author>
      <firstname>Sebastien</firstname>
      <surname>Gross</surname>
      <othername>J.</othername>
    </author>
    <date>Mai 2003</date>
  </refentryinfo>

  <refmeta>
    <refentrytitle>apt-file</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>apt-file</refname>
    <refpurpose>
      utilitaire APT de recherche de paquet -- interface en ligne de commande
    </refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>apt-file</command>
      <arg><option>options</option></arg>
      <arg>action</arg>
      <arg>motif</arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>DESCRIPTION</title>
    <para><command>apt-file</command> est un outil en ligne de commande de
	recherche de paquets pour le sytème de paquet APT.</para>
	<para>Il est nécessaire de faire quelques actions avant de pouvoir lancer
	une recherche&nbsp;:</para>

    <variablelist>
      <varlistentry>
	<term>update</term>
	<listitem>
	  <para>
	    Resynchronise le contenu des paquets depuis leurs sources. Les contenus
		de paquets sont récupérés depuis les adresses spécifiées dans
		<filename>/etc/apt/sources.list</filename>. Cette commande essaie de
		récupérer le fichier <filename>Contents-&lt;ARCH&gt;.gz</filename>
		depuis la source distante.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>search</term>
	<listitem>
	  <para>
	    Recherche dans quel paquet un fichier est inclus. Une liste de tous les
		paquets contenant le motif <literal>motif</literal> est affichée.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>list</term>
	<listitem>
	  <para>
	    Liste le contenu d'un paquet correspondant au motif
	    <literal>motif</literal>. Cette action ressemble beaucoup à la commande
	    <command>dpkg -L</command> sauf que les paquets n'ont pas besoin d'être
	    installés ou récupérés.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>purge</term>
	<listitem>
	  <para>
	    Supprime tous les fichiers <filename>Content-&lt;ARCH&gt;.gz</filename>
	    dans le répertoire de cache.
	  </para>
	</listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>OPTIONS</title>
      <variablelist>
        <varlistentry>
      <term>
	<option>--cache | -c</option> <literal>répertoire-de-cache</literal>
      </term>
      <listitem>
        <para>
	  Fixe le répertoire de cache à <literal>répertoire-de-cache</literal>
	  au lieu de sa valeur par défaut (<filename>/var/cache/apt</filename>).
	  Vous pourrez alors utiliser <command>apt-file</command> même si vous
	  n'avez pas les droits d'administrateur.
	</para>
      </listitem>
      </varlistentry>

      <varlistentry>
      <term>
	<option>--verbose | -v</option>
      </term>
      <listitem>
        <para>
 	  Lance la commande <command>apt-file</command> en mode bavard.
        </para>
      </listitem>
      </varlistentry>

    <varlistentry>
     <term>
	<option>--cdrom-mount | -d</option>
	  <literal>point-de-montage-du-cédérom</literal>
	</term>
	<listitem>
	  <para>
	    Utilise <literal>point-de-montage-du-cédérom</literal> à la place de
	    celui la commande <command>apt</command>.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	<option>--ignore-case | -i</option>
	</term>
	<listitem>
	  <para>Ne développe pas <literal>motif</literal>.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term>
	<option>--architecture | -a</option> architecture
	</term>
	<listitem>
	  <para>
	    Positionne l'architecture à <literal>architecture</literal>. Cette
	    option est utile si vous cherchez un paquet pour une architecture
	    différente de celle sur laquelle votre système est installé.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term>
	<option>--sources-list | -s</option> sources.list
        </term>
        <listitem>
	  <para>
	    Positionne le fichier <filename>sources.list</filename> à une valeur
	    différente de celle par défaut
  	    (<filename>/etc/apt/sources.list</filename>).
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
	<option>--package-only | -l</option>
        </term>
        <listitem>
          <para>
	    Affiche seulement le nom du paquet. N'affiche pas le nom des fichiers.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
	<option>--fixed-string | -F</option>
        </term>
	<listitem>
	  <para>
	    N'étend pas le motif de recherche avec des caractères génériques au
	    début et à la fin du motif.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term>
	<option>--dummy | -y</option>
        </term>
        <listitem>
          <para>Lance en mode simulation (pas d'action).</para>
        </listitem>
      </varlistentry>
		  
      <varlistentry>
        <term>
	<option>--help | -h</option>
        </term>
        <listitem>
          <para>Affiche un court message d'aide.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    <title>FICHIER DE CONFIGURATION</title>
    <para>
      Le fichier de configuration de <command>apt-file</command>
      (<filename>/etc/apt/apt-file.conf</filename>) a changé entre la version 1
      et la version 2. Maintenant, seules les méthodes de récupération sont
      définies dans le fichier de configuration. Il est donc plus facile de
      configurer des mandataires.
    </para>
    <para>
      Une expansion de chaîne est faite sur plusieurs valeurs. Regardez la
      section <literal>expansion de chaînes</literal>.
    </para>
    <variablelist>
      <varlistentry>
        <term>destination</term>
   	<listitem>
	  <para>
	    Cette variable décrit la manière de nommer les fichiers en cache.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
        <term>http | ftp | ssh | rsh | file | cdrom</term>
        <listitem>
          <para>Voici les commandes utilisées pour récuperer les fichiers.</para>
        </listitem>
      </varlistentry>
    </variablelist>
    <refsect2>
      <title>Expansion de chaînes</title>
	<para>
          Une entrée du <filename>sources.list</filename> est définie ainsi&nbsp;:
	<screen>
          deb uri dist composant1 composant2 ...
	</screen>
	  une uri, est définie ainsi&nbsp;:
	<screen>
	  proto:/[/][utilisateur[:motdepasse]@]hôte[:port][/chemin]
	</screen>
	</para>
      <variablelist>
        <varlistentry>
	  <term>&lt;hôte&gt;</term>
	  <listitem>
	    <para>remplace le nom de l'hôte.</para>
	  </listitem>
	</varlistentry>
	
	<varlistentry>
	  <term>&lt;port&gt;</term>
	  <listitem>
        <para>remplace le numéro du port.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
          <term>&lt;uri&gt;</term>
	  <listitem>
	    <para>remplace l'uri complète.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&lt;chemin&gt;</term>
	  <listitem>
	    <para>remplace le chemin complet (relatif à la racine de l'hôte)</para>
          </listitem>
        </varlistentry>

	<varlistentry>
	  <term>&lt;dist&gt;</term>
	  <listitem>
            <para>remplace le nom de la distribution</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&lt;comp&gt;</term>
	  <listitem>
	    <para>remplace le nom du composant</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&lt;cache&gt;</term>
	  <listitem>
	    <para>remplace le nom du répertoire de cache</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&lt;dest&gt;</term>
	  <listitem>
	    <para>
	      remplace <literal>destination</literal> par sa valeur étendue.
	    </para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&lt;cdrom&gt;</term>
	  <listitem>
	    <para>remplace <literal>point-de-montage-du-cédérom</literal>.</para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </refsect2>
  </refsect1>

  <refsect1>
    <title>FICHIERS</title>
    <variablelist>
      <varlistentry>
        <term><filename>/etc/apt/sources.list</filename></term>
        <listitem>
          <para>Adresse où récupérer le contenu des paquets.</para>
	</listitem>
      </varlistentry>
      <varlistentry>
	<term><filename>/etc/apt/apt-file.conf</filename></term>
	<listitem>
	  <para>Fichier de configuration pour <command>apt-file</command>.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    <title>VOIR AUSSI</title>
	<para>
	  <command>auto-apt</command>(1),
	  <command>apt-cache</command>(8),
	  <command>apt-cdrom</command>(8),
	  <command>dpkg</command>(8),
	  <command>dselect</command>(8),
	  <filename>sources.list</filename>(5),
	  <filename>apt.conf</filename>(5),
	  <command>apt_preferences</command>(5).
	</para>
	<para>
	  Le guide de l'utilisateur d'APT dans
	  <filename>/usr/share/doc/apt/</filename>
	</para>
  </refsect1>
  <refsect1>
    <title>BOGUES</title>
	<para>la méthode pour les cédéroms n'a pas encore été testé.</para>
	<para>
	  Les lignes qui n'ont pas de version ne sont pas gérées par apt-file.
	</para>
  </refsect1>
  <refsect1>
    <title>AUTEUR</title>
	<para>
	  <command>apt-file</command> a été écrit par Sebastien J. Gross
	  <email>sjg@debian.org</email>.
	</para>
  </refsect1>
  <refsect1>
    <title>TRADUCTION</title>
	<para>Julien Louis <email>leonptitlouis@ifrance.com</email></para>
  </refsect1>
</refentry>
														
