<!-- -*- mode: sgml; mode: fold -*- --> <!-- translation of version 1.10 --> <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ <!ENTITY % aptent SYSTEM "apt.ent.fr"> %aptent; ]> <refentry lang=fr> &apt-docinfo; <refmeta> <refentrytitle>apt-cache</> <manvolnum>8</> </refmeta> <!-- Man page title --> <refnamediv> <refname>apt-cache</> <refpurpose>Gestion des paquets et manipulation du cache par APT</> </refnamediv> <!-- Arguments --> <refsynopsisdiv> <cmdsynopsis> <command>apt-cache</> <arg><option>-hvs</></arg> <arg><option>-o=<replaceable/option de configuration/</></arg> <arg><option>-c=<replaceable/fichier/</></arg> <group choice=req> <arg>add <arg choice="plain" rep="repeat"><replaceable>fichier</replaceable></arg></arg> <arg>gencaches</> <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>dump</> <arg>dumpavail</> <arg>unmet</> <arg>search <arg choice="plain"><replaceable>regex</replaceable></arg></arg> <arg>show <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> <arg>depends <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> </group> </cmdsynopsis> </refsynopsisdiv> <RefSect1><Title>Description</> <para> <command/apt-cache/ r�alise diff�rentes op�rations sur le cache de paquet d' APT. <command/apt-cache/ 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> � moins que l'option <option>-h</> ou <option>--help</> ne soit donn�e, l'une des commandes suivantes doit �tre pr�sente. <VariableList> <VarListEntry><Term>add</Term> <ListItem><Para> La commande <literal/add/ ajoute des fichiers indexant des paquets au cache des paquets. Cela sert uniquement pour le d�bogage. </VarListEntry> <VarListEntry><Term>gencaches</Term> <ListItem><Para> La commande <literal/gencaches/ fait la m�me chose que <command/apt-get check/. 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</>. </VarListEntry> <VarListEntry><Term>showpkg</Term> <ListItem><Para> La commande <literal/showpkg/ 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</> donnerait ce r�sultat : <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-8, d�pend de libc5, ncurses3.0, et ldso ; 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, ncurses3.0 et ldso 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. </VarListEntry> <VarListEntry><Term>stats</Term> <ListItem><Para> La commande <literal/stats/ affiche des statistiques � propos du cache. Aucun autre argument n'est attendu. Voici les informations rapport�es : <itemizedlist> <listitem><para> <literal/Total package names/ est le nombre de paquets trouv�s dans le cache. </listitem> <listitem><para> <literal/Normal packages/ 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. </listitem> <listitem><para> <literal/Pure virtual packages/ 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 �. </listitem> <listitem><para> <literal/Single virtual packages/ 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 �. </listitem> <listitem><para> <literal/Mixed virtual packages/ 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 rempli par � debconf-tiny �. </listitem> <listitem><para> <literal/Missing/ 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 �. </listitem> <listitem><para> <literal/Total distinct/ versions 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. </listitem> <listitem><para> <literal/Total dependencies/ est le nombre de relations de d�pendances d�clar�es par tous les paquets pr�sents dans le cache. </listitem> </itemizedlist> </VarListEntry> <VarListEntry><Term>showsrc</Term> <ListItem><Para> <literal/showsrc/ 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. </VarListEntry> <VarListEntry><Term>dump</Term> <ListItem><Para> La commande <literal/dump/ affiche un court r�sum� sur chaque paquet du cache. Elle est d'abord destin�e au d�bogage. </VarListEntry> <VarListEntry><Term>dumpavail</Term> <ListItem><Para> La commande <literal/dumpavail/ affiche sur la sortie standard une liste des paquets disponibles. Elle convient � une utilisation avec &dpkg; et la m�thode &dselect; s'en sert. </VarListEntry> <VarListEntry><Term>unmet</Term> <ListItem><Para> La commande <literal/unmet/ affiche un r�sum� concernant toutes les d�pendances absentes dans le cache de paquets. </VarListEntry> <VarListEntry><Term>show</Term> <ListItem><Para> La commande <literal/show/ est semblable � <literal/dpkg --print-avail/ ; elle affiche des informations sur les paquets donn�s en argument. </VarListEntry> <VarListEntry><Term>search</Term> <ListItem><Para> La commande <literal/search/ 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/, la sortie est identique � <literal/show/ pour chaque paquet ; l'option <option/--names-only/ ne recherche pas la cha�ne dans les descriptions longues mais seulement dans les noms de paquets. <para> On peut utiliser des arguments distincts pour indiquer des expressions r�guli�res diff�rentes sur lesquelles sera r�alis� un � et � logique. </VarListEntry> <VarListEntry><Term>depends</Term> <ListItem><Para> La commande <literal/depends/ affiche la liste de toutes les d�pendances d'un paquet et la liste de tous les paquets possibles qui satisfont ces d�pendances. </VarListEntry> <VarListEntry><Term>pkgnames</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/. </VarListEntry> <VarListEntry><Term>dotty</Term> <ListItem><Para> La commande <literal/dotty/ prend une liste de paquets sur la ligne de commande et affiche une sortie appropri�e � une utilisation par dotty avec le paquet <ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphViz</>. 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. On peut d�sactiver ce comportement en positionnant 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 de paquets plus volumineux. </VarListEntry> <VarListEntry><Term>policy</Term> <ListItem><Para> <literal/policy/ 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. </VarListEntry> </VariableList> </RefSect1> <RefSect1><Title>Options</> &apt-cmdblurb; <VariableList> <VarListEntry><term><option/-p/</><term><option/--pkg-cache/</> <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/. </VarListEntry> <VarListEntry><term><option/-s/</><term><option/--src-cache/</> <ListItem><Para> Indique le fichier servant de cache des sources. Ce cache n'est utilis� que par <literal/gencaches/ ; 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/. </VarListEntry> <VarListEntry><term><option/-q/</><term><option/--quiet/</> <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=#/ pour positionner le niveau de silence, annulant le fichier de configuration. �l�ment de configuration : <literal/quiet/. </VarListEntry> <VarListEntry><term><option/-i/</><term><option/--important/</> <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/. </VarListEntry> <VarListEntry><term><option/-f/</><term><option/--full/</> <ListItem><Para> Affiche la totalit� des champs d'information sur le paquet lors d'une recherche. �l�ment de configuration : <literal/APT::Cache::ShowFull/. </VarListEntry> <VarListEntry><term><option/-a/</><term><option/--all-versions/</> <ListItem><Para> Affiche la totalit� des champs d'information pour toutes les versions disponibles : cette option concerne seulement la commande show. �l�ment de configuration : <literal/APT::Cache::AllVersions/. </VarListEntry> <VarListEntry><term><option/-g/</><term><option/--generate/</> <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), utiliser l'option <option/--no-generate/. �l�ment de configuration : <literal/APT::Cache::Generate/. </VarListEntry> <VarListEntry><term><option/--names-only/</> <ListItem><Para> N'effectue une recherche que sur les noms de paquets et non sur les descriptions longues. �l�ment de configuration : <literal/APT::Cache::NamesOnly/. </VarListEntry> <VarListEntry><term><option/--all-names/</> <ListItem><Para> Avec cette option <literal/pkgnames/ affiche tous les noms, les noms des paquets virtuels et les d�pendances manquantes. �l�ment de configuration : <literal/APT::Cache::AllNames/. </VarListEntry> <VarListEntry><term><option/--recurse/</> <ListItem><Para> Avec cette option <literal/depends/ est r�cursive de mani�re � n'afficher qu'une seule fois les paquets mentionn�s. �l�ment de configuration : <literal/APT::Cache::RecurseDepends/. </VarListEntry> &apt-commonoptions; </VariableList> </RefSect1> <RefSect1><Title>Fichiers</> <variablelist> <VarListEntry><term><filename>/etc/apt/sources.list</></term> <ListItem><Para> Emplacements o� aller chercher les paquets. �l�ment de configuration : <literal/Dir::Etc::SourceList/. </VarListEntry> <VarListEntry><term><filename>&statedir;/lists/</></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/. </VarListEntry> <VarListEntry><term><filename>&statedir;/lists/partial/</></term> <ListItem><Para> Zone de stockage pour les informations en transit. �l�ment de configuration : <literal/Dir::State::Lists/ (partial est implicite). </VarListEntry> </variablelist> </RefSect1> <RefSect1><Title>Voir aussi</> <para> &apt-conf;, &sources-list;, &apt-get; </RefSect1> <RefSect1><Title>Diagnostics</> <para> <command/apt-cache/ retourne z�ro apr�s un d�roulement normal, et le nombre d�cimal 100 en cas d'erreur. </RefSect1> &manbugs; &manauthor; &deux-traducteurs; </refentry>