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

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