1
.\" This manpage has been automatically generated by docbook2man
2
.\" from a DocBook document. This tool can be found at:
3
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
4
.\" Please send any bug reports, improvements, comments, patches,
5
.\" etc. to Steve Cheng <steve@ggi-project.org>.
6
.TH "APT-CACHE" "8" "26 March 2005" "" ""
9
apt-cache \- Gestion des paquets et manipulation du cache par APT
12
\fBapt-cache\fR [ \fB-hvs\fR ] [ \fB-o=\fIoption de configuration\fB\fR ] [ \fB-c=\fIfichier\fB\fR ] { \fBadd \fIfichier\fB\fI ...\fB\fR | \fBgencaches\fR | \fBshowpkg \fIpaquet\fB\fI ...\fB\fR | \fBshowsrc \fIpaquet\fB\fI ...\fB\fR | \fBstats\fR | \fBdump\fR | \fBdumpavail\fR | \fBunmet\fR | \fBsearch \fIregex\fB\fR | \fBshow \fIpaquet\fB\fI ...\fB\fR | \fBdepends \fIpaquet\fB\fI ...\fB\fR | \fBrdepends \fIpaquet\fB\fI ...\fB\fR | \fBpkgnames \fIprefix\fB\fR | \fBdotty \fIpaquet\fB\fI ...\fB\fR | \fBpolicy \fIpaquets\fB\fI ...\fB\fR | \fBmadison \fIpaquets\fB\fI ...\fB\fR }
16
\fBapt-cache\fR r�alise diff�rentes op�rations sur le cache de paquet d'
17
APT. \fBapt-cache\fR ne manipule pas l'�tat du syst�me mais fournit des
18
moyens de recherche dans les m�tadonn�es d'un paquet desquelles il extrait
19
d'int�ressantes informations.
21
� moins que l'option \fB-h\fR ou \fB--help\fR ne soit donn�e, l'une
22
des commandes suivantes doit �tre pr�sente.
24
\fBadd \fIfichier(s)\fB\fR
25
La commande add ajoute des fichiers indexant des paquets au cache des
26
paquets. Cela sert uniquement pour le d�bogage.
29
La commande gencaches fait la m�me chose que
30
\fBapt-get check\fR\&. Elle construit les caches des sources et des paquets
31
� partir des sources r�pertori�es dans \fB\fIsources.list\fB\fR(5)
33
\fI/var/lib/dpkg/status\fR\&.
35
\fBshowpkg \fIpaquet(s)\fB\fR
36
La commande showpkg affiche des informations sur les paquets donn�s
37
en argument. Les arguments restants sont les noms de paquets. Les versions
38
disponibles et les d�pendances inverses de chaque paquet r�pertori� sont
39
list�es, ainsi que les d�pendances normales pour chaque version. Les
40
d�pendances normales d'un paquet sont constitu�es par les paquets dont il
42
d�pendances inverses sont les paquets qui d�pendent du paquet en question.
43
Les d�pendances normales doivent donc �tre satisfaites et les d�pendances
44
inverses n'ont pas besoin de l'�tre. Ainsi, la commande
45
\fBapt-cache showpkg libreadline2\fR donnerait ce r�sultat\~:
50
Versions: 2.1-12(/var/state/apt/lists/foo_Packages),
52
libreadlineg2,libreadline2
53
libreadline2-altdev,libreadline2
55
2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
61
On peut voir que libreadline2, version 2.1-12, d�pend de libc5, ncurses3.0, et
62
ldso\~; ces paquets doivent �tre install�s au pr�alable pour que
63
libreadline2 fonctionne. � leur tour, libreadlineg2 et libreadline2-altdev
64
d�pendent de libreadline2. Si libreadline2 est install�, libc5 et ncurses3.0 (et
65
ldso) doivent �tre install�s\~; libreadlineg2 et libreadline2-altdev
66
n'ont pas � l'�tre. Pour conna�tre le sens de la fin de cha�ne, il est
67
pr�f�rable de consulter le code source d'APT.
70
La commande stats affiche des statistiques � propos du cache. Aucun
71
autre argument n'est attendu. Voici les informations rapport�es\~:
75
Total package names est le nombre de paquets trouv�s dans le cache.
78
Normal packages est le nombre de paquets simples,
79
ordinaires\~; ces paquets tol�rent une correspondance bijective entre
80
leur nom et le nom utilis� par les autres paquets pour les qualifier comme
81
d�pendance. La majorit� des paquets appartient � cette cat�gorie.
84
Pure virtual packages est le nombre des paquets qui n'existent que
85
sous la forme d'un nom repr�sentant un paquet virtuel\~; ces paquets
86
�\~fournissent\~� seulement un nom de paquet virtuel et aucun paquet
87
n'utilise v�ritablement ce nom. Par exemple, au sein du syst�me Debian
88
GNU/Linux, le nom �\~mail-transport-agent\~� est un paquet virtuel
89
pur\~; plusieurs paquets peuvent �\~remplir\~� ce nom
90
�\~mail-transport-agent\~�, mais il
91
n'existe aucun paquet nomm� �\~mail-transport-agent\~�.
94
Single virtual packages est le nombre de paquets virtuels qui ne
95
peuvent �tre remplis que par un seul paquet. Par exemple, au sein du syst�me
96
Debian GNU/Linux, �\~X11-text-viewer\~� est un paquet virtuel\~;
97
seul le paquet �\~xless\~� remplit �\~X11-text-viewer\~�.
100
Mixed virtual packages est le nombre des paquets qui remplissent un
101
paquet virtuel particulier ou dont le nom est un nom de paquet virtuel.
102
Par exemple, au sein du syst�me Debian GNU/Linux, �\~debconf\~� est
103
un paquet r�el et il est aussi fourni par �\~debconf-tiny\~�.
106
Missing est le nombre de paquets r�f�renc�s dans une
107
d�pendance mais qui ne sont fournis par aucun paquet. Les paquets manquants
108
peuvent �tre mis en �vidence quand on n'acc�de pas � une distribution compl�te
109
ou si un paquet (r�el ou virtuel) a �t� sorti d'une distribution.
110
Habituellement on les trouve dans les champs �\~Conflicts\~�.
113
Total distinct versions est le nombre de versions de paquets trouv�es
114
dans le cache\~; cette valeur est par cons�quent au moins �gale au
115
nombre total de paquets. Quand on acc�de � plus d'une distribution
116
(�\~stable\~� et �\~unstable\~�, par exemple), cette valeur
117
peut �tre consid�rablement plus grande que le nombre total de paquets.
120
Total dependencies est le nombre de relations de d�pendances
121
d�clar�es par tous les paquets pr�sents dans le cache.
124
\fBshowsrc \fIpaquet(s)\fB\fR
125
showsrc affiche toutes les entr�es de paquet source qui
126
correspondent aux noms donn�s. Toutes les versions sont affich�es et toutes
127
les entr�es qui d�clarent que ces noms correspondent � des paquets binaires.
130
La commande dump affiche un court r�sum� sur chaque paquet du cache.
131
Elle est d'abord destin�e au d�bogage.
134
La commande dumpavail affiche sur la sortie standard une liste des
135
paquets disponibles. Elle convient � une utilisation avec \fBdpkg\fR(8)
137
m�thode \fBdselect\fR(8) s'en sert.
140
La commande unmet affiche un r�sum� concernant toutes les
141
d�pendances absentes dans le cache de paquets.
143
\fBshow \fIpaquet(s)\fB\fR
144
La commande show est semblable � dpkg --print-avail\~;
145
elle affiche des informations sur les paquets donn�s en argument.
147
\fBsearch \fIregex [ regex ... ]\fB\fR
148
La commande search recherche l'expression r�guli�re donn�e en
149
argument sur tous les paquets disponibles. Elle cherche une occurrence de la
150
cha�ne dans les noms de paquets et dans les descriptions puis elle affiche
151
le nom du paquet et sa description courte. Quand on donne l'option
152
\fB--full\fR, la sortie est identique � show pour chaque
153
paquet\~; l'option \fB--names-only\fR ne recherche pas la cha�ne
154
dans les descriptions longues mais seulement dans les noms de paquets.
156
On peut utiliser des arguments distincts pour indiquer des expressions
157
r�guli�res diff�rentes sur lesquelles sera r�alis� un �\~et\~� logique.
159
\fBdepends \fIpaquet(s)\fB\fR
160
La commande depends affiche la liste de toutes les d�pendances
161
d'un paquet et la liste de tous les paquets possibles qui satisfont ces
164
\fBrdepends \fIpaquet(s)\fB\fR
165
La commande rdepends affiche la liste de toutes les d�pendances inverses
168
\fBpkgnames \fI[ prefix ]\fB \fR
169
Cette commande affiche le nom de chaque paquet du syst�me. Un pr�fixe pour
170
filtrer la liste des noms peut �tre donn� en argument. La sortie est
171
appropri�e � une utilisation au sein d'une fonction compl�te de shell\~;
172
elle est produite tr�s rapidement. On utilise au mieux cette commande avec
173
l'option \fB--generate\fR\&.
175
\fBdotty \fIpaquet(s)\fB\fR
176
La commande dotty prend une liste de paquets sur la ligne de commande
177
et affiche une sortie appropri�e � une utilisation par la commande dotty du
178
paquet GraphViz <URL:http://www.research.att.com/sw/tools/graphviz/>\&.
179
Il en r�sulte un ensemble de noeuds et d'arcs repr�sentant les relations
180
entre les paquets. Par d�faut les paquets donn�s en argument suivent toutes
181
leurs d�pendances, ce qui peut produire un graphe tr�s volumineux.
182
Pour limiter la sortie aux seuls paquets list�s sur la ligne de commande,
183
positionnez l'option APT::Cache::GivenOnly\&.
185
Les noeuds r�sultants ont plusieurs formes\~; les paquets normaux sont
186
des bo�tes, les �\~provides\~� purs sont des triangles,
187
les �\~provides\~� mixtes sont des diamants et les paquets manquants
188
sont des hexagones. Les bo�tes oranges expriment un arr�t de la r�cursivit�
189
[paquet feuille], les lignes bleues repr�sentent des pr�d�pendances et les
190
lignes vertes repr�sentent des conflits.
192
Attention, dotty ne peut pas repr�senter des ensembles tr�s grands de paquets.
194
\fBpolicy \fI[ paquet(s) ]\fB\fR
195
policy sert � d�boguer des probl�mes relatifs au fichier des
196
pr�f�rences. Sans argument, la commande affiche la priorit� de chaque source.
197
Sinon, elle affiche des informations pr�cises sur la priorit� du paquet donn�
200
\fBmadison \fI[ paquet(s) ]\fB\fR
201
La commande madison d'apt-cache cherche � mimer le
202
format de sortie propre � l'outil debian de gestion d'archives,
203
madison, ainsi qu'une part de ses fonctionnalit�s. Elle affiche les
204
versions disponibles d'un paquet dans un tableau. Contrairement au programme
205
original madison, elle n'affiche que des informations qui cocernent
206
l'architecture pour laquelle Apt a lu la liste des paquets disponibles
210
Toutes les options en ligne de commande peuvent �tre positionn�es via le
211
fichier de configuration\~; les descriptifs indiquent l'option de
212
configuration � positionner. En ce qui concerne les options bool�ennes,
213
on peut annuler le fichier de configuration en utilisant quelque chose comme
214
\fB-f-\fR,\fB--no-f\fR, \fB-f=no\fR ou d'autres variantes.
219
Indique le fichier servant de cache des paquets. Le cache des paquets est
220
le cache primaire utilis� par toutes les op�rations.
221
�l�ment de configuration\~: Dir::Cache::pkgcache\&.
226
Indique le fichier servant de cache des sources. Ce cache n'est utilis� que
227
par gencaches\~; une version des informations sur les paquets,
228
faite � partir d'une analyse de sources distantes, est conserv�e. Quand le
229
cache des paquets est cr��, le cache des sources est utilis� afin d'�viter
230
d'analyser � nouveau tous les paquets.
231
�l�ment de configuration\~: Dir::Cache::srcpkgcache\&.
236
Mode silencieux\~; produit une sortie pertinente pour l'enregistrement
237
dans un fichier-journal, sans afficher d'indicateur de progression. Un plus
238
grand nombre de q produira un plus grand silence, avec un maximum de 2. Vous
239
pouvez aussi utiliser \fB-q=#\fR pour positionner le niveau de silence,
240
annulant le fichier de configuration.
241
�l�ment de configuration\~: quiet\&.
246
N'affiche que les d�pendances importantes\~; � utiliser avec la commande
247
unmet pour n'afficher que les relations Depends et Pre-Depends.
248
�l�ment de configuration\~: APT::Cache::Important\&.
253
Affiche la totalit� des champs d'information sur le paquet lors d'une
255
�l�ment de configuration\~: APT::Cache::ShowFull\&.
260
Affiche la totalit� des champs d'information pour toutes les versions
261
disponibles\~: c'est la valeur par d�faut. Pour la d�sactiver, utilisez
262
l'option \fB--no-all-versions\fR\&. Quand l'option \fB--no-all-versions\fR
263
est choisie, seuls les �l�ments de la version choisie (celle qui serait
264
install�e) seront affich�s.
265
Ctte option concerne seulement la commande show\&.
266
�l�ment de configuration\~: APT::Cache::AllVersions\&.
271
R�alise une mise � jour automatique du cache des paquets plut�t que de se
272
servir du cache actuel.
273
Pour d�sactiver cette option (option par d�faut), utiliser l'option
274
\fB--no-generate\fR\&.
275
�l�ment de configuration\~: APT::Cache::Generate\&.
280
N'effectue une recherche que sur les noms de paquets et pas sur les
281
descriptions longues.
282
�l�ment de configuration\~: APT::Cache::NamesOnly\&.
285
Avec cette option pkgnames affiche tous les noms, les noms des
286
paquets virtuels et les d�pendances manquantes.
287
�l�ment de configuration\~: APT::Cache::AllNames\&.
290
Avec cette option depends et rdepends sont r�cursives de
291
mani�re � n'afficher qu'une seule fois les paquets mentionn�s.
292
�l�ment de configuration\~: APT::Cache::RecurseDepends\&.
295
Cette option limite la sortie de depends et de rdepends
296
aux paquets qui sont actuellement install�s.
297
�l�ment de configuration\~: APT::Cache::Installed\&.
302
Affiche un mode d'emploi succinct.
307
Affiche la version du programme.
312
Fichier de configuration\~; indique quel fichier de configuration utiliser.
313
Le programme lit le fichier de configuration par d�faut, puis celui-ci.
314
Voyez \fB\fIapt.conf\fB\fR(5)
320
Donne une option de configuration\~; cela fixe une option de configuration
321
arbitraire. La syntaxe est : \fB-o Foo::Bar=bar\fR\&.
324
\fB\fI/etc/apt/sources.list\fB\fR
325
Emplacements o� aller chercher les paquets.
326
�l�ment de configuration\~: Dir::Etc::SourceList\&.
328
\fB\fI/var/lib/apt/lists/\fB\fR
329
Zone de stockage pour les informations qui concernent chaque ressource de
330
paquet sp�cifi�e dans \fB\fIsources.list\fB\fR(5)
331
�l�ment de configuration\~: Dir::State::Lists\&.
333
\fB\fI/var/lib/apt/lists/partial/\fB\fR
334
Zone de stockage pour les informations en transit.
335
�l�ment de configuration\~: Dir::State::Lists (partial est implicite).
338
\fB\fIapt.conf\fB\fR(5)
339
, \fB\fIsources.list\fB\fR(5)
343
\fBapt-cache\fR retourne z�ro apr�s un d�roulement normal, et le nombre
344
d�cimal 100 en cas d'erreur.
347
Voyez la page concernant les bogues de APT <URL:http://bugs.debian.org/src:apt>\&.
348
Si vous voulez rapporter un bogue, consultez le texte
349
\fI/usr/share/doc/debian/bug-reporting.txt\fR ou utilisez la
350
commande \fBreportbug\fR(1)
354
APT a �t� �crit par l'�quipe APT <apt@packages.debian.org>\&.
357
J�r�me Marant. 2000\~; mise � jour : Philippe Batailler. 2004.
added
removed
doc/fr/apt-cache.fr.8
