diff options
Diffstat (limited to 'doc/fr/apt-cache.8.fr.sgml')
| -rw-r--r-- | doc/fr/apt-cache.8.fr.sgml | 377 |
1 files changed, 377 insertions, 0 deletions
diff --git a/doc/fr/apt-cache.8.fr.sgml b/doc/fr/apt-cache.8.fr.sgml new file mode 100644 index 000000000..6670127bb --- /dev/null +++ b/doc/fr/apt-cache.8.fr.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 ; 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 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 ; 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 et/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é abandonné par 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>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/">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 ; 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> + </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ée, le cache de 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>
\ No newline at end of file |