Provided by: apt_1.0.1ubuntu2_amd64 bug

NOM

       apt-cache - recherche dans le cache d'APT

SYNOPSIS

       apt-cache [-agipns] [-o=chaîne_de_configuration] [-c=fichier_de_configuration] {gencaches
                 | showpkg paquet... | showsrc paquet... | stats | dump | dumpavail | unmet |
                 search expression_régulière... |
                 show paquet [{=numéro_version_paquet | /publication_cible}]... |
                 depends paquet [{=numéro_version_paquet | /publication_cible}]... |
                 rdepends paquet [{=numéro_version_paquet | /publication_cible}]... |
                 pkgnames [préfixe]  |
                 dotty paquet [{=numéro_version_paquet | /publication_cible}]... |
                 xvcg paquet [{=numéro_version_paquet | /publication_cible}]... |
                 policy [paquet...] | madison paquet... | {-v | --version} | {-h | --help}}

DESCRIPTION

       apt-cache réalise différentes opérations sur le cache de paquet d'APT. 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 les informations intéressantes.

       À moins que l'option -h ou --help ne soit donnée, l'une des commandes suivantes doit être
       présente.

       gencaches
           gencaches crée le cache d'APT. Cette action est faite implicitement par toute commande
           qui a besoin de ce cache s'il est manquant ou obsolète.

       showpkg paquet...
           La commande 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
           apt-cache showpkg libreadline2 donnera ce résultat :

               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:
           On peut voir que libreadline2, version 2.1-12, dépend de libc5 et 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.

       stats
           La commande stats affiche des statistiques à propos du cache. Aucun autre argument
           n'est attendu. Voici les informations rapportées :

           ·   Total package names est le nombre de paquets trouvés dans le cache.

           ·   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.

           ·   Pure virtual packages est le nombre de 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 « fournir » ce nom
               « mail-transport-agent », mais il n'existe aucun paquet nommé
               « mail-transport-agent ».

           ·   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,
               « X11-text-viewer » est un paquet virtuel ; seul le paquet « xless » remplit
               « X11-text-viewer ».

           ·   Mixed virtual packages est le nombre de 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, « debconf » est un paquet réel et il est aussi fourni par
               « debconf-tiny ».

           ·   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 » ou « Breaks ».

           ·   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.

           ·   Total dependencies est le nombre de relations de dépendances déclarées par tous
               les paquets présents dans le cache.

       showsrc paquet...
           showsrc affiche toutes les entrées de paquets 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.

       dump
           La commande dump affiche un court résumé sur chaque paquet du cache. Elle est d'abord
           destinée au débogage.

       dumpavail
           La commande dumpavail affiche sur la sortie standard la liste des paquets disponibles.
           Elle convient à une utilisation avec dpkg(1) et la méthode dselect(1) s'en sert.

       unmet
           La commande unmet affiche un résumé concernant toutes les dépendances absentes dans le
           cache de paquets.

       show paquet...
           La commande show est semblable à dpkg --print-avail ; elle affiche des informations
           sur les paquets donnés en argument.

       search expression_régulière...
           La commande search recherche l'expression rationnelle POSIX donnée en paramètre sur
           tous les paquets disponibles, voir regex(7). 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 l'option --full est fournie, la sortie est identique à
           show pour chaque paquet ; l'option --names-only ne recherche pas la chaîne dans les
           descriptions longues mais seulement dans les noms de paquets.

           On peut utiliser des arguments distincts pour indiquer des expressions rationnelles
           différentes sur lesquelles seront réalisées un « et » logique.

       depends paquet...
           La commande 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.

       rdepends paquet...
           La commande rdepends affiche la liste de toutes les dépendances inverses d'un paquet.

       pkgnames [préfixe]
           Cette commande affiche le nom de chaque paquet connu par APT. Un préfixe pour filtrer
           la liste des noms peut être donné en paramètre. La sortie est adapté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 --generate.

           Veuillez noter qu'un paquet connu par APT n'est pas forcément disponible, installable
           ou installé. Par exemple, les paquets virtuels sont également affichés dans la liste
           créée.

       dotty paquet...
           La commande dotty prend une liste de paquets sur la ligne de commande et affiche une
           sortie appropriée à une utilisation par la commande dotty du paquet GraphViz[1]. Il en
           résulte un ensemble de nœuds 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 APT::Cache::GivenOnly.

           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.

           Attention, dotty ne peut pas représenter des ensembles très grands de paquets.

       xvcg paquet...
           Identique à dotty, mais réservé à xvcg fourni avec VCG tool[2].

       policy [paquet...]
           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.

       madison paquet...
           La commande madison d'apt-cache cherche à mimer le format de sortie propre à l'outil
           debian de gestion d'archives, madison, ainsi qu'une partie de ses fonctionnalités.
           Elle affiche les versions disponibles d'un paquet dans un tableau. Contrairement au
           programme original madison, elle n'affiche que des informations concernant
           l'architecture pour laquelle Apt a lu la liste des paquets disponibles
           (APT::Architecture).

OPTIONS

       Toutes les options de la ligne de commande peuvent être définies dans le fichier de
       configuration, les descriptions indiquant l'option de configuration concernée. Pour les
       options booléennes, vous pouvez inverser les réglages du fichiers de configuration avec
       -f-,--no-f, -f=no et d'autres variantes analogues.

       -p, --pkg-cache
           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 :
           Dir::Cache::pkgcache.

       -s, --src-cache
           Indique le fichier servant de cache des sources. Ce cache n'est utilisé que par
           gencaches ; une version des informations sur les paquets, issue 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 : Dir::Cache::srcpkgcache.

       -q, --quiet
           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 -q=#
           pour positionner le niveau de silence, annulant le fichier de configuration. Élément
           de configuration : quiet.

       -i, --important
           N'affiche que les dépendances importantes ; à utiliser avec les commandes unmet et
           depends pour n'afficher que les relations Depends et Pre-Depends. Élément de
           configuration : APT::Cache::Important.

       --no-pre-depends, --no-depends, --no-recommends, --no-suggests, --no-conflicts,
       --no-breaks, --no-replaces, --no-enhances
           Avec cette option, depends et rdepends affichent toutes les dépendances. Ce
           comportement peut être modifié avec ces réglages qui omettront le type de dépendance
           indiqué. Élément de configuration : APT::Cache::ShowTypeDépendance,
           p. ex. APT::Cache::ShowRecommends.

       -f, --full
           Affiche la totalité des champs d'information sur le paquet lors d'une recherche.
           Élément de configuration : APT::Cache::ShowFull.

       -a, --all-versions
           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 --no-all-versions.
           Quand l'option --no-all-versions est choisie, seuls les éléments de la version choisie
           (celle qui serait installée) seront affichés. Cette option concerne seulement la
           commande show. Élément de configuration : APT::Cache::AllVersions.

       -g, --generate
           Réalise une mise à jour automatique du cache des paquets plutôt que de se servir du
           cache tel qu'il est. Pour désactiver cette option (option par défaut), utilisez
           l'option --no-generate. Élément de configuration : APT::Cache::Generate.

       --names-only, -n
           N'effectue une recherche que sur les noms de paquets et pas sur les descriptions
           longues. Élément de configuration : APT::Cache::NamesOnly.

       --all-names
           Avec cette option, pkgnames affiche tous les noms, les noms des paquets virtuels et
           les dépendances manquantes. Élément de configuration : APT::Cache::AllNames.

       --recurse
           Avec cette option, depends et rdepends sont récursives de manière à n'afficher qu'une
           seule fois les paquets mentionnés. Élément de configuration :
           APT::Cache::RecurseDepends.

       --installed
           Cette option limite la sortie de depends et de rdepends aux paquets qui sont
           actuellement installés. Élément de configuration : APT::Cache::Installed.

       -h, --help
           Afficher un bref résumé de l'utilisation.

       -v, --version
           Afficher la version du programme.

       -c, --config-file
           Fichier de configuration ; indique le fichier de configuration à utiliser. Le
           programme lira le fichier de configuration par défaut puis le fichier indiqué ici. Si
           les réglages de configuration doivent être établis avant l'analyse des fichiers de
           configuration par défaut, un fichier peut être indiqué avec la variable
           d'environnement APT_CONFIG. Veuillez consulter apt.conf(5) pour des informations sur
           la syntaxe d'utilisation.

       -o, --option
           Définir une option de configuration ; permet de régler une option de configuration
           donnée. La syntaxe est -o Foo::Bar=bar. -o et --option peuvent être utilisées
           plusieurs fois pour définir des options différentes.

FICHIERS

       /etc/apt/sources.list
           Emplacement pour la récupération des paquets. Élément de configuration :
           Dir::Etc::SourceList.

       /etc/apt/sources.list.d/
           Fragments de fichiers définissant les emplacements de récupération de paquets. Élément
           de configuration : Dir::Etc::SourceParts.

       /var/lib/apt/lists/
           Zone de stockage pour les informations qui concernent chaque ressource de paquet
           spécifiée dans sources.list(5) Élément de configuration : Dir::State::Lists.

       /var/lib/apt/lists/partial/
           Zone de stockage pour les informations en transit. Élément de configuration :
           Dir::State::Lists (partial sera implicitement ajouté).

VOIR AUSSI

       apt.conf(5), sources.list(5), apt-get(8).

DIAGNOSTICS

       apt-cache retourne zéro après un déroulement normal et le nombre décimal 100 en cas
       d'erreur.

BOGUES

       Page des bogues d'APT[3]. Si vous souhaitez signaler un bogue à propos d'APT, veuillez
       lire /usr/share/doc/debian/bug-reporting.txt ou utiliser la commande reportbug(1).

TRADUCTEURS

       Jérôme Marant, Philippe Batailler, Christian Perrier <bubulle@debian.org> (2000, 2005,
       2009, 2010), Équipe de traduction francophone de Debian
       <debian-l10n-french@lists.debian.org>

       Veuillez noter que cette traduction peut contenir des parties non traduites. Cela est
       volontaire, pour éviter de perdre du contenu quand la traduction est légèrement en retard
       sur le contenu d'origine.

AUTEURS

       Jason Gunthorpe

       Équipe de développement d'APT

NOTES

        1. GraphViz
           http://www.research.att.com/sw/tools/graphviz/

        2. VCG tool
           http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html

        3. Page des bogues d'APT
           http://bugs.debian.org/src:apt