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