summaryrefslogtreecommitdiff
path: root/doc/fr/apt-cache.fr.8.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/fr/apt-cache.fr.8.sgml')
-rw-r--r--doc/fr/apt-cache.fr.8.sgml377
1 files changed, 377 insertions, 0 deletions
diff --git a/doc/fr/apt-cache.fr.8.sgml b/doc/fr/apt-cache.fr.8.sgml
new file mode 100644
index 000000000..6670127bb
--- /dev/null
+++ b/doc/fr/apt-cache.fr.8.sgml
@@ -0,0 +1,377 @@
+<!-- -*- mode: sgml; mode: fold -*- -->
+<!-- translation of version 1.4 -->
+<!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>pkg</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>pkg</replaceable></arg></arg>
+ <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
+ <arg>depends <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
+ <arg>pkgnames <arg choice="plain"><replaceable>prefix</replaceable></arg></arg>
+ <arg>dotty <arg choice="plain" rep="repeat"><replaceable>pkg</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 les fichiers donnés en argument au cache des
+paquets.
+ </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 de source et de paquet à
+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&thinsp;; 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&nbsp;:
+
+<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&thinsp;; 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&thinsp;; 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&nbsp;:
+ <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&thinsp;; ces
+paquets tolèrent une correspondance bijective entre leur nom et le nom utilisé
+par d'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&thinsp;; 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&thinsp;;
+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;».
+ </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, «&nbsp;X11-text-viewer&nbsp;» est un paquet virtuel&thinsp;; seul le paquet
+«&nbsp;xless&nbsp;» remplit «&nbsp;X11-text-viewer&nbsp;».
+ </listitem>
+
+ <listitem><para>
+<literal/Mixed virtual packages/ est le nombre des paquets qui remplissent un
+paquet virtuel particulier et/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 rempli par «&nbsp;debconf-tiny&nbsp;».
+ </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é abandonné par une distribution.
+Habituellement on les trouve dans les champs «&nbsp;Conflicts&nbsp;».
+ </listitem>
+
+ <listitem><para>
+<literal/Total distinct/ versions est le nombre de versions de paquets trouvées
+dans le cache&thinsp;; 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.
+ </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>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/&thinsp;;
+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&thinsp;; 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 «&nbsp;et&nbsp;» 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&thinsp;; 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/">GraphVis</>.
+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&thinsp;; 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 de paquets
+plus volumineux.
+ </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&nbsp;: <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/&thinsp;; 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ée, le cache de sources est utilisé afin d'éviter
+d'analyser à nouveau tous les paquets.
+Élément de configuration&nbsp;: <literal/Dir::Cache::srcpkgcache/.
+ </VarListEntry>
+
+ <VarListEntry><term><option/-q/</><term><option/--quiet/</>
+ <ListItem><Para>
+Mode silencieux&thinsp;; 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&nbsp;: <literal/quiet/.
+ </VarListEntry>
+
+ <VarListEntry><term><option/-i/</><term><option/--important/</>
+ <ListItem><Para>
+N'affiche que les dépendances importantes&thinsp;; à utiliser avec la commande
+unmet pour n'afficher que les relations Depends et Pre-Depends.
+Élément de configuration&nbsp;: <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&nbsp;: <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&nbsp;: cette option concerne seulement la commande show.
+Élément de configuration&nbsp;: <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&nbsp;: <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&nbsp;: <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&nbsp;: <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&nbsp;: <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&nbsp;: <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&nbsp;: <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&nbsp;: <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> \ No newline at end of file