diff options
Diffstat (limited to 'doc/fr/apt-cache.fr.8.xml')
-rw-r--r-- | doc/fr/apt-cache.fr.8.xml | 474 |
1 files changed, 474 insertions, 0 deletions
diff --git a/doc/fr/apt-cache.fr.8.xml b/doc/fr/apt-cache.fr.8.xml new file mode 100644 index 000000000..043d9ec99 --- /dev/null +++ b/doc/fr/apt-cache.fr.8.xml @@ -0,0 +1,474 @@ +<?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> |