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 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
d'intressantes informations.
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,
ncurses3.0 ; ces paquets doivent tre installs au pralable pour que
libreadline2 fonctionne. leur tour, libreadlineg2 et
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 des 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 remplir 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 des 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 .
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 paquet 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
informations sur les paquets donns en argument.
search regex [ regex ... ]
La commande search recherche l'expression rgulire donne en argument
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 on donne
l'option --full, 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 rgulires diffrentes sur lesquelles sera ralis 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 [ prefix ]
Cette commande affiche le nom de chaque paquet du systme. Un prfixe
pour filtrer la liste des noms peut tre donn en argument. La sortie
est approprie 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.
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 [1]GraphViz. 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.
policy [ paquet(s) ]
OPTIONS
Toutes les options en ligne de commande peuvent tre positionnes via le
fichier de configuration ; les descriptifs indiquent l'option de
configuration positionner. En ce qui concerne les options boolennes,
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 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, faite partir 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 la
commande unmet pour n'afficher que les relations Depends et
Pre-Depends. lment de configuration : APT::Cache::Important.
-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 actuel. Pour dsactiver cette option (option par
dfaut), utilisez l'option --no-generate. lment de configuration :
APT::Cache::Generate.
--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
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 dfaut,
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. lment de configuration :
Dir::Etc::SourceList.
/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 (partial est implicite).
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
Voyez la [2] page concernant les bogues d'APT. Si vous voulez signaler
un bogue, consultez le texte /usr/share/doc/debian/bug-reporting.txt ou
utilisez la commande reportbug(1).
TRADUCTION
Jrme Marant. 2000 ; mise jour : Philippe Batailler. 2005.
<debian-l10n-french@lists.debian.org>.
AUTHORS
Linux 29 Fvrier 2004 APT-CACHE(8)
Man(1) output converted with
man2html