doc/fr/apt-cache.8.fr.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-cache</>
  15    <manvolnum>8</>
  16  </refmeta>
  17
  18  <!-- Man page title -->
  19  <refnamediv>
  20     <refname>apt-cache</>
  21     <refpurpose>Gestion des paquets et manipulation du cache par APT</>
  22  </refnamediv>
  23
  24  <!-- Arguments -->
  25  <refsynopsisdiv>
  26    <cmdsynopsis>
  27       <command>apt-cache</>
  28       <arg><option>-hvs</></arg>
  29       <arg><option>-o=<replaceable/option de configuration/</></arg>
  30       <arg><option>-c=<replaceable/fichier/</></arg>
  31       <group choice=req>
  32          <arg>add <arg choice="plain" rep="repeat"><replaceable>fichier</replaceable></arg></arg>
  33          <arg>gencaches</>
  34          <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
  35          <arg>stats</>
  36          <arg>dump</>
  37          <arg>dumpavail</>
  38          <arg>unmet</>
  39          <arg>search <arg choice="plain"><replaceable>regex</replaceable></arg></arg>
  40          <arg>show <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
  41          <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
  42          <arg>depends <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
  43          <arg>pkgnames <arg choice="plain"><replaceable>prefix</replaceable></arg></arg>
  44          <arg>dotty <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
  45       </group>
  46    </cmdsynopsis>
  47  </refsynopsisdiv>
  48
  49  <RefSect1><Title>Description</>
  50    <para>
  51 <command/apt-cache/ réalise différentes opérations sur le cache de paquet d'
  52 APT. <command/apt-cache/ ne manipule pas l'état du système mais fournit des
  53 moyens de recherche dans les métadonnées d'un paquet desquelles il extrait
  54 d'intéressantes informations.
  55
  56    <para>
  57 À moins que l'option <option>-h</> ou <option>--help</> ne soit donnée, l'une
  58 des commandes suivantes doit être présente.
  59
  60    <VariableList>
  61      <VarListEntry><Term>add</Term>
  62      <ListItem><Para>
  63 La commande <literal/add/ ajoute les fichiers donnés en argument au cache des
  64 paquets.
  65      </VarListEntry>
  66
  67      <VarListEntry><Term>gencaches</Term>
  68      <ListItem><Para>
  69 La commande <literal/gencaches/ fait la même chose que
  70 <command/apt-get check/. Elle construit les caches de source et de paquet à
  71 partir des sources répertoriées dans &sources-list; et dans
  72 <filename>/var/lib/dpkg/status</>.
  73      </VarListEntry>
  74
  75      <VarListEntry><Term>showpkg</Term>
  76      <ListItem><Para>
  77 La commande <literal/showpkg/ affiche des informations sur les paquets donnés
  78 en argument. Les arguments restants sont les noms de paquets. Les versions
  79 disponibles et les dépendances inverses de chaque paquet répertorié sont
  80 listées, ainsi que les dépendances normales pour chaque version. Les dépendances
  81 normales d'un paquet sont constituées par les paquets dont il dépend&thinsp;; les
  82 dépendances inverses sont les paquets qui dépendent du paquet en question.
  83 Les dépendances normales doivent donc être satisfaites et les dépendances
  84 inverses n'ont pas besoin de l'être. Ainsi, la commande
  85 <command>apt-cache showpkg libreadline2</> donnerait ce résultat&nbsp;:
  86
  87 <informalexample><programlisting>
  88 Package: libreadline2
  89 Versions: 2.1-12(/var/state/apt/lists/foo_Packages),
  90 Reverse Depends:
  91   libreadlineg2,libreadline2
  92   libreadline2-altdev,libreadline2
  93 Dependencies:
  94 2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
  95 Provides:
  96 2.1-12 -
  97 Reverse Provides:
  98 </programlisting></informalexample>
  99
 100      <para>
 101 On peut voir que libreadline2, version 2.1-8, dépend de libc5, ncurses3.0, et
 102 ldso&thinsp;; ces paquets doivent être installés au préalable pour que libreadline2
 103 fonctionne. À leur tour, libreadlineg2 et libreadline2-altdev dépendent de
 104 libreadline2. Si libreadline2 est installé, libc5, ncurses3.0 et ldso doivent
 105 être installés&thinsp;; 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
 106 source d'APT.
 107      </VarListEntry>
 108
 109      <VarListEntry><Term>stats</Term>
 110      <ListItem><Para>
 111 La commande <literal/stats/ affiche des statistiques à propos du cache. Aucun
 112 autre argument n'est attendu. Voici les informations rapportées&nbsp;:
 113      <itemizedlist>
 114        <listitem><para>
 115 <literal/Total package names/ est le nombre de paquets trouvés dans le cache.
 116        </listitem>
 117
 118        <listitem><para>
 119 <literal/Normal packages/ est le nombre de paquets simples, ordinaires&thinsp;; ces
 120 paquets tolèrent une correspondance bijective entre leur nom et le nom utilisé
 121 par d'autres paquets pour les qualifier comme dépendance. La majorité des
 122 paquets appartient à cette catégorie.
 123        </listitem>
 124
 125        <listitem><para>
 126 <literal/Pure virtual packages/ est le nombre des paquets qui n'existent que
 127 sous la forme d'un nom représentant un paquet virtuel&thinsp;; ces paquets
 128 «&nbsp;fournissent&nbsp;» seulement un nom de paquet virtuel et aucun paquet
 129 n'utilise véritablement ce nom. Par exemple, au sein du système Debian
 130 GNU-Linux, le nom «&nbsp;mail-transport-agent&nbsp;» est un paquet virtuel pur&thinsp;;
 131 plusieurs paquets peuvent «&nbsp;remplir&nbsp;» ce nom «&nbsp;mail-transport-agent&nbsp;», mais il
 132 n'existe aucun paquet nommé «&nbsp;mail-transport-agent&nbsp;».
 133        </listitem>
 134
 135        <listitem><para>
 136 <literal/Single virtual packages/ est le nombre de paquets virtuels qui ne
 137 peuvent être remplis que par un seul paquet. Par exemple, au sein du système
 138 Debian GNU-Linux, «&nbsp;X11-text-viewer&nbsp;» est un paquet virtuel&thinsp;; seul le paquet
 139 «&nbsp;xless&nbsp;» remplit «&nbsp;X11-text-viewer&nbsp;».
 140        </listitem>
 141
 142        <listitem><para>
 143 <literal/Mixed virtual packages/ est le nombre des paquets qui remplissent un
 144 paquet virtuel particulier et/ou dont le nom est un nom de paquet virtuel.
 145 Par exemple, au sein du système Debian GNU-Linux, «&nbsp;debconf&nbsp;» est
 146 un paquet réel et il est aussi rempli par «&nbsp;debconf-tiny&nbsp;».
 147        </listitem>
 148
 149        <listitem><para>
 150 <literal/Missing/ est le nombre de paquets référencés dans une
 151 dépendance mais qui ne sont fournis par aucun paquet. Les paquets manquants
 152 peuvent être mis en évidence quand on n'accède pas à une distribution complète
 153 ou si un paquet (réel ou virtuel) a été abandonné par une distribution.
 154 Habituellement on les trouve dans les champs «&nbsp;Conflicts&nbsp;».
 155        </listitem>
 156
 157        <listitem><para>
 158 <literal/Total distinct/ versions est le nombre de versions de paquets trouvées
 159 dans le cache&thinsp;; cette valeur est par conséquent au moins égale au nombre total
 160 de paquets. Quand on accède à plus d'une distribution («&nbsp;stable&nbsp;» et
 161 «&nbsp;unstable&nbsp;», par exemple), cette valeur peut être considérablement plus
 162 grande que le nombre total de paquets.
 163        </listitem>
 164
 165        <listitem><para>
 166 <literal/Total dependencies/ est le nombre de relations de dépendances
 167 déclarées par tous les paquets présents dans le cache.
 168        </listitem>
 169      </itemizedlist>
 170      </VarListEntry>
 171
 172      <VarListEntry><Term>dump</Term>
 173      <ListItem><Para>
 174 La commande <literal/dump/ affiche un court résumé sur chaque paquet du cache.
 175 Elle est d'abord destinée au débogage.
 176      </VarListEntry>
 177
 178      <VarListEntry><Term>dumpavail</Term>
 179      <ListItem><Para>
 180 La commande <literal/dumpavail/ affiche sur la sortie standard une liste des
 181 paquets disponibles. Elle convient à une utilisation avec &dpkg; et la
 182 méthode &dselect; s'en sert.
 183      </VarListEntry>
 184
 185      <VarListEntry><Term>unmet</Term>
 186      <ListItem><Para>
 187 La commande <literal/unmet/ affiche un résumé concernant toutes les
 188 dépendances absentes dans le cache de paquets.
 189      </VarListEntry>
 190
 191      <VarListEntry><Term>show</Term>
 192      <ListItem><Para>
 193 La commande <literal/show/ est semblable à <literal/dpkg --print-avail/&thinsp;;
 194 elle affiche des informations sur les paquets donnés en argument.
 195      </VarListEntry>
 196
 197      <VarListEntry><Term>search</Term>
 198      <ListItem><Para>
 199 La commande <literal/search/ recherche l'expression régulière donnée en
 200 argument sur tous les paquets disponibles. Elle cherche une occurrence de la
 201 chaîne dans les noms de paquets et dans les descriptions puis elle affiche
 202 le nom du paquet et sa description courte. Quand on donne l'option
 203 <option/--full/, la sortie est identique à <literal/show/ pour chaque
 204 paquet&thinsp;; l'option <option/--names-only/ ne recherche pas la chaîne
 205 dans les descriptions longues mais seulement dans les noms de paquets.
 206 <para>
 207 On peut utiliser des arguments distincts pour indiquer des expressions
 208 régulières différentes sur lesquelles sera réalisé un «&nbsp;et&nbsp;» logique.
 209      </VarListEntry>
 210
 211      <VarListEntry><Term>depends</Term>
 212      <ListItem><Para>
 213 La commande <literal/depends/ affiche la liste de toutes les dépendances
 214 d'un paquet et la liste de tous les paquets possibles qui satisfont ces
 215 dépendances.
 216      </VarListEntry>
 217
 218      <VarListEntry><Term>pkgnames</Term>
 219      <ListItem><Para>
 220 Cette commande affiche le nom de chaque paquet du système. Un préfixe pour
 221 filtrer la liste des noms peut être donné en argument. La sortie est
 222 appropriée à une utilisation au sein d'une fonction complète de shell&thinsp;; elle
 223 est produite très rapidement. On utilise au mieux cette commande avec
 224 l'option <option/--generate/.
 225      </VarListEntry>
 226
 227      <VarListEntry><Term>dotty</Term>
 228      <ListItem><Para>
 229 La commande <literal/dotty/ prend une liste de paquets sur la ligne de commande
 230 et affiche une sortie appropriée à une utilisation par dotty avec le paquet
 231 <ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphVis</>.
 232 Il en résulte un ensemble de noeuds et d'arcs représentant les relations
 233 entre les paquets. Par défaut les paquets donnés en argument suivent toutes
 234 leurs dépendances, ce qui peut produire un graphe très volumineux. On peut
 235 désactiver ce comportement en  positionnant l'option
 236 <literal>APT::Cache::GivenOnly</literal>.
 237               </para>
 238 <para>
 239 Les noeuds résultants ont plusieurs formes&thinsp;; les paquets normaux sont
 240 des boîtes, les «&nbsp;provides&nbsp;» purs sont des triangles,
 241 les «&nbsp;provides&nbsp;» mixtes sont des diamants et les paquets manquants
 242 sont des hexagones. Les boîtes oranges expriment un arrêt de la récursivité
 243 [paquet feuille], les lignes bleues représentent des prédépendances et les
 244 lignes vertes représentent des conflits.
 245             </para>
 246      <para>
 247 Attention, dotty ne peut pas représenter des ensembles de paquets
 248 plus volumineux.
 249      </VarListEntry>
 250    </VariableList>
 251  </RefSect1>
 252
 253  <RefSect1><Title>Options</>
 254    &apt-cmdblurb;
 255
 256    <VariableList>
 257      <VarListEntry><term><option/-p/</><term><option/--pkg-cache/</>
 258      <ListItem><Para>
 259 Indique le fichier servant de cache des paquets. Le cache des paquets est
 260 le cache primaire utilisé par toutes les opérations.
 261 Élément de configuration&nbsp;: <literal/Dir::Cache::pkgcache/.
 262      </VarListEntry>
 263
 264      <VarListEntry><term><option/-s/</><term><option/--src-cache/</>
 265      <ListItem><Para>
 266 Indique le fichier servant de cache des sources. Ce cache n'est utilisé que
 267 par <literal/gencaches/&thinsp;; une version des informations sur les paquets,
 268 faite à partir d'une analyse de sources distantes, est conservée. Quand le
 269 cache des paquets est crée, le cache de sources est utilisé afin d'éviter
 270 d'analyser à nouveau tous les paquets.
 271 Élément de configuration&nbsp;: <literal/Dir::Cache::srcpkgcache/.
 272      </VarListEntry>
 273
 274      <VarListEntry><term><option/-q/</><term><option/--quiet/</>
 275      <ListItem><Para>
 276 Mode silencieux&thinsp;; produit une sortie pertinente pour l'enregistrement dans un
 277 fichier journal, sans afficher d'indicateur de progression. Un plus grand
 278 nombre de q produira un plus grand silence, avec un maximum de 2. Vous pouvez
 279 aussi utiliser <option/-q=#/ pour positionner le niveau de silence, annulant
 280 le fichier de configuration.
 281 Élément de configuration&nbsp;: <literal/quiet/.
 282      </VarListEntry>
 283
 284      <VarListEntry><term><option/-i/</><term><option/--important/</>
 285      <ListItem><Para>
 286 N'affiche que les dépendances importantes&thinsp;; à utiliser avec la commande
 287 unmet pour n'afficher que les relations Depends et Pre-Depends.
 288 Élément de configuration&nbsp;: <literal/APT::Cache::Important/.
 289      </VarListEntry>
 290
 291      <VarListEntry><term><option/-f/</><term><option/--full/</>
 292      <ListItem><Para>
 293 Affiche la totalité des champs d'information sur le paquet lors d'une
 294 recherche.
 295 Élément de configuration&nbsp;: <literal/APT::Cache::ShowFull/.
 296      </VarListEntry>
 297
 298      <VarListEntry><term><option/-a/</><term><option/--all-versions/</>
 299      <ListItem><Para>
 300 Affiche la totalité des champs d'information pour toutes les versions
 301 disponibles&nbsp;: cette option concerne seulement la commande show.
 302 Élément de configuration&nbsp;: <literal/APT::Cache::AllVersions/.
 303      </VarListEntry>
 304
 305      <VarListEntry><term><option/-g/</><term><option/--generate/</>
 306      <ListItem><Para>
 307 Réalise une mise à jour automatique du cache des paquets plutôt que de se
 308 servir du cache actuel.
 309 Pour désactiver cette option (option par défaut), utiliser l'option
 310 <option/--no-generate/.
 311 Élément de configuration&nbsp;: <literal/APT::Cache::Generate/.
 312      </VarListEntry>
 313
 314      <VarListEntry><term><option/--names-only/</>
 315      <ListItem><Para>
 316 N'effectue une recherche que sur les noms de paquets et non sur les
 317 descriptions longues.
 318 Élément de configuration&nbsp;: <literal/APT::Cache::NamesOnly/.
 319      </VarListEntry>
 320
 321      <VarListEntry><term><option/--all-names/</>
 322      <ListItem><Para>
 323 Avec cette option <literal/pkgnames/ affiche tous les noms, les noms des
 324 paquets virtuels et les dépendances manquantes.
 325 Élément de configuration&nbsp;: <literal/APT::Cache::AllNames/.
 326      </VarListEntry>
 327
 328      <VarListEntry><term><option/--recurse/</>
 329      <ListItem><Para>
 330 Avec cette option <literal/depends/ est récursive de manière à n'afficher
 331 qu'une seule fois les paquets mentionnés.
 332 Élément de configuration&nbsp;: <literal/APT::Cache::RecurseDepends/.
 333      </VarListEntry>
 334
 335      &apt-commonoptions;
 336
 337    </VariableList>
 338  </RefSect1>
 339
 340  <RefSect1><Title>Fichiers</>
 341    <variablelist>
 342      <VarListEntry><term><filename>/etc/apt/sources.list</></term>
 343      <ListItem><Para>
 344 Emplacements où aller chercher les paquets.
 345 Élément de configuration&nbsp;: <literal/Dir::Etc::SourceList/.
 346      </VarListEntry>
 347
 348      <VarListEntry><term><filename>&statedir;/lists/</></term>
 349      <ListItem><Para>
 350 Zone de stockage pour les informations qui concernent chaque ressource de
 351 paquet spécifiée dans &sources-list;
 352 Élément de configuration&nbsp;: <literal/Dir::State::Lists/.
 353      </VarListEntry>
 354
 355      <VarListEntry><term><filename>&statedir;/lists/partial/</></term>
 356      <ListItem><Para>
 357 Zone de stockage pour les informations en transit.
 358 Élément de configuration&nbsp;: <literal/Dir::State::Lists/ (partial est implicite).
 359      </VarListEntry>
 360    </variablelist>
 361  </RefSect1>
 362
 363  <RefSect1><Title>Voir aussi</>
 364    <para>
 365    &apt-conf;, &sources-list;, &apt-get;
 366  </RefSect1>
 367
 368  <RefSect1><Title>Diagnostics</>
 369    <para>
 370 <command/apt-cache/ retourne zéro après un déroulement normal, et le nombre
 371 décimal 100 en cas d'erreur.
 372  </RefSect1>
 373
 374  &manbugs;
 375  &manauthor;
 376  &deux-traducteurs;
 377 </refentry>