1
<!-- -*- mode: sgml; mode: fold -*- -->
2
<!-- translation of version 1.4 -->
3
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
5
<!ENTITY % aptent SYSTEM "apt.ent.fr">
14
<refentrytitle>apt-cache</>
18
<!-- Man page title -->
21
<refpurpose>Gestion des paquets et manipulation du cache par APT</>
28
<arg><option>-hvs</></arg>
29
<arg><option>-o=<replaceable/option de configuration/</></arg>
30
<arg><option>-c=<replaceable/fichier/</></arg>
32
<arg>add <arg choice="plain" rep="repeat"><replaceable>fichier</replaceable></arg></arg>
34
<arg>showpkg <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
39
<arg>search <arg choice="plain"><replaceable>regex</replaceable></arg></arg>
40
<arg>show <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
41
<arg>showpkg <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
42
<arg>depends <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
43
<arg>pkgnames <arg choice="plain"><replaceable>prefix</replaceable></arg></arg>
44
<arg>dotty <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
49
<RefSect1><Title>Description</>
51
<command/apt-cache/ r�alise diff�rentes op�rations sur le cache de paquet d'
52
APT. <command/apt-cache/ ne manipule pas l'�tat du syst�me mais fournit des
53
moyens de recherche dans les m�tadonn�es d'un paquet desquelles il extrait
54
d'int�ressantes informations.
57
� moins que l'option <option>-h</> ou <option>--help</> ne soit donn�e, l'une
58
des commandes suivantes doit �tre pr�sente.
61
<VarListEntry><Term>add</Term>
63
La commande <literal/add/ ajoute les fichiers donn�s en argument au cache des
67
<VarListEntry><Term>gencaches</Term>
69
La commande <literal/gencaches/ fait la m�me chose que
70
<command/apt-get check/. Elle construit les caches de source et de paquet �
71
partir des sources r�pertori�es dans &sources-list; et dans
72
<filename>/var/lib/dpkg/status</>.
75
<VarListEntry><Term>showpkg</Term>
77
La commande <literal/showpkg/ affiche des informations sur les paquets donn�s
78
en argument. Les arguments restants sont les noms de paquets. Les versions
79
disponibles et les d�pendances inverses de chaque paquet r�pertori� sont
80
list�es, ainsi que les d�pendances normales pour chaque version. Les d�pendances
81
normales d'un paquet sont constitu�es par les paquets dont il d�pend ; les
82
d�pendances inverses sont les paquets qui d�pendent du paquet en question.
83
Les d�pendances normales doivent donc �tre satisfaites et les d�pendances
84
inverses n'ont pas besoin de l'�tre. Ainsi, la commande
85
<command>apt-cache showpkg libreadline2</> donnerait ce r�sultat :
87
<informalexample><programlisting>
89
Versions: 2.1-12(/var/state/apt/lists/foo_Packages),
91
libreadlineg2,libreadline2
92
libreadline2-altdev,libreadline2
94
2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
98
</programlisting></informalexample>
101
On peut voir que libreadline2, version 2.1-8, d�pend de libc5, ncurses3.0, et
102
ldso ; ces paquets doivent �tre install�s au pr�alable pour que libreadline2
103
fonctionne. � leur tour, libreadlineg2 et libreadline2-altdev d�pendent de
104
libreadline2. Si libreadline2 est install�, libc5, ncurses3.0 et ldso doivent
105
�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
109
<VarListEntry><Term>stats</Term>
111
La commande <literal/stats/ affiche des statistiques � propos du cache. Aucun
112
autre argument n'est attendu. Voici les informations rapport�es :
115
<literal/Total package names/ est le nombre de paquets trouv�s dans le cache.
119
<literal/Normal packages/ est le nombre de paquets simples, ordinaires ; ces
120
paquets tol�rent une correspondance bijective entre leur nom et le nom utilis�
121
par d'autres paquets pour les qualifier comme d�pendance. La majorit� des
122
paquets appartient � cette cat�gorie.
126
<literal/Pure virtual packages/ est le nombre des paquets qui n'existent que
127
sous la forme d'un nom repr�sentant un paquet virtuel ; ces paquets
128
� fournissent � seulement un nom de paquet virtuel et aucun paquet
129
n'utilise v�ritablement ce nom. Par exemple, au sein du syst�me Debian
130
GNU-Linux, le nom � mail-transport-agent � est un paquet virtuel pur ;
131
plusieurs paquets peuvent � remplir � ce nom � mail-transport-agent �, mais il
132
n'existe aucun paquet nomm� � mail-transport-agent �.
136
<literal/Single virtual packages/ est le nombre de paquets virtuels qui ne
137
peuvent �tre remplis que par un seul paquet. Par exemple, au sein du syst�me
138
Debian GNU-Linux, � X11-text-viewer � est un paquet virtuel ; seul le paquet
139
� xless � remplit � X11-text-viewer �.
143
<literal/Mixed virtual packages/ est le nombre des paquets qui remplissent un
144
paquet virtuel particulier et/ou dont le nom est un nom de paquet virtuel.
145
Par exemple, au sein du syst�me Debian GNU-Linux, � debconf � est
146
un paquet r�el et il est aussi rempli par � debconf-tiny �.
150
<literal/Missing/ est le nombre de paquets r�f�renc�s dans une
151
d�pendance mais qui ne sont fournis par aucun paquet. Les paquets manquants
152
peuvent �tre mis en �vidence quand on n'acc�de pas � une distribution compl�te
153
ou si un paquet (r�el ou virtuel) a �t� abandonn� par une distribution.
154
Habituellement on les trouve dans les champs � Conflicts �.
158
<literal/Total distinct/ versions est le nombre de versions de paquets trouv�es
159
dans le cache ; cette valeur est par cons�quent au moins �gale au nombre total
160
de paquets. Quand on acc�de � plus d'une distribution (� stable � et
161
� unstable �, par exemple), cette valeur peut �tre consid�rablement plus
162
grande que le nombre total de paquets.
166
<literal/Total dependencies/ est le nombre de relations de d�pendances
167
d�clar�es par tous les paquets pr�sents dans le cache.
172
<VarListEntry><Term>dump</Term>
174
La commande <literal/dump/ affiche un court r�sum� sur chaque paquet du cache.
175
Elle est d'abord destin�e au d�bogage.
178
<VarListEntry><Term>dumpavail</Term>
180
La commande <literal/dumpavail/ affiche sur la sortie standard une liste des
181
paquets disponibles. Elle convient � une utilisation avec &dpkg; et la
182
m�thode &dselect; s'en sert.
185
<VarListEntry><Term>unmet</Term>
187
La commande <literal/unmet/ affiche un r�sum� concernant toutes les
188
d�pendances absentes dans le cache de paquets.
191
<VarListEntry><Term>show</Term>
193
La commande <literal/show/ est semblable � <literal/dpkg --print-avail/ ;
194
elle affiche des informations sur les paquets donn�s en argument.
197
<VarListEntry><Term>search</Term>
199
La commande <literal/search/ recherche l'expression r�guli�re donn�e en
200
argument sur tous les paquets disponibles. Elle cherche une occurrence de la
201
cha�ne dans les noms de paquets et dans les descriptions puis elle affiche
202
le nom du paquet et sa description courte. Quand on donne l'option
203
<option/--full/, la sortie est identique � <literal/show/ pour chaque
204
paquet ; l'option <option/--names-only/ ne recherche pas la cha�ne
205
dans les descriptions longues mais seulement dans les noms de paquets.
207
On peut utiliser des arguments distincts pour indiquer des expressions
208
r�guli�res diff�rentes sur lesquelles sera r�alis� un � et � logique.
211
<VarListEntry><Term>depends</Term>
213
La commande <literal/depends/ affiche la liste de toutes les d�pendances
214
d'un paquet et la liste de tous les paquets possibles qui satisfont ces
218
<VarListEntry><Term>pkgnames</Term>
220
Cette commande affiche le nom de chaque paquet du syst�me. Un pr�fixe pour
221
filtrer la liste des noms peut �tre donn� en argument. La sortie est
222
appropri�e � une utilisation au sein d'une fonction compl�te de shell ; elle
223
est produite tr�s rapidement. On utilise au mieux cette commande avec
224
l'option <option/--generate/.
227
<VarListEntry><Term>dotty</Term>
229
La commande <literal/dotty/ prend une liste de paquets sur la ligne de commande
230
et affiche une sortie appropri�e � une utilisation par dotty avec le paquet
231
<ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphVis</>.
232
Il en r�sulte un ensemble de noeuds et d'arcs repr�sentant les relations
233
entre les paquets. Par d�faut les paquets donn�s en argument suivent toutes
234
leurs d�pendances, ce qui peut produire un graphe tr�s volumineux. On peut
235
d�sactiver ce comportement en positionnant l'option
236
<literal>APT::Cache::GivenOnly</literal>.
239
Les noeuds r�sultants ont plusieurs formes ; les paquets normaux sont
240
des bo�tes, les � provides � purs sont des triangles,
241
les � provides � mixtes sont des diamants et les paquets manquants
242
sont des hexagones. Les bo�tes oranges expriment un arr�t de la r�cursivit�
243
[paquet feuille], les lignes bleues repr�sentent des pr�d�pendances et les
244
lignes vertes repr�sentent des conflits.
247
Attention, dotty ne peut pas repr�senter des ensembles de paquets
253
<RefSect1><Title>Options</>
257
<VarListEntry><term><option/-p/</><term><option/--pkg-cache/</>
259
Indique le fichier servant de cache des paquets. Le cache des paquets est
260
le cache primaire utilis� par toutes les op�rations.
261
�l�ment de configuration : <literal/Dir::Cache::pkgcache/.
264
<VarListEntry><term><option/-s/</><term><option/--src-cache/</>
266
Indique le fichier servant de cache des sources. Ce cache n'est utilis� que
267
par <literal/gencaches/ ; une version des informations sur les paquets,
268
faite � partir d'une analyse de sources distantes, est conserv�e. Quand le
269
cache des paquets est cr�e, le cache de sources est utilis� afin d'�viter
270
d'analyser � nouveau tous les paquets.
271
�l�ment de configuration : <literal/Dir::Cache::srcpkgcache/.
274
<VarListEntry><term><option/-q/</><term><option/--quiet/</>
276
Mode silencieux ; produit une sortie pertinente pour l'enregistrement dans un
277
fichier journal, sans afficher d'indicateur de progression. Un plus grand
278
nombre de q produira un plus grand silence, avec un maximum de 2. Vous pouvez
279
aussi utiliser <option/-q=#/ pour positionner le niveau de silence, annulant
280
le fichier de configuration.
281
�l�ment de configuration : <literal/quiet/.
284
<VarListEntry><term><option/-i/</><term><option/--important/</>
286
N'affiche que les d�pendances importantes ; � utiliser avec la commande
287
unmet pour n'afficher que les relations Depends et Pre-Depends.
288
�l�ment de configuration : <literal/APT::Cache::Important/.
291
<VarListEntry><term><option/-f/</><term><option/--full/</>
293
Affiche la totalit� des champs d'information sur le paquet lors d'une
295
�l�ment de configuration : <literal/APT::Cache::ShowFull/.
298
<VarListEntry><term><option/-a/</><term><option/--all-versions/</>
300
Affiche la totalit� des champs d'information pour toutes les versions
301
disponibles : cette option concerne seulement la commande show.
302
�l�ment de configuration : <literal/APT::Cache::AllVersions/.
305
<VarListEntry><term><option/-g/</><term><option/--generate/</>
307
R�alise une mise � jour automatique du cache des paquets plut�t que de se
308
servir du cache actuel.
309
Pour d�sactiver cette option (option par d�faut), utiliser l'option
310
<option/--no-generate/.
311
�l�ment de configuration : <literal/APT::Cache::Generate/.
314
<VarListEntry><term><option/--names-only/</>
316
N'effectue une recherche que sur les noms de paquets et non sur les
317
descriptions longues.
318
�l�ment de configuration : <literal/APT::Cache::NamesOnly/.
321
<VarListEntry><term><option/--all-names/</>
323
Avec cette option <literal/pkgnames/ affiche tous les noms, les noms des
324
paquets virtuels et les d�pendances manquantes.
325
�l�ment de configuration : <literal/APT::Cache::AllNames/.
328
<VarListEntry><term><option/--recurse/</>
330
Avec cette option <literal/depends/ est r�cursive de mani�re � n'afficher
331
qu'une seule fois les paquets mentionn�s.
332
�l�ment de configuration : <literal/APT::Cache::RecurseDepends/.
340
<RefSect1><Title>Fichiers</>
342
<VarListEntry><term><filename>/etc/apt/sources.list</></term>
344
Emplacements o� aller chercher les paquets.
345
�l�ment de configuration : <literal/Dir::Etc::SourceList/.
348
<VarListEntry><term><filename>&statedir;/lists/</></term>
350
Zone de stockage pour les informations qui concernent chaque ressource de
351
paquet sp�cifi�e dans &sources-list;
352
�l�ment de configuration : <literal/Dir::State::Lists/.
355
<VarListEntry><term><filename>&statedir;/lists/partial/</></term>
357
Zone de stockage pour les informations en transit.
358
�l�ment de configuration : <literal/Dir::State::Lists/ (partial est implicite).
363
<RefSect1><Title>Voir aussi</>
365
&apt-conf;, &sources-list;, &apt-get;
368
<RefSect1><Title>Diagnostics</>
370
<command/apt-cache/ retourne z�ro apr�s un d�roulement normal, et le nombre
371
d�cimal 100 en cas d'erreur.
b'\\ No newline at end of file'