Loading

NAME

       apt-cache - Gestionnaire de paquets APT - manipulation du cache

SYNOPSIS

       apt-cache [-hvsn] [-o=option de configuration] [-c=fichier]
                 {[add 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...]}

       apt-cache ralise diffrentes oprations sur le cache de paquet d'APT.
       apt-cache ne manipule pas l'tat du systme mais fournit des moyens de
       recherche dans les mtadonnes d'un paquet desquelles il extrait les
       informations intressantes.

        moins que l'option -h ou --help ne soit donne, l'une des commandes
       suivantes doit tre prsente.

       add fichier(s)
           La commande add ajoute des fichiers indexant des paquets au cache
           des paquets. Cela sert uniquement pour le dbogage.

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

       showpkg paquet(s)
           La commande showpkg affiche des informations sur les paquets donns
           en argument. Les arguments restants sont les noms de paquets. Les
           versions disponibles et les dpendances inverses de chaque paquet
           rpertori sont listes, ainsi que les dpendances normales pour chaque
           version. Les dpendances normales d'un paquet sont constitues par
           les paquets dont il dpend ; les dpendances inverses sont les
           paquets qui dpendent du paquet en question. Les dpendances normales
           doivent donc tre satisfaites et les dpendances inverses n'ont pas
           besoin de l'tre. Ainsi, la commande apt-cache showpkg libreadline2
           donnera ce rsultat :

               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, dpend de libc5 et
           ncurses3.0 ; ces paquets doivent tre installs au pralable pour que
           libreadline2 fonctionne.  leur tour, libreadlineg2 et
           libreadline2-altdev dpendent de libreadline2. Si libreadline2 est
           install, libc5 et ncurses3.0 doivent tre installs ; libreadlineg2
           et libreadline2-altdev n'ont pas  l'tre. Pour connatre le sens de
           la fin de chane, il est prfrable 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 rapportes :

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

           o   Normal packages est le nombre de paquets simples, ordinaires ;
               ces paquets tolrent une correspondance bijective entre leur nom
               et le nom utilis par les autres paquets pour les qualifier
               comme dpendance. La majorit des paquets appartient  cette
               catgorie.

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

           o   Single virtual packages est le nombre de paquets virtuels qui
               ne peuvent tre remplis que par un seul paquet. Par exemple, au
               sein du systme 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 systme Debian
               GNU/Linux, << debconf >> est un paquet rel et il est aussi
               fourni par << debconf-tiny >>.

           o   Missing est le nombre de paquets rfrencs dans une dpendance
               mais qui ne sont fournis par aucun paquet. Les paquets
               manquants peuvent tre mis en vidence quand on n'accde pas  une
               distribution complte ou si un paquet (rel ou virtuel) a t 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
               trouves dans le cache ; cette valeur est par consquent au moins
               gale au nombre total de paquets. Quand on accde  plus d'une
               distribution (<< stable >> et << unstable >>, par exemple),
               cette valeur peut tre considrablement plus grande que le nombre
               total de paquets.

           o   Total dependencies est le nombre de relations de dpendances
               dclares par tous les paquets prsents dans le cache.

       showsrc paquet(s)
           showsrc affiche toutes les entres de paquets source qui
           correspondent aux noms donns. Toutes les versions sont affiches et
           toutes les entres qui dclarent que ces noms correspondent  des
           paquets binaires.

       dump
           La commande dump affiche un court rsum sur chaque paquet du cache.
           Elle est d'abord destine au dbogage.

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

       unmet
           La commande unmet affiche un rsum concernant toutes les dpendances
           absentes dans le cache de paquets.

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

       search expression [ expression ... ]
           La commande search recherche l'expression rationnelle donne en
           paramtre sur tous les paquets disponibles. Elle cherche une
           occurrence de la chane 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
           chane dans les descriptions longues mais seulement dans les noms de
           paquets.

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

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

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

       pkgnames [ prfixe ]
           Cette commande affiche le nom de chaque paquet connu par APT. Un
           prfixe pour filtrer la liste des noms peut tre donn en paramtre. La
           sortie est adapte  une utilisation au sein d'une fonction complte
           de shell ; elle est produite trs rapidement. On utilise au mieux
           cette commande avec l'option --generate.

           Veuillez noter qu'un paquet connu par APT n'est pas forcment
           disponible, installable ou install. Par exemple, les paquets
           virtuels sont galement affichs dans la liste cre.

       dotty paquet(s)
           La commande dotty prend une liste de paquets sur la ligne de
           commande et affiche une sortie approprie  une utilisation par la
           commande dotty du paquet GraphViz[1]. Il en rsulte un ensemble de
           noeuds et d'arcs reprsentant les relations entre les paquets. Par
           dfaut les paquets donns en argument suivent toutes leurs
           dpendances, ce qui peut produire un graphe trs volumineux. Pour
           limiter la sortie aux seuls paquets lists sur la ligne de commande,
           positionnez l'option APT::Cache::GivenOnly.

           Les noeuds rsultants ont plusieurs formes ; les paquets normaux
           sont des botes, les << provides >> purs sont des triangles, les
           << provides >> mixtes sont des diamants et les paquets manquants
           sont des hexagones. Les botes oranges expriment un arrt de la
           rcursivit [paquet feuille], les lignes bleues reprsentent des
           prdpendances et les lignes vertes reprsentent des conflits.

           Attention, dotty ne peut pas reprsenter des ensembles trs grands de
           paquets.

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

       policy [ paquet(s) ]
           policy sert  dboguer des problmes relatifs au fichier des
           prfrences. Sans argument, la commande affiche la priorit de chaque
           source. Sinon, elle affiche des informations prcises sur la priorit
           du paquet donn en argument.

       madison [ paquet(s) ]
           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 fonctionnalits. 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 dfinies dans le
       fichier de configuration, les descriptions indiquant l'option de
       configuration concerne. Pour les options boolennes, vous pouvez
       inverser les rglages 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 oprations.
           lment 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 conserve.
           Quand le cache des paquets est cr, le cache des sources est utilis
           afin d'viter d'analyser  nouveau tous les paquets. lment 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. lment de configuration : quiet.

       -i, --important
           N'affiche que les dpendances importantes ;  utiliser avec les
           commandes unmet et depends pour n'afficher que les relations
           Depends et Pre-Depends. lment 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 twicked with these flags which will omit the specified
           dependency type. Configuration Item: APT::Cache::ShowDependencyType
           e.g.  APT::Cache::ShowRecommends.

       -f, --full
           Affiche la totalit des champs d'information sur le paquet lors
           d'une recherche. lment 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 dfaut. Pour la
           dsactiver, utilisez l'option --no-all-versions. Quand l'option
           --no-all-versions est choisie, seuls les lments de la version
           choisie (celle qui serait installe) seront affichs. Cette option
           concerne seulement la commande show. lment de configuration :
           APT::Cache::AllVersions.

       -g, --generate
           Ralise une mise  jour automatique du cache des paquets plutt que de
           se servir du cache tel qu'il est. Pour dsactiver cette option
           (option par dfaut), utilisez l'option --no-generate. lment de
           configuration : APT::Cache::Generate.

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

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

       --recurse
           Avec cette option, depends et rdepends sont rcursives de manire
           n'afficher qu'une seule fois les paquets mentionns. lment de
           configuration : APT::Cache::RecurseDepends.

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

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

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

       -c, --config-file
           Configuration File; Specify a configuration file to use. The
           program will read the default configuration file and then this
           configuration file. If configuration settings need to be set before
           the default configuration files are parsed specify a file with the
           APT_CONFIG environment variable. See apt.conf(5) for syntax
           information.

       -o, --option
           Dfinir une option de configuration ; permet de rgler une option de
           configuration donne. La syntaxe est -o Foo::Bar=bar.  -o et
           --option peuvent tre utilises plusieurs fois pour dfinir des
           options diffrentes.

FICHIERS

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

       /etc/apt/sources.list.d/
           Fragments de fichiers dfinissant les emplacements de rcupration de
           paquets. lment de configuration : Dir::Etc::SourceParts.

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

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

VOIR AUSSI

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

DIAGNOSTICS

       apt-cache retourne zro aprs un droulement normal et le nombre dcimal
       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

       Jrme 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 lgrement en retard sur le contenu d'origine.

AUTHORS

       Jason Gunthorpe

       quipe de dveloppement 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/gsvc.html

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