Provided by: apt_0.6.43.3ubuntu2_i386 bug

NAME

       apt-cache - Gestion des paquets et manipulation du cache par APT

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

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 d’intéressantes informations.

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

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

       gencaches
              La commande gencaches fait la même chose que apt-get check. Elle
              construit les caches des sources et des  paquets  à  partir  des
              sources    répertoriées    dans    sources.list(5)     et   dans
              /var/lib/dpkg/status.

       showpkg paquet(s)
              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,
              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  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 ».

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

              ·   Mixed  virtual  packages  est  le  nombre  des  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  GNU/Linux,  «  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 ».

              ·   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(s)
               showsrc  affiche  toutes  les  entrées  de  paquet  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 une liste
              des paquets disponibles. Elle convient à  une  utilisation  avec
              dpkg(8) et la méthode dselect(8) s’en sert.

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

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

       search regex [ regex ... ]
              La  commande  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 --full, 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  régulières  différentes sur lesquelles sera réalisé
              un « et » logique.

       depends paquet(s)
              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(s)
              La commande rdepends affiche la liste de toutes les  dépendances
              inverses d’un paquet.

       pkgnames [ prefix ]
              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
              --generate.

       dotty paquet(s)
              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:
              http://www.research.att.com/sw/tools/graphviz/. 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.  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.

       policy [ paquet(s) ]
               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(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 part  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 en ligne de commande peuvent être  positionnées  via
       le  fichier  de  configuration  ; les descriptifs indiquent l’option de
       configuration à positionner. En ce qui concerne les options booléennes,
       on  peut annuler le fichier de configuration en utilisant quelque chose
       comme -f-,--no-f, -f=no ou d’autres variantes.

       -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, faite à partir 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  la
              commande  unmet  pour  n’afficher  que  les relations Depends et
              Pre-Depends. Élément de configuration : APT::Cache::Important.

       -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 actuel. 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
              Affiche un mode d’emploi succinct.

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

       -c, --config-file
              Fichier de configuration ; indique quel fichier de configuration
              utiliser. Le programme  lit  le  fichier  de  configuration  par
              défaut, puis celui-ci. Voyez apt.conf(5) pour la syntaxe.

       -o, --option
              Donne  une  option  de  configuration  ; cela fixe une option de
              configuration arbitraire. La syntaxe est : -o Foo::Bar=bar.

FICHIERS

       /etc/apt/sources.list
              Emplacements  où  aller  chercher  les   paquets.   Élément   de
              configuration : Dir::Etc::SourceList.

       /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 est implicite).

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

       Voyez      la      page      concernant      les      bogues     d’APT:
       http://bugs.debian.org/src:apt.  Si  vous  voulez  signaler  un  bogue,
       consultez  le texte /usr/share/doc/debian/bug-reporting.txt ou utilisez
       la commande reportbug(1).

TRADUCTION

       Jérôme  Marant.  2000  ;  mise  à  jour  :  Philippe  Batailler.  2005.
       <debian-l10n-french@lists.debian.org>.

AUTHORS

       Jason Gunthorpe, APT team.