Provided by: apt_0.8.16~exp5ubuntu13_i386 bug

NAME

       apt-cache - recherche dans le cache d'APT

SYNOPSIS

       apt-cache [-hvsn] [-o=option de configuration] [-c=fichier]
                 {[gencaches] | [showpkg paquet...] | [showsrc paquet...] |
                 [stats] | [dump] | [dumpavail] | [unmet] | [search regex] |
                 [show paquet...] | [depends paquet...] | [rdepends paquet...]
                 | [pkgnames prefix] | [dotty paquet...] | [policy paquets...]
                 | [madison paquets...]}

DESCRIPTION

       apt-cache realise differentes operations sur le cache de paquet d'APT.
       apt-cache ne manipule pas l'etat du systeme mais fournit des moyens de
       recherche dans les metadonnees d'un paquet desquelles il extrait les
       informations interessantes.

       A moins que l'option -h ou --help ne soit donnee, l'une des commandes
       suivantes doit etre presente.

       gencaches
           La commande gencaches fait la meme chose que apt-get check. Elle
           construit les caches des sources et des paquets a partir des
           sources repertoriees dans sources.list(5) et dans
           /var/lib/dpkg/status.

       showpkg paquet(s)
           La commande showpkg affiche des informations sur les paquets donnes
           en argument. Les arguments restants sont les noms de paquets. Les
           versions disponibles et les dependances inverses de chaque paquet
           repertorie sont listees, ainsi que les dependances normales pour
           chaque version. Les dependances normales d'un paquet sont
           constituees par les paquets dont il depend ; les dependances
           inverses sont les paquets qui dependent du paquet en question. Les
           dependances normales doivent donc etre satisfaites et les
           dependances inverses n'ont pas besoin de l'etre. Ainsi, la commande
           apt-cache showpkg libreadline2 donnera ce resultat :

               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, depend de libc5 et
           ncurses3.0 ; ces paquets doivent etre installes au prealable pour
           que libreadline2 fonctionne. A leur tour, libreadlineg2 et
           libreadline2-altdev dependent de libreadline2. Si libreadline2 est
           installe, libc5 et ncurses3.0 doivent etre installes ;
           libreadlineg2 et libreadline2-altdev n'ont pas a l'etre. Pour
           connaitre le sens de la fin de chaine, il est preferable de
           consulter le code source d'APT.

       stats
           La commande stats affiche des statistiques a propos du cache. Aucun
           autre argument n'est attendu. Voici les informations rapportees :

           o   Total package names est le nombre de paquets trouves dans le
               cache.

           o   Normal packages est le nombre de paquets simples, ordinaires ;
               ces paquets tolerent une correspondance bijective entre leur
               nom et le nom utilise par les autres paquets pour les qualifier
               comme dependance. La majorite des paquets appartient a cette
               categorie.

           o   Pure virtual packages est le nombre de paquets qui n'existent
               que sous la forme d'un nom representant un paquet virtuel ; ces
               paquets << fournissent >> seulement un nom de paquet virtuel et
               aucun paquet n'utilise veritablement ce nom. Par exemple, au
               sein du systeme 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 nomme
               << mail-transport-agent >>.

           o   Single virtual packages est le nombre de paquets virtuels qui
               ne peuvent etre remplis que par un seul paquet. Par exemple, au
               sein du systeme Debian GNU/Linux, << X11-text-viewer >> est un
               paquet virtuel ; seul le paquet << xless >> remplit
               << X11-text-viewer >>.

           o   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 systeme Debian
               GNU/Linux, << debconf >> est un paquet reel et il est aussi
               fourni par << debconf-tiny >>.

           o   Missing est le nombre de paquets references dans une dependance
               mais qui ne sont fournis par aucun paquet. Les paquets
               manquants peuvent etre mis en evidence quand on n'accede pas a
               une distribution complete ou si un paquet (reel ou virtuel) a
               ete sorti d'une distribution. Habituellement on les trouve dans
               les champs << Conflicts >> ou << Breaks >>.

           o   Total distinct versions est le nombre de versions de paquets
               trouvees dans le cache ; cette valeur est par consequent au
               moins egale au nombre total de paquets. Quand on accede a plus
               d'une distribution (<< stable >> et << unstable >>, par
               exemple), cette valeur peut etre considerablement plus grande
               que le nombre total de paquets.

           o   Total dependencies est le nombre de relations de dependances
               declarees par tous les paquets presents dans le cache.

       showsrc paquet(s)
           showsrc affiche toutes les entrees de paquets source qui
           correspondent aux noms donnes. Toutes les versions sont affichees
           et toutes les entrees qui declarent que ces noms correspondent a
           des paquets binaires.

       dump
           La commande dump affiche un court resume sur chaque paquet du
           cache. Elle est d'abord destinee au debogage.

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

       unmet
           La commande unmet affiche un resume concernant toutes les
           dependances absentes dans le cache de paquets.

       show paquet(s)
           La commande show est semblable a dpkg --print-avail ; elle affiche
           des informations sur les paquets donnes en argument.

       search expression [ expression ... ]
           La commande search recherche l'expression rationnelle donnee en
           parametre sur tous les paquets disponibles. Elle cherche une
           occurrence de la chaine 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
           a show pour chaque paquet ; l'option --names-only ne recherche pas
           la chaine dans les descriptions longues mais seulement dans les
           noms de paquets.

           On peut utiliser des arguments distincts pour indiquer des
           expressions rationnelles differentes sur lesquelles seront
           realisees un << et >> logique.

       depends paquet(s)
           La commande depends affiche la liste de toutes les dependances d'un
           paquet et la liste de tous les paquets possibles qui satisfont ces
           dependances.

       rdepends paquet(s)
           La commande rdepends affiche la liste de toutes les dependances
           inverses d'un paquet.

       pkgnames [ pr'efixe ]
           Cette commande affiche le nom de chaque paquet connu par APT. Un
           prefixe pour filtrer la liste des noms peut etre donne en
           parametre. La sortie est adaptee a une utilisation au sein d'une
           fonction complete de shell ; elle est produite tres rapidement. On
           utilise au mieux cette commande avec l'option --generate.

           Veuillez noter qu'un paquet connu par APT n'est pas forcement
           disponible, installable ou installe. Par exemple, les paquets
           virtuels sont egalement affiches dans la liste creee.

       dotty paquet(s)
           La commande dotty prend une liste de paquets sur la ligne de
           commande et affiche une sortie appropriee a une utilisation par la
           commande dotty du paquet GraphViz[1]. Il en resulte un ensemble de
           noeuds et d'arcs representant les relations entre les paquets. Par
           defaut les paquets donnes en argument suivent toutes leurs
           dependances, ce qui peut produire un graphe tres volumineux. Pour
           limiter la sortie aux seuls paquets listes sur la ligne de
           commande, positionnez l'option APT::Cache::GivenOnly.

           Les noeuds resultants ont plusieurs formes ; les paquets normaux
           sont des boites, les << provides >> purs sont des triangles, les
           << provides >> mixtes sont des diamants et les paquets manquants
           sont des hexagones. Les boites oranges expriment un arret de la
           recursivite [paquet feuille], les lignes bleues representent des
           predependances et les lignes vertes representent des conflits.

           Attention, dotty ne peut pas representer des ensembles tres grands
           de paquets.

       xvcg paquet(s)
           Identique a dotty, mais reserve a xvcg fourni avec VCG tool[2].

       policy [ paquet(s) ]
           policy sert a deboguer des problemes relatifs au fichier des
           preferences. Sans argument, la commande affiche la priorite de
           chaque source. Sinon, elle affiche des informations precises sur la
           priorite du paquet donne en argument.

       madison [ paquet(s) ]
           La commande madison d'apt-cache cherche a mimer le format de sortie
           propre a l'outil debian de gestion d'archives, madison, ainsi
           qu'une partie de ses fonctionnalites. 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 etre definies dans
       le fichier de configuration, les descriptions indiquant l'option de
       configuration concernee. Pour les options booleennes, vous pouvez
       inverser les reglages 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 utilise par toutes les operations.
           Element de configuration : Dir::Cache::pkgcache.

       -s, --src-cache
           Indique le fichier servant de cache des sources. Ce cache n'est
           utilise que par gencaches ; une version des informations sur les
           paquets, issue d'une analyse de sources distantes, est conservee.
           Quand le cache des paquets est cree, le cache des sources est
           utilise afin d'eviter d'analyser a nouveau tous les paquets.
           Element 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. Element de configuration : quiet.

       -i, --important
           N'affiche que les dependances importantes ; a utiliser avec les
           commandes unmet et depends pour n'afficher que les relations
           Depends et Pre-Depends. Element de configuration :
           APT::Cache::Important.

       --no-pre-depends, --no-depends, --no-recommends, --no-suggests,
       --no-conflicts, --no-breaks, --no-replaces, --no-enhances
           Per default the depends and rdepends print all dependencies. This
           can be tweaked with these flags which will omit the specified
           dependency type. Configuration Item: APT::Cache::ShowDependencyType
           e.g.  APT::Cache::ShowRecommends.

       -f, --full
           Affiche la totalite des champs d'information sur le paquet lors
           d'une recherche. Element de configuration : APT::Cache::ShowFull.

       -a, --all-versions
           Affiche la totalite des champs d'information pour toutes les
           versions disponibles : c'est la valeur par defaut. Pour la
           desactiver, utilisez l'option --no-all-versions. Quand l'option
           --no-all-versions est choisie, seuls les elements de la version
           choisie (celle qui serait installee) seront affiches. Cette option
           concerne seulement la commande show. Element de configuration :
           APT::Cache::AllVersions.

       -g, --generate
           Realise une mise a jour automatique du cache des paquets plutot que
           de se servir du cache tel qu'il est. Pour desactiver cette option
           (option par defaut), utilisez l'option --no-generate. Element de
           configuration : APT::Cache::Generate.

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

       --all-names
           Avec cette option, pkgnames affiche tous les noms, les noms des
           paquets virtuels et les dependances manquantes. Element de
           configuration : APT::Cache::AllNames.

       --recurse
           Avec cette option, depends et rdepends sont recursives de maniere a
           n'afficher qu'une seule fois les paquets mentionnes. Element de
           configuration : APT::Cache::RecurseDepends.

       --installed
           Cette option limite la sortie de depends et de rdepends aux paquets
           qui sont actuellement installes. Element de configuration :
           APT::Cache::Installed.

       -h, --help
           Afficher un bref resume de l'utilisation.

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

       -c, --config-file
           Fichier de configuration ; indique le fichier de configuration a
           utiliser. Le programme lira le fichier de configuration par defaut
           puis le fichier indique ici. Si les reglages de configuration
           doivent etre etablis avant l'analyse des fichiers de configuration
           par defaut, un fichier peut etre indique avec la variable
           d'environnement APT_CONFIG. Veuillez consulter apt.conf(5) pour des
           informations sur la syntaxe d'utilisation.

       -o, --option
           Definir une option de configuration ; permet de regler une option
           de configuration donnee. La syntaxe est -o Foo::Bar=bar.  -o et
           --option peuvent etre utilisees plusieurs fois pour definir des
           options differentes.

FICHIERS

       /etc/apt/sources.list
           Emplacement pour la recuperation des paquets. Element de
           configuration : Dir::Etc::SourceList.

       /etc/apt/sources.list.d/
           Fragments de fichiers definissant les emplacements de recuperation
           de paquets. Element de configuration : Dir::Etc::SourceParts.

       /var/lib/apt/lists/
           Zone de stockage pour les informations qui concernent chaque
           ressource de paquet specifiee dans sources.list(5) Element de
           configuration : Dir::State::Lists.

       /var/lib/apt/lists/partial/
           Zone de stockage pour les informations en transit. Element de
           configuration : Dir::State::Lists (implicit partial).

VOIR AUSSI

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

DIAGNOSTICS

       apt-cache retourne zero apres un deroulement normal et le nombre
       decimal 100 en cas d'erreur.

BOGUES

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

TRADUCTEURS

       Jerome Marant, Philippe Batailler, Christian Perrier bubulle@debian.org
       (2000, 2005, 2009, 2010), Equipe 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 eviter de perdre du contenu quand
       la traduction est legerement en retard sur le contenu d'origine.

AUTHORS

       Jason Gunthorpe

       'Equipe de d'eveloppement 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

Linux                           4 fevrier 2011                    APT-CACHE(8)