Provided by:
apt_0.8.16~exp5ubuntu13_i386 
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)