doc/fr/apt-cache.fr.8.sgml

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