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

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