<!-- -*- mode: sgml; mode: fold -*- -->
<!-- translation of version 1.10 -->
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [

<!ENTITY % aptent SYSTEM "apt.ent.fr">
%aptent;

]>

<refentry lang=fr>
 &apt-docinfo;
 
 <refmeta>
   <refentrytitle>apt-cache</>
   <manvolnum>8</>
 </refmeta>
 
 <!-- Man page title -->
 <refnamediv>
    <refname>apt-cache</>
    <refpurpose>Gestion des paquets et manipulation du cache par APT</>
 </refnamediv>

 <!-- Arguments -->
 <refsynopsisdiv>
   <cmdsynopsis>
      <command>apt-cache</>
      <arg><option>-hvs</></arg>
      <arg><option>-o=<replaceable/option de configuration/</></arg>
      <arg><option>-c=<replaceable/fichier/</></arg>
      <group choice=req>
         <arg>add <arg choice="plain" rep="repeat"><replaceable>fichier</replaceable></arg></arg>
         <arg>gencaches</>
         <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>dump</>
         <arg>dumpavail</>
         <arg>unmet</>
         <arg>search <arg choice="plain"><replaceable>regex</replaceable></arg></arg>
         <arg>show <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>depends <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>
      </group>   
   </cmdsynopsis>
 </refsynopsisdiv>
 
 <RefSect1><Title>Description</>
   <para>
<command/apt-cache/ r�alise diff�rentes op�rations sur le cache de paquet d' 
APT. <command/apt-cache/ 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>
� moins que l'option <option>-h</> ou <option>--help</> ne soit donn�e, l'une 
des commandes suivantes doit �tre pr�sente.

   <VariableList>
     <VarListEntry><Term>add</Term>
     <ListItem><Para>
La commande <literal/add/ ajoute des fichiers indexant des paquets au cache des
paquets. Cela sert uniquement pour le d�bogage.
     </VarListEntry>
     
     <VarListEntry><Term>gencaches</Term>
     <ListItem><Para>
La commande <literal/gencaches/ fait la m�me chose que 
<command/apt-get check/. 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</>.
     </VarListEntry>

     <VarListEntry><Term>showpkg</Term>
     <ListItem><Para>
La commande <literal/showpkg/ 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</> donnerait ce r�sultat&nbsp;:
     
<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-8, d�pend de libc5, ncurses3.0, et 
ldso&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, ncurses3.0 et 
ldso 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.
     </VarListEntry>

     <VarListEntry><Term>stats</Term>
     <ListItem><Para>
La commande <literal/stats/ 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/ est le nombre de paquets trouv�s dans le cache.
       </listitem>
       
       <listitem><para>
<literal/Normal packages/ 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.
       </listitem>

       <listitem><para>
<literal/Pure virtual packages/ 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;�.
       </listitem>
   
       <listitem><para>
<literal/Single virtual packages/ 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;�.
       </listitem>

       <listitem><para>
<literal/Mixed virtual packages/ 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 rempli par �&nbsp;debconf-tiny&nbsp;�.
       </listitem>
   
       <listitem><para>
<literal/Missing/ 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;�.
       </listitem>

       <listitem><para>
<literal/Total distinct/ versions 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.
       </listitem>

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

     <VarListEntry><Term>showsrc</Term>
     <ListItem><Para>
     <literal/showsrc/ 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.
     </VarListEntry>

     
     <VarListEntry><Term>dump</Term>
     <ListItem><Para>
La commande <literal/dump/ affiche un court r�sum� sur chaque paquet du cache.
Elle est d'abord destin�e au d�bogage.
     </VarListEntry>

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

     <VarListEntry><Term>unmet</Term>
     <ListItem><Para>
La commande <literal/unmet/ affiche un r�sum� concernant toutes les 
d�pendances absentes dans le cache de paquets.
     </VarListEntry>

     <VarListEntry><Term>show</Term>
     <ListItem><Para>
La commande <literal/show/ est semblable � <literal/dpkg --print-avail/&nbsp;; 
elle affiche des informations sur les paquets donn�s en argument.
     </VarListEntry>

     <VarListEntry><Term>search</Term>
     <ListItem><Para>
La commande <literal/search/ 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/, la sortie est identique � <literal/show/ pour chaque 
paquet&nbsp;; l'option <option/--names-only/ ne recherche pas la cha�ne 
dans les descriptions longues mais seulement dans les noms de paquets.
<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.
     </VarListEntry>

     <VarListEntry><Term>depends</Term>
     <ListItem><Para>
La commande <literal/depends/ affiche la liste de toutes les d�pendances
d'un paquet et la liste de tous les paquets possibles qui satisfont ces
d�pendances.
     </VarListEntry>

     <VarListEntry><Term>pkgnames</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/.
     </VarListEntry>
     
     <VarListEntry><Term>dotty</Term>
     <ListItem><Para>
La commande <literal/dotty/ prend une liste de paquets sur la ligne de commande
et affiche une sortie appropri�e � une utilisation par dotty avec le paquet
<ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphViz</>.
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. On peut
d�sactiver ce comportement en  positionnant 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 de paquets
plus volumineux.
     </VarListEntry>

     <VarListEntry><Term>policy</Term>
     <ListItem><Para>
     <literal/policy/ 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.
     </VarListEntry>
 
  </VariableList>
 </RefSect1>
 
 <RefSect1><Title>Options</>
   &apt-cmdblurb;
   
   <VariableList>
     <VarListEntry><term><option/-p/</><term><option/--pkg-cache/</>
     <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/.
     </VarListEntry>

     <VarListEntry><term><option/-s/</><term><option/--src-cache/</>
     <ListItem><Para>
Indique le fichier servant de cache des sources. Ce cache n'est utilis� que 
par <literal/gencaches/&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/.
     </VarListEntry>

     <VarListEntry><term><option/-q/</><term><option/--quiet/</>
     <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=#/ pour positionner le niveau de silence, 
annulant le fichier de configuration.
�l�ment de configuration&nbsp;: <literal/quiet/.
     </VarListEntry>

     <VarListEntry><term><option/-i/</><term><option/--important/</>
     <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/.
     </VarListEntry>

     <VarListEntry><term><option/-f/</><term><option/--full/</>
     <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/.
     </VarListEntry>

     <VarListEntry><term><option/-a/</><term><option/--all-versions/</>
     <ListItem><Para>
Affiche la totalit� des champs d'information pour toutes les versions
disponibles&nbsp;: cette option concerne seulement la commande show.
�l�ment de configuration&nbsp;: <literal/APT::Cache::AllVersions/.
     </VarListEntry>

     <VarListEntry><term><option/-g/</><term><option/--generate/</>
     <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), utiliser l'option
<option/--no-generate/.
�l�ment de configuration&nbsp;: <literal/APT::Cache::Generate/.
     </VarListEntry>

     <VarListEntry><term><option/--names-only/</>
     <ListItem><Para>
N'effectue une recherche que sur les noms de paquets et non sur les
descriptions longues.
�l�ment de configuration&nbsp;: <literal/APT::Cache::NamesOnly/.
     </VarListEntry>

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

     <VarListEntry><term><option/--recurse/</>
     <ListItem><Para>
Avec cette option <literal/depends/ est r�cursive de mani�re � n'afficher 
qu'une seule fois les paquets mentionn�s.
�l�ment de configuration&nbsp;: <literal/APT::Cache::RecurseDepends/.
     </VarListEntry>

     &apt-commonoptions;
     
   </VariableList>
 </RefSect1>

 <RefSect1><Title>Fichiers</>
   <variablelist>
     <VarListEntry><term><filename>/etc/apt/sources.list</></term>
     <ListItem><Para>
Emplacements o� aller chercher les paquets.
�l�ment de configuration&nbsp;: <literal/Dir::Etc::SourceList/.
     </VarListEntry>
     
     <VarListEntry><term><filename>&statedir;/lists/</></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/.
     </VarListEntry>
  
     <VarListEntry><term><filename>&statedir;/lists/partial/</></term>
     <ListItem><Para>
Zone de stockage pour les informations en transit.
�l�ment de configuration&nbsp;: <literal/Dir::State::Lists/ (partial est implicite).
     </VarListEntry>     
   </variablelist>
 </RefSect1>

 <RefSect1><Title>Voir aussi</>
   <para>
   &apt-conf;, &sources-list;, &apt-get;
 </RefSect1>

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

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