<?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-cache</refentrytitle>
   <manvolnum>8</manvolnum>
 </refmeta>
 
 <!-- Man page title -->
 <refnamediv>
    <refname>apt-cache</refname>
    <refpurpose>Gestion des paquets et manipulation du cache par APT</refpurpose>
 </refnamediv>

 <!-- Arguments -->
 <refsynopsisdiv>
   <cmdsynopsis>
      <command>apt-cache</command>
      <arg><option>-hvsn</option></arg>
      <arg><option>-o=<replaceable>option de configuration</replaceable></option></arg>
      <arg><option>-c=<replaceable>fichier</replaceable></option></arg>
      <group choice="req">
         <arg>add <arg choice="plain" rep="repeat"><replaceable>fichier</replaceable></arg></arg>
         <arg>gencaches</arg>
         <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>showsrc <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>stats</arg>
         <arg>dump</arg>
         <arg>dumpavail</arg>
         <arg>unmet</arg>
         <arg>search <arg choice="plain"><replaceable>regex</replaceable></arg></arg>
         <arg>show <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>depends <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>rdepends <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>pkgnames <arg choice="plain"><replaceable>prefix</replaceable></arg></arg>
         <arg>dotty <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>policy <arg choice="plain" rep="repeat"><replaceable>paquets</replaceable></arg></arg>
         <arg>madison <arg choice="plain" rep="repeat"><replaceable>paquets</replaceable></arg></arg>
      </group>   
   </cmdsynopsis>
 </refsynopsisdiv>
 
 <refsect1><title>Description</title>
   <para>
<command>apt-cache</command> r�alise diff�rentes op�rations sur le cache de paquet d' 
APT. <command>apt-cache</command> ne manipule pas l'�tat du syst�me mais fournit des
moyens de recherche dans les m�tadonn�es d'un paquet desquelles il extrait
d'int�ressantes informations.
</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.</para>

   <variablelist>
     <varlistentry><term>add <replaceable>fichier(s)</replaceable></term>
     <listitem><para>
La commande <literal>add</literal> ajoute des fichiers indexant des paquets au cache des
paquets. Cela sert uniquement pour le d�bogage.</para>
	  </listitem>
     </varlistentry>
     
     <varlistentry><term>gencaches</term>
     <listitem><para>
La commande <literal>gencaches</literal> fait la m�me chose que 
<command>apt-get check</command>. Elle construit les caches des sources et des paquets 
� partir des sources r�pertori�es dans &sources-list; et dans 
<filename>/var/lib/dpkg/status</filename>.</para>
	  </listitem>
     </varlistentry>

     <varlistentry><term>showpkg <replaceable>paquet(s)</replaceable></term>
     <listitem><para>
La commande <literal>showpkg</literal> affiche des informations sur les paquets donn�s
en argument. Les arguments restants sont les noms de paquets. Les versions
disponibles et les d�pendances inverses de chaque paquet r�pertori� sont 
list�es, ainsi que les d�pendances normales pour chaque version. Les 
d�pendances normales d'un paquet sont constitu�es par les paquets dont il 
d�pend&nbsp;; les
d�pendances inverses sont les paquets qui d�pendent du paquet en question.
Les d�pendances normales doivent donc �tre satisfaites et les d�pendances
inverses n'ont pas besoin de l'�tre. Ainsi, la commande 
<command>apt-cache showpkg libreadline2</command> donnera ce r�sultat&nbsp;:
</para>     
<informalexample><programlisting>
Package: libreadline2
Versions: 2.1-12(/var/state/apt/lists/foo_Packages),
Reverse Depends: 
  libreadlineg2,libreadline2
  libreadline2-altdev,libreadline2
Dependencies:
2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
Provides:
2.1-12 - 
Reverse Provides: 
</programlisting></informalexample>

     <para>
On peut voir que libreadline2, version 2.1-12, d�pend de libc5, ncurses3.0&nbsp;; 
ces paquets doivent �tre install�s au pr�alable pour que 
libreadline2 fonctionne. � leur tour, libreadlineg2 et libreadline2-altdev 
d�pendent de libreadline2. Si libreadline2 est install�, libc5 et ncurses3.0 
doivent �tre install�s&nbsp;; libreadlineg2 et libreadline2-altdev 
n'ont pas � l'�tre. Pour conna�tre le sens de la fin de cha�ne, il est 
pr�f�rable de consulter le code source d'APT.</para>
	  </listitem>
     </varlistentry>

     <varlistentry><term>stats</term>
     <listitem><para>
La commande <literal>stats</literal> affiche des statistiques � propos du cache. Aucun
autre argument n'est attendu. Voici les informations rapport�es&nbsp;:
     <itemizedlist>
       <listitem><para>
<literal>Total package names</literal> est le nombre de paquets trouv�s dans le cache.
     </para>  </listitem>
       
       <listitem><para>
<literal>Normal packages</literal> est le nombre de paquets simples, 
ordinaires&nbsp;; ces paquets tol�rent une correspondance bijective entre 
leur nom et le nom utilis� par les autres paquets pour les qualifier comme 
d�pendance. La majorit� des paquets appartient � cette cat�gorie.</para>
       </listitem>

       <listitem><para>
<literal>Pure virtual packages</literal> est le nombre des paquets qui n'existent que 
sous la forme d'un nom repr�sentant un paquet virtuel&nbsp;; ces paquets 
�&nbsp;fournissent&nbsp;� seulement un nom de paquet virtuel et aucun paquet
n'utilise v�ritablement ce nom. Par exemple, au sein du syst�me Debian 
GNU/Linux, le nom �&nbsp;mail-transport-agent&nbsp;� est un paquet virtuel 
pur&nbsp;; plusieurs paquets peuvent �&nbsp;remplir&nbsp;� ce nom 
�&nbsp;mail-transport-agent&nbsp;�, mais il
n'existe aucun paquet nomm� �&nbsp;mail-transport-agent&nbsp;�.</para>
       </listitem>
   
       <listitem><para>
<literal>Single virtual packages</literal> est le nombre de paquets virtuels qui ne
peuvent �tre remplis que par un seul paquet. Par exemple, au sein du syst�me
Debian GNU/Linux, �&nbsp;X11-text-viewer&nbsp;� est un paquet virtuel&nbsp;; 
seul le paquet �&nbsp;xless&nbsp;� remplit �&nbsp;X11-text-viewer&nbsp;�.</para>
       </listitem>

       <listitem><para>
<literal>Mixed virtual packages</literal> est le nombre des paquets qui remplissent un
paquet virtuel particulier ou dont le nom est un nom de paquet virtuel.
Par exemple, au sein du syst�me Debian GNU/Linux, �&nbsp;debconf&nbsp;� est 
un paquet r�el et il est aussi fourni par �&nbsp;debconf-tiny&nbsp;�.
      </para> </listitem>
   
       <listitem><para>
<literal>Missing</literal> est le nombre de paquets r�f�renc�s dans une
d�pendance mais qui ne sont fournis par aucun paquet. Les paquets manquants
peuvent �tre mis en �vidence quand on n'acc�de pas � une distribution compl�te
ou si un paquet (r�el ou virtuel) a �t� sorti d'une distribution.
Habituellement on les trouve dans les champs �&nbsp;Conflicts&nbsp;�.
</para>       </listitem>

       <listitem><para>
<literal>Total distinct versions</literal> est le nombre de versions de paquets trouv�es
dans le cache&nbsp;; cette valeur est par cons�quent au moins �gale au 
nombre total de paquets. Quand on acc�de � plus d'une distribution 
(�&nbsp;stable&nbsp;� et �&nbsp;unstable&nbsp;�, par exemple), cette valeur 
peut �tre consid�rablement plus grande que le nombre total de paquets.
</para>       </listitem>

       <listitem><para>
<literal>Total dependencies</literal> est le nombre de relations de d�pendances 
d�clar�es par tous les paquets pr�sents dans le cache.
</para>       </listitem>
     </itemizedlist>
    </para>
	  </listitem>
</varlistentry>

     <varlistentry><term>showsrc <replaceable>paquet(s)</replaceable></term>
     <listitem><para>
     <literal>showsrc</literal> affiche toutes les entr�es de paquet source qui
correspondent aux noms donn�s. Toutes les versions sont affich�es et toutes
les entr�es qui d�clarent que ces noms correspondent � des paquets binaires.
</para>
	  </listitem>
</varlistentry>

     
     <varlistentry><term>dump</term>
     <listitem><para>
La commande <literal>dump</literal> affiche un court r�sum� sur chaque paquet du cache.
Elle est d'abord destin�e au d�bogage.</para>
	  </listitem>
     </varlistentry>

     <varlistentry><term>dumpavail</term>
     <listitem><para>
La commande <literal>dumpavail</literal> affiche sur la sortie standard une liste des
paquets disponibles. Elle convient � une utilisation avec &dpkg; et la
m�thode &dselect; s'en sert.</para>
	  </listitem>
     </varlistentry>

     <varlistentry><term>unmet</term>
     <listitem><para>
La commande <literal>unmet</literal> affiche un r�sum� concernant toutes les 
d�pendances absentes dans le cache de paquets.</para>
	  </listitem>
     </varlistentry>

     <varlistentry><term>show <replaceable>paquet(s)</replaceable></term>
     <listitem><para>
La commande <literal>show</literal> est semblable � 
<command>dpkg --print-avail</command>&nbsp;;
elle affiche des informations sur les paquets donn�s en argument.</para>
	  </listitem>
     </varlistentry>

     <varlistentry><term>search <replaceable>regex [ regex ... ]</replaceable></term>
     <listitem><para>
La commande <literal>search</literal> recherche l'expression r�guli�re donn�e en
argument sur tous les paquets disponibles. Elle cherche une occurrence de la 
cha�ne dans les noms de paquets et dans les descriptions puis elle affiche
le nom du paquet et sa description courte. Quand on donne l'option
<option>--full</option>, la sortie est identique � <literal>show</literal> pour chaque 
paquet&nbsp;; l'option <option>--names-only</option> ne recherche pas la cha�ne 
dans les descriptions longues mais seulement dans les noms de paquets.</para>
<para>
On peut utiliser des arguments distincts pour indiquer des expressions
r�guli�res diff�rentes sur lesquelles sera r�alis� un �&nbsp;et&nbsp;� logique.
</para>
	  </listitem>
</varlistentry>

     <varlistentry><term>depends <replaceable>paquet(s)</replaceable></term>
     <listitem><para>
La commande <literal>depends</literal> affiche la liste de toutes les d�pendances
d'un paquet et la liste de tous les paquets possibles qui satisfont ces
d�pendances.</para>
	  </listitem>
     </varlistentry>

     <varlistentry><term>rdepends <replaceable>paquet(s)</replaceable></term>
     <listitem><para>
La commande <literal>rdepends</literal> affiche la liste de toutes les d�pendances inverses
d'un paquet.</para>
	  </listitem>
      </varlistentry>

     <varlistentry><term>pkgnames <replaceable>[ prefix ]</replaceable></term>
     <listitem><para>
Cette commande affiche le nom de chaque paquet du syst�me. Un pr�fixe pour
filtrer la liste des noms peut �tre donn� en argument. La sortie est
appropri�e � une utilisation au sein d'une fonction compl�te de shell&nbsp;; 
elle est produite tr�s rapidement. On utilise au mieux cette commande avec
l'option <option>--generate</option>.</para>
	  </listitem>
     </varlistentry>
     
     <varlistentry><term>dotty <replaceable>paquet(s)</replaceable></term>
     <listitem><para>
La commande <literal>dotty</literal> prend une liste de paquets sur la ligne de commande
et affiche une sortie appropri�e � une utilisation par la commande dotty du 
paquet <ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphViz</ulink>.
Il en r�sulte un ensemble de noeuds et d'arcs repr�sentant les relations 
entre les paquets. Par d�faut les paquets donn�s en argument suivent toutes
leurs d�pendances, ce qui peut produire un graphe tr�s volumineux. 
Pour limiter la sortie aux seuls paquets list�s sur la ligne de commande, 
positionnez l'option <literal>APT::Cache::GivenOnly</literal>.
	      </para>
<para>
Les noeuds r�sultants ont plusieurs formes&nbsp;; les paquets normaux sont 
des bo�tes, les �&nbsp;provides&nbsp;� purs sont des triangles, 
les �&nbsp;provides&nbsp;� mixtes sont des diamants et les paquets manquants 
sont des hexagones. Les bo�tes oranges expriment un arr�t de la r�cursivit� 
[paquet feuille], les lignes bleues repr�sentent des pr�d�pendances et les 
lignes vertes repr�sentent des conflits.
	    </para>
     <para>
Attention, dotty ne peut pas repr�senter des ensembles tr�s grands de paquets.
   </para>
	  </listitem>
	</varlistentry>

     <varlistentry><term>policy <replaceable>[ paquet(s) ]</replaceable></term>
     <listitem><para>
     <literal>policy</literal> sert � d�boguer des probl�mes relatifs au fichier des
pr�f�rences. Sans argument, la commande affiche la priorit� de chaque source.
Sinon, elle affiche des informations pr�cises sur la priorit� du paquet donn�
en argument.</para>
	  </listitem>
     </varlistentry>

     <varlistentry><term>madison <replaceable>[ paquet(s) ]</replaceable></term>
     <listitem><para>

     La commande <literal>madison</literal> d'<literal>apt-cache</literal>
 cherche � mimer le
format de sortie propre � l'outil debian de gestion d'archives, 
<literal>madison</literal>, ainsi qu'une part de ses fonctionnalit�s. Elle affiche les
versions disponibles d'un paquet dans un tableau. Contrairement au programme
original <literal>madison</literal>, elle n'affiche que des informations concernant 
l'architecture pour laquelle Apt a lu la liste des paquets disponibles
(<literal>APT::Architecture</literal>).</para>
	  </listitem>
     </varlistentry>

  </variablelist>
 </refsect1>
 
 <refsect1><title>Options</title>
   &apt-cmdblurb;
   
   <variablelist>
     <varlistentry><term><option>-p</option></term><term><option>--pkg-cache</option></term>
     <listitem><para>
Indique le fichier servant de cache des paquets. Le cache des paquets est
le cache primaire utilis� par toutes les op�rations.
�l�ment de configuration&nbsp;: <literal>Dir::Cache::pkgcache</literal>.</para>
	</listitem>
     </varlistentry>

     <varlistentry><term><option>-s</option></term><term><option>--src-cache</option></term>
     <listitem><para>
Indique le fichier servant de cache des sources. Ce cache n'est utilis� que 
par <literal>gencaches</literal>&nbsp;; une version des informations sur les paquets,
faite � partir d'une analyse de sources distantes, est conserv�e. Quand le 
cache des paquets est cr��, le cache des sources est utilis� afin d'�viter 
d'analyser � nouveau tous les paquets.
�l�ment de configuration&nbsp;: <literal>Dir::Cache::srcpkgcache</literal>.</para>
	</listitem>
     </varlistentry>

     <varlistentry><term><option>-q</option></term><term><option>--quiet</option></term>
     <listitem><para>
Mode silencieux&nbsp;; produit une sortie pertinente pour l'enregistrement 
dans un fichier-journal, sans afficher d'indicateur de progression. Un plus 
grand nombre de q produira un plus grand silence, avec un maximum de 2. Vous 
pouvez aussi utiliser <option>-q=#</option> pour positionner le niveau de silence, 
annulant le fichier de configuration.
�l�ment de configuration&nbsp;: <literal>quiet</literal>.</para>
	</listitem>
     </varlistentry>

     <varlistentry><term><option>-i</option></term><term><option>--important</option></term>
     <listitem><para>
N'affiche que les d�pendances importantes&nbsp;; � utiliser avec la commande
unmet pour n'afficher que les relations Depends et Pre-Depends.
�l�ment de configuration&nbsp;: <literal>APT::Cache::Important</literal>.</para>
	</listitem>
     </varlistentry>

     <varlistentry><term><option>-f</option></term><term><option>--full</option></term>
     <listitem><para>
Affiche la totalit� des champs d'information sur le paquet lors d'une
recherche.
�l�ment de configuration&nbsp;: <literal>APT::Cache::ShowFull</literal>.</para>
	</listitem>
     </varlistentry>

     <varlistentry><term><option>-a</option></term><term><option>--all-versions</option></term>
     <listitem><para>
Affiche la totalit� des champs d'information pour toutes les versions
disponibles&nbsp;: c'est la valeur par d�faut. Pour la d�sactiver, utilisez
l'option <option>--no-all-versions</option>. Quand l'option <option>--no-all-versions</option>
est choisie, seuls les �l�ments de la version choisie (celle qui serait 
install�e) seront affich�s.
Cette option concerne seulement la commande <literal>show</literal>.
�l�ment de configuration&nbsp;: <literal>APT::Cache::AllVersions</literal>.</para>
	</listitem>
     </varlistentry>

     <varlistentry><term><option>-g</option></term><term><option>--generate</option></term>
     <listitem><para>
R�alise une mise � jour automatique du cache des paquets plut�t que de se
servir du cache actuel.
Pour d�sactiver cette option (option par d�faut), utilisez l'option
<option>--no-generate</option>.
�l�ment de configuration&nbsp;: <literal>APT::Cache::Generate</literal>.</para>
	</listitem>
     </varlistentry>

 <varlistentry><term><option>--names-only</option></term><term><option>-n</option></term>
     <listitem><para>
N'effectue une recherche que sur les noms de paquets et pas sur les
descriptions longues.
�l�ment de configuration&nbsp;: <literal>APT::Cache::NamesOnly</literal>.</para>
	</listitem>
     </varlistentry>

     <varlistentry><term><option>--all-names</option></term>
     <listitem><para>
Avec cette option <literal>pkgnames</literal> affiche tous les noms, les noms des
paquets virtuels et les d�pendances manquantes.
�l�ment de configuration&nbsp;: <literal>APT::Cache::AllNames</literal>.</para>
	</listitem>
     </varlistentry>

     <varlistentry><term><option>--recurse</option></term>
     <listitem><para>
Avec cette option <literal>depends</literal> et <literal>rdepends</literal> 
sont r�cursives de 
mani�re � n'afficher qu'une seule fois les paquets mentionn�s.
�l�ment de configuration&nbsp;: <literal>APT::Cache::RecurseDepends</literal>.</para>
	</listitem>
     </varlistentry>

     <varlistentry><term><option>--installed</option></term>
     <listitem><para>
Cette option limite la sortie de <literal>depends</literal> et de 
<literal>rdepends</literal> 
aux paquets qui sont actuellement install�s.
�l�ment de configuration&nbsp;: <literal>APT::Cache::Installed</literal>.</para>
	</listitem>
     </varlistentry>

     &apt-commonoptions;
     
   </variablelist>
 </refsect1>

 <refsect1><title>Fichiers</title>
   <variablelist>
     <varlistentry><term><filename>/etc/apt/sources.list</filename></term>
     <listitem><para>
Emplacements o� aller chercher les paquets.
�l�ment de configuration&nbsp;: <literal>Dir::Etc::SourceList</literal>.</para>
	</listitem>
     </varlistentry>
     
     <varlistentry><term><filename>&statedir;/lists/</filename></term>
     <listitem><para>
Zone de stockage pour les informations qui concernent chaque ressource de
paquet sp�cifi�e dans &sources-list;
�l�ment de configuration&nbsp;: <literal>Dir::State::Lists</literal>.</para>
	</listitem>
     </varlistentry>
  
     <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
     <listitem><para>
Zone de stockage pour les informations en transit.
�l�ment de configuration&nbsp;: <literal>Dir::State::Lists</literal> (partial est implicite).
</para>
	</listitem>
</varlistentry>     
   </variablelist>
 </refsect1>

 <refsect1><title>Voir aussi</title>
   <para>
   &apt-conf;, &sources-list;, &apt-get;.</para>
 </refsect1>

 <refsect1><title>Diagnostics</title>
   <para>
<command>apt-cache</command> retourne z�ro apr�s un d�roulement normal, et le nombre 
d�cimal 100 en cas d'erreur.</para>
 </refsect1>

 &manbugs;
 &deux-traducteurs;
</refentry>