<?xml version="1.0" encoding="iso-8859-15" standalone="no"?> <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ <!ENTITY % aptent SYSTEM "apt.ent.fr"> %aptent; ]> <refentry lang="fr"> <refentryinfo> &apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <!-- The last update date --> <date>29 F�vrier 2004</date> </refentryinfo> <refmeta> <refentrytitle>apt-cache</refentrytitle> <manvolnum>8</manvolnum> </refmeta> <!-- Man page title --> <refnamediv> <refname>apt-cache</refname> <refpurpose>Gestion des paquets et manipulation du cache par APT</refpurpose> </refnamediv> <!-- Arguments --> <refsynopsisdiv> <cmdsynopsis> <command>apt-cache</command> <arg><option>-hvsn</option></arg> <arg><option>-o=<replaceable>option de configuration</replaceable></option></arg> <arg><option>-c=<replaceable>fichier</replaceable></option></arg> <group choice="req"> <arg>add <arg choice="plain" rep="repeat"><replaceable>fichier</replaceable></arg></arg> <arg>gencaches</arg> <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> <arg>dump</arg> <arg>dumpavail</arg> <arg>unmet</arg> <arg>search <arg choice="plain"><replaceable>regex</replaceable></arg></arg> <arg>show <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> <arg>depends <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> <arg>rdepends <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> <arg>madison <arg choice="plain" rep="repeat"><replaceable>paquets</replaceable></arg></arg> </group> </cmdsynopsis> </refsynopsisdiv> <refsect1><title>Description</title> <para> <command>apt-cache</command> r�alise diff�rentes op�rations sur le cache de paquet d' APT. <command>apt-cache</command> 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> <para> � moins que l'option <option>-h</option> ou <option>--help</option> ne soit donn�e, l'une des commandes suivantes doit �tre pr�sente.</para> <variablelist> <varlistentry><term>add <replaceable>fichier(s)</replaceable></term> <listitem><para> La commande <literal>add</literal> ajoute des fichiers indexant des paquets au cache des paquets. Cela sert uniquement pour le d�bogage.</para> </listitem> </varlistentry> <varlistentry><term>gencaches</term> <listitem><para> La commande <literal>gencaches</literal> fait la m�me chose que <command>apt-get check</command>. 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</filename>.</para> </listitem> </varlistentry> <varlistentry><term>showpkg <replaceable>paquet(s)</replaceable></term> <listitem><para> La commande <literal>showpkg</literal> 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 ; 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</command> donnera ce r�sultat : </para> <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-12, d�pend de libc5, ncurses3.0 ; 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 et ncurses3.0 doivent �tre install�s ; 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.</para> </listitem> </varlistentry> <varlistentry><term>stats</term> <listitem><para> La commande <literal>stats</literal> affiche des statistiques � propos du cache. Aucun autre argument n'est attendu. Voici les informations rapport�es : <itemizedlist> <listitem><para> <literal>Total package names</literal> est le nombre de paquets trouv�s dans le cache. </para> </listitem> <listitem><para> <literal>Normal packages</literal> est le nombre de paquets simples, ordinaires ; 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.</para> </listitem> <listitem><para> <literal>Pure virtual packages</literal> est le nombre des paquets qui n'existent que sous la forme d'un nom repr�sentant un paquet virtuel ; ces paquets � fournissent � 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 � mail-transport-agent � est un paquet virtuel pur ; plusieurs paquets peuvent � remplir � ce nom � mail-transport-agent �, mais il n'existe aucun paquet nomm� � mail-transport-agent �.</para> </listitem> <listitem><para> <literal>Single virtual packages</literal> 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, � X11-text-viewer � est un paquet virtuel ; seul le paquet � xless � remplit � X11-text-viewer �.</para> </listitem> <listitem><para> <literal>Mixed virtual packages</literal> 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, � debconf � est un paquet r�el et il est aussi fourni par � debconf-tiny �. </para> </listitem> <listitem><para> <literal>Missing</literal> 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 � Conflicts �. </para> </listitem> <listitem><para> <literal>Total distinct versions</literal> est le nombre de versions de paquets trouv�es dans le cache ; cette valeur est par cons�quent au moins �gale au nombre total de paquets. Quand on acc�de � plus d'une distribution (� stable � et � unstable �, par exemple), cette valeur peut �tre consid�rablement plus grande que le nombre total de paquets. </para> </listitem> <listitem><para> <literal>Total dependencies</literal> est le nombre de relations de d�pendances d�clar�es par tous les paquets pr�sents dans le cache. </para> </listitem> </itemizedlist> </para> </listitem> </varlistentry> <varlistentry><term>showsrc <replaceable>paquet(s)</replaceable></term> <listitem><para> <literal>showsrc</literal> 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. </para> </listitem> </varlistentry> <varlistentry><term>dump</term> <listitem><para> La commande <literal>dump</literal> affiche un court r�sum� sur chaque paquet du cache. Elle est d'abord destin�e au d�bogage.</para> </listitem> </varlistentry> <varlistentry><term>dumpavail</term> <listitem><para> La commande <literal>dumpavail</literal> affiche sur la sortie standard une liste des paquets disponibles. Elle convient � une utilisation avec &dpkg; et la m�thode &dselect; s'en sert.</para> </listitem> </varlistentry> <varlistentry><term>unmet</term> <listitem><para> La commande <literal>unmet</literal> affiche un r�sum� concernant toutes les d�pendances absentes dans le cache de paquets.</para> </listitem> </varlistentry> <varlistentry><term>show <replaceable>paquet(s)</replaceable></term> <listitem><para> La commande <literal>show</literal> est semblable � <command>dpkg --print-avail</command> ; elle affiche des informations sur les paquets donn�s en argument.</para> </listitem> </varlistentry> <varlistentry><term>search <replaceable>regex [ regex ... ]</replaceable></term> <listitem><para> La commande <literal>search</literal> 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</option>, la sortie est identique � <literal>show</literal> pour chaque paquet ; l'option <option>--names-only</option> ne recherche pas la cha�ne dans les descriptions longues mais seulement dans les noms de paquets.</para> <para> On peut utiliser des arguments distincts pour indiquer des expressions r�guli�res diff�rentes sur lesquelles sera r�alis� un � et � logique. </para> </listitem> </varlistentry> <varlistentry><term>depends <replaceable>paquet(s)</replaceable></term> <listitem><para> La commande <literal>depends</literal> affiche la liste de toutes les d�pendances d'un paquet et la liste de tous les paquets possibles qui satisfont ces d�pendances.</para> </listitem> </varlistentry> <varlistentry><term>rdepends <replaceable>paquet(s)</replaceable></term> <listitem><para> La commande <literal>rdepends</literal> affiche la liste de toutes les d�pendances inverses d'un paquet.</para> </listitem> </varlistentry> <varlistentry><term>pkgnames <replaceable>[ prefix ]</replaceable></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 ; elle est produite tr�s rapidement. On utilise au mieux cette commande avec l'option <option>--generate</option>.</para> </listitem> </varlistentry> <varlistentry><term>dotty <replaceable>paquet(s)</replaceable></term> <listitem><para> La commande <literal>dotty</literal> prend une liste de paquets sur la ligne de commande et affiche une sortie appropri�e � une utilisation par la commande dotty du paquet <ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphViz</ulink>. 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. Pour limiter la sortie aux seuls paquets list�s sur la ligne de commande, positionnez l'option <literal>APT::Cache::GivenOnly</literal>. </para> <para> Les noeuds r�sultants ont plusieurs formes ; les paquets normaux sont des bo�tes, les � provides � purs sont des triangles, les � provides � 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 tr�s grands de paquets. </para> </listitem> </varlistentry> <varlistentry><term>policy <replaceable>[ paquet(s) ]</replaceable></term> <listitem><para> <literal>policy</literal> 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.</para> </listitem> </varlistentry> <varlistentry><term>madison <replaceable>[ paquet(s) ]</replaceable></term> <listitem><para> La commande <literal>madison</literal> d'<literal>apt-cache</literal> cherche � mimer le format de sortie propre � l'outil debian de gestion d'archives, <literal>madison</literal>, ainsi qu'une part de ses fonctionnalit�s. Elle affiche les versions disponibles d'un paquet dans un tableau. Contrairement au programme original <literal>madison</literal>, elle n'affiche que des informations concernant l'architecture pour laquelle Apt a lu la liste des paquets disponibles (<literal>APT::Architecture</literal>).</para> </listitem> </varlistentry> </variablelist> </refsect1> <refsect1><title>Options</title> &apt-cmdblurb; <variablelist> <varlistentry><term><option>-p</option></term><term><option>--pkg-cache</option></term> <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 : <literal>Dir::Cache::pkgcache</literal>.</para> </listitem> </varlistentry> <varlistentry><term><option>-s</option></term><term><option>--src-cache</option></term> <listitem><para> Indique le fichier servant de cache des sources. Ce cache n'est utilis� que par <literal>gencaches</literal> ; 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 : <literal>Dir::Cache::srcpkgcache</literal>.</para> </listitem> </varlistentry> <varlistentry><term><option>-q</option></term><term><option>--quiet</option></term> <listitem><para> Mode silencieux ; 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=#</option> pour positionner le niveau de silence, annulant le fichier de configuration. �l�ment de configuration : <literal>quiet</literal>.</para> </listitem> </varlistentry> <varlistentry><term><option>-i</option></term><term><option>--important</option></term> <listitem><para> N'affiche que les d�pendances importantes ; � utiliser avec la commande unmet pour n'afficher que les relations Depends et Pre-Depends. �l�ment de configuration : <literal>APT::Cache::Important</literal>.</para> </listitem> </varlistentry> <varlistentry><term><option>-f</option></term><term><option>--full</option></term> <listitem><para> Affiche la totalit� des champs d'information sur le paquet lors d'une recherche. �l�ment de configuration : <literal>APT::Cache::ShowFull</literal>.</para> </listitem> </varlistentry> <varlistentry><term><option>-a</option></term><term><option>--all-versions</option></term> <listitem><para> Affiche la totalit� des champs d'information pour toutes les versions disponibles : c'est la valeur par d�faut. Pour la d�sactiver, utilisez l'option <option>--no-all-versions</option>. Quand l'option <option>--no-all-versions</option> est choisie, seuls les �l�ments de la version choisie (celle qui serait install�e) seront affich�s. Cette option concerne seulement la commande <literal>show</literal>. �l�ment de configuration : <literal>APT::Cache::AllVersions</literal>.</para> </listitem> </varlistentry> <varlistentry><term><option>-g</option></term><term><option>--generate</option></term> <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), utilisez l'option <option>--no-generate</option>. �l�ment de configuration : <literal>APT::Cache::Generate</literal>.</para> </listitem> </varlistentry> <varlistentry><term><option>--names-only</option></term><term><option>-n</option></term> <listitem><para> N'effectue une recherche que sur les noms de paquets et pas sur les descriptions longues. �l�ment de configuration : <literal>APT::Cache::NamesOnly</literal>.</para> </listitem> </varlistentry> <varlistentry><term><option>--all-names</option></term> <listitem><para> Avec cette option <literal>pkgnames</literal> affiche tous les noms, les noms des paquets virtuels et les d�pendances manquantes. �l�ment de configuration : <literal>APT::Cache::AllNames</literal>.</para> </listitem> </varlistentry> <varlistentry><term><option>--recurse</option></term> <listitem><para> Avec cette option <literal>depends</literal> et <literal>rdepends</literal> sont r�cursives de mani�re � n'afficher qu'une seule fois les paquets mentionn�s. �l�ment de configuration : <literal>APT::Cache::RecurseDepends</literal>.</para> </listitem> </varlistentry> <varlistentry><term><option>--installed</option></term> <listitem><para> Cette option limite la sortie de <literal>depends</literal> et de <literal>rdepends</literal> aux paquets qui sont actuellement install�s. �l�ment de configuration : <literal>APT::Cache::Installed</literal>.</para> </listitem> </varlistentry> &apt-commonoptions; </variablelist> </refsect1> <refsect1><title>Fichiers</title> <variablelist> <varlistentry><term><filename>/etc/apt/sources.list</filename></term> <listitem><para> Emplacements o� aller chercher les paquets. �l�ment de configuration : <literal>Dir::Etc::SourceList</literal>.</para> </listitem> </varlistentry> <varlistentry><term><filename>&statedir;/lists/</filename></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 : <literal>Dir::State::Lists</literal>.</para> </listitem> </varlistentry> <varlistentry><term><filename>&statedir;/lists/partial/</filename></term> <listitem><para> Zone de stockage pour les informations en transit. �l�ment de configuration : <literal>Dir::State::Lists</literal> (partial est implicite). </para> </listitem> </varlistentry> </variablelist> </refsect1> <refsect1><title>Voir aussi</title> <para> &apt-conf;, &sources-list;, &apt-get;.</para> </refsect1> <refsect1><title>Diagnostics</title> <para> <command>apt-cache</command> retourne z�ro apr�s un d�roulement normal, et le nombre d�cimal 100 en cas d'erreur.</para> </refsect1> &manbugs; &deux-traducteurs; </refentry>