summaryrefslogtreecommitdiff
path: root/doc/fr/apt-cache.fr.8.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/fr/apt-cache.fr.8.xml')
-rw-r--r--doc/fr/apt-cache.fr.8.xml474
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&nbsp;; 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&nbsp;:
+</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&nbsp;;
+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&nbsp;; 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&nbsp;:
+ <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&nbsp;; 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&nbsp;; ces paquets
+�&nbsp;fournissent&nbsp;� 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 �&nbsp;mail-transport-agent&nbsp;� est un paquet virtuel
+pur&nbsp;; plusieurs paquets peuvent �&nbsp;remplir&nbsp;� ce nom
+�&nbsp;mail-transport-agent&nbsp;�, mais il
+n'existe aucun paquet nomm� �&nbsp;mail-transport-agent&nbsp;�.</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, �&nbsp;X11-text-viewer&nbsp;� est un paquet virtuel&nbsp;;
+seul le paquet �&nbsp;xless&nbsp;� remplit �&nbsp;X11-text-viewer&nbsp;�.</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, �&nbsp;debconf&nbsp;� est
+un paquet r�el et il est aussi fourni par �&nbsp;debconf-tiny&nbsp;�.
+ </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 �&nbsp;Conflicts&nbsp;�.
+</para> </listitem>
+
+ <listitem><para>
+<literal>Total distinct versions</literal> est le nombre de versions de paquets trouv�es
+dans le cache&nbsp;; cette valeur est par cons�quent au moins �gale au
+nombre total de paquets. Quand on acc�de � plus d'une distribution
+(�&nbsp;stable&nbsp;� et �&nbsp;unstable&nbsp;�, 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>&nbsp;;
+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&nbsp;; 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 �&nbsp;et&nbsp;� 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&nbsp;;
+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&nbsp;; les paquets normaux sont
+des bo�tes, les �&nbsp;provides&nbsp;� purs sont des triangles,
+les �&nbsp;provides&nbsp;� 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&nbsp;: <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>&nbsp;; 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&nbsp;: <literal>Dir::Cache::srcpkgcache</literal>.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term><option>-q</option></term><term><option>--quiet</option></term>
+ <listitem><para>
+Mode silencieux&nbsp;; 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&nbsp;: <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&nbsp;; � utiliser avec la commande
+unmet pour n'afficher que les relations Depends et Pre-Depends.
+�l�ment de configuration&nbsp;: <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&nbsp;: <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&nbsp;: 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&nbsp;: <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&nbsp;: <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&nbsp;: <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&nbsp;: <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&nbsp;: <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&nbsp;: <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&nbsp;: <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&nbsp;: <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&nbsp;: <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>