summaryrefslogtreecommitdiff
path: root/doc/fr/apt-cache.fr.8.sgml
blob: ea66016173b82c810a20c2da4e1fdec6c4dd0f34 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
<!-- -*- mode: sgml; mode: fold -*- -->
<!-- translation of version 1.17 -->
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [

<!ENTITY % aptent SYSTEM "apt.ent.fr">
%aptent;

]>

<refentry lang="fr">
 &apt-docinfo;
 
 <refmeta>
   <refentrytitle>apt-cache</>
   <manvolnum>8</>
 </refmeta>
 
 <!-- Man page title -->
 <refnamediv>
    <refname>apt-cache</>
    <refpurpose>Gestion des paquets et manipulation du cache par APT</>
 </refnamediv>

 <!-- Arguments -->
 <refsynopsisdiv>
   <cmdsynopsis>
      <command>apt-cache</>
      <arg><option>-hvs</></arg>
      <arg><option>-o=<replaceable/option de configuration/</></arg>
      <arg><option>-c=<replaceable/fichier/</></arg>
      <group choice=req>
         <arg>add <arg choice="plain" rep="repeat"><replaceable>fichier</replaceable></arg></arg>
         <arg>gencaches</>
         <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>showsrc <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>stats</>
         <arg>dump</>
         <arg>dumpavail</>
         <arg>unmet</>
         <arg>search <arg choice="plain"><replaceable>regex</replaceable></arg></arg>
         <arg>show <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>depends <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>rdepends <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>pkgnames <arg choice="plain"><replaceable>prefix</replaceable></arg></arg>
         <arg>dotty <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
         <arg>policy <arg choice="plain" rep="repeat"><replaceable>paquets</replaceable></arg></arg>
         <arg>madison <arg choice="plain" rep="repeat"><replaceable>paquets</replaceable></arg></arg>
      </group>   
   </cmdsynopsis>
 </refsynopsisdiv>
 
 <RefSect1><Title>Description</>
   <para>
<command/apt-cache/ r�alise diff�rentes op�rations sur le cache de paquet d' 
APT. <command/apt-cache/ ne manipule pas l'�tat du syst�me mais fournit des
moyens de recherche dans les m�tadonn�es d'un paquet desquelles il extrait
d'int�ressantes informations.

   <para>
� moins que l'option <option>-h</> ou <option>--help</> ne soit donn�e, l'une 
des commandes suivantes doit �tre pr�sente.

   <VariableList>
     <VarListEntry><Term>add <replaceable/fichier(s)/</Term>
     <ListItem><Para>
La commande <literal/add/ ajoute des fichiers indexant des paquets au cache des
paquets. Cela sert uniquement pour le d�bogage.
     </VarListEntry>
     
     <VarListEntry><Term>gencaches</Term>
     <ListItem><Para>
La commande <literal/gencaches/ fait la m�me chose que 
<command/apt-get check/. Elle construit les caches des sources et des paquets 
� partir des sources r�pertori�es dans &sources-list; et dans 
<filename>/var/lib/dpkg/status</>.
     </VarListEntry>

     <VarListEntry><Term>showpkg <replaceable/paquet(s)/</Term>
     <ListItem><Para>
La commande <literal/showpkg/ affiche des informations sur les paquets donn�s
en argument. Les arguments restants sont les noms de paquets. Les versions
disponibles et les d�pendances inverses de chaque paquet r�pertori� sont 
list�es, ainsi que les d�pendances normales pour chaque version. Les 
d�pendances normales d'un paquet sont constitu�es par les paquets dont il 
d�pend&nbsp;; les
d�pendances inverses sont les paquets qui d�pendent du paquet en question.
Les d�pendances normales doivent donc �tre satisfaites et les d�pendances
inverses n'ont pas besoin de l'�tre. Ainsi, la commande 
<command>apt-cache showpkg libreadline2</> donnerait ce r�sultat&nbsp;:
     
<informalexample><programlisting>
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: 
</programlisting></informalexample>
			    
     <para>
On peut voir que libreadline2, version 2.1-8, d�pend de libc5, ncurses3.0, et 
ldso&nbsp;; ces paquets doivent �tre install�s au pr�alable pour que 
libreadline2 fonctionne. � leur tour, libreadlineg2 et libreadline2-altdev 
d�pendent de libreadline2. Si libreadline2 est install�, libc5 et ncurses3.0 (et 
ldso) doivent �tre install�s&nbsp;; 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 source d'APT.
     </VarListEntry>

     <VarListEntry><Term>stats</Term>
     <ListItem><Para>
La commande <literal/stats/ affiche des statistiques � propos du cache. Aucun
autre argument n'est attendu. Voici les informations rapport�es&nbsp;:
     <itemizedlist>
       <listitem><para>
<literal/Total package names/ est le nombre de paquets trouv�s dans le cache.
       </listitem>
       
       <listitem><para>
<literal/Normal packages/ est le nombre de paquets simples, 
ordinaires&nbsp;; ces paquets tol�rent une correspondance bijective entre 
leur nom et le nom utilis� par les autres paquets pour les qualifier comme 
d�pendance. La majorit� des paquets appartient � cette cat�gorie.
       </listitem>

       <listitem><para>
<literal/Pure virtual packages/ est le nombre des paquets qui n'existent que 
sous la forme d'un nom repr�sentant un paquet virtuel&nbsp;; ces paquets 
�&nbsp;fournissent&nbsp;� seulement un nom de paquet virtuel et aucun paquet
n'utilise v�ritablement ce nom. Par exemple, au sein du syst�me Debian 
GNU/Linux, le nom �&nbsp;mail-transport-agent&nbsp;� est un paquet virtuel 
pur&nbsp;; plusieurs paquets peuvent �&nbsp;remplir&nbsp;� ce nom 
�&nbsp;mail-transport-agent&nbsp;�, mais il
n'existe aucun paquet nomm� �&nbsp;mail-transport-agent&nbsp;�.
       </listitem>
   
       <listitem><para>
<literal/Single virtual packages/ est le nombre de paquets virtuels qui ne
peuvent �tre remplis que par un seul paquet. Par exemple, au sein du syst�me
Debian GNU/Linux, �&nbsp;X11-text-viewer&nbsp;� est un paquet virtuel&nbsp;; 
seul le paquet �&nbsp;xless&nbsp;� remplit �&nbsp;X11-text-viewer&nbsp;�.
       </listitem>

       <listitem><para>
<literal/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 syst�me Debian GNU/Linux, �&nbsp;debconf&nbsp;� est 
un paquet r�el et il est aussi fourni par �&nbsp;debconf-tiny&nbsp;�.
       </listitem>
   
       <listitem><para>
<literal/Missing/ est le nombre de paquets r�f�renc�s dans une
d�pendance mais qui ne sont fournis par aucun paquet. Les paquets manquants
peuvent �tre mis en �vidence quand on n'acc�de pas � une distribution compl�te
ou si un paquet (r�el ou virtuel) a �t� sorti d'une distribution.
Habituellement on les trouve dans les champs �&nbsp;Conflicts&nbsp;�.
       </listitem>

       <listitem><para>
<literal/Total distinct/ versions est le nombre de versions de paquets trouv�es
dans le cache&nbsp;; cette valeur est par cons�quent au moins �gale au 
nombre total de paquets. Quand on acc�de � plus d'une distribution 
(�&nbsp;stable&nbsp;� et �&nbsp;unstable&nbsp;�, par exemple), cette valeur 
peut �tre consid�rablement plus grande que le nombre total de paquets.
       </listitem>

       <listitem><para>
<literal/Total dependencies/ est le nombre de relations de d�pendances 
d�clar�es par tous les paquets pr�sents dans le cache.
       </listitem>
     </itemizedlist>
     </VarListEntry>

     <VarListEntry><Term>showsrc <replaceable/paquet(s)/</Term>
     <ListItem><Para>
     <literal/showsrc/ affiche toutes les entr�es de paquet-source qui
correspondent aux noms donn�s. Toutes les versions sont affich�es et toutes
les entr�es qui d�clarent que ces noms correspondent � des paquets binaires.
     </VarListEntry>

     
     <VarListEntry><Term>dump</Term>
     <ListItem><Para>
La commande <literal/dump/ affiche un court r�sum� sur chaque paquet du cache.
Elle est d'abord destin�e au d�bogage.
     </VarListEntry>

     <VarListEntry><Term>dumpavail</Term>
     <ListItem><Para>
La commande <literal/dumpavail/ affiche sur la sortie standard une liste des
paquets disponibles. Elle convient � une utilisation avec &dpkg; et la
m�thode &dselect; s'en sert.
     </VarListEntry>

     <VarListEntry><Term>unmet</Term>
     <ListItem><Para>
La commande <literal/unmet/ affiche un r�sum� concernant toutes les 
d�pendances absentes dans le cache de paquets.
     </VarListEntry>

     <VarListEntry><Term>show <replaceable/paquet(s)/</Term>
     <ListItem><Para>
La commande <literal/show/ est semblable � <literal/dpkg --print-avail/&nbsp;;
elle affiche des informations sur les paquets donn�s en argument.
     </VarListEntry>

     <VarListEntry><Term>search <replaceable/regex [ regex ... ]/</Term>
     <ListItem><Para>
La commande <literal/search/ recherche l'expression r�guli�re donn�e en
argument sur tous les paquets disponibles. Elle cherche une occurrence de la 
cha�ne 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
<option/--full/, la sortie est identique � <literal/show/ pour chaque 
paquet&nbsp;; l'option <option/--names-only/ ne recherche pas la cha�ne 
dans les descriptions longues mais seulement dans les noms de paquets.
<para>
On peut utiliser des arguments distincts pour indiquer des expressions
r�guli�res diff�rentes sur lesquelles sera r�alis� un �&nbsp;et&nbsp;� logique.
     </VarListEntry>

     <VarListEntry><Term>depends <replaceable/paquet(s)/</Term>
     <ListItem><Para>
La commande <literal/depends/ affiche la liste de toutes les d�pendances
d'un paquet et la liste de tous les paquets possibles qui satisfont ces
d�pendances.
     </VarListEntry>

     <VarListEntry><Term>rdepends <replaceable/paquet(s)/</Term>
     <ListItem><Para>
La commande <literal/rdepends/ affiche la liste de toutes les d�pendances inverses
d'un paquet.
      </VarListEntry>

     <VarListEntry><Term>pkgnames <replaceable/[ prefix ]/ </Term>
     <ListItem><Para>
Cette commande affiche le nom de chaque paquet du syst�me. Un pr�fixe pour
filtrer la liste des noms peut �tre donn� en argument. La sortie est
appropri�e � une utilisation au sein d'une fonction compl�te de shell&nbsp;; 
elle est produite tr�s rapidement. On utilise au mieux cette commande avec
l'option <option/--generate/.
     </VarListEntry>
     
     <VarListEntry><Term>dotty <replaceable/paquet(s)/</Term>
     <ListItem><Para>
La commande <literal/dotty/ prend une liste de paquets sur la ligne de commande
et affiche une sortie appropri�e � une utilisation par dotty avec le paquet
<ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphViz</>.
Il en r�sulte un ensemble de noeuds et d'arcs repr�sentant les relations 
entre les paquets. Par d�faut les paquets donn�s en argument suivent toutes
leurs d�pendances, ce qui peut produire un graphe tr�s volumineux. 
Pour limiter la sortie aux paquets list�s sur la ligne de commande, positionnez
l'option <literal>APT::Cache::GivenOnly</>.
	      </para>
<para>
Les noeuds r�sultants ont plusieurs formes&nbsp;; les paquets normaux sont 
des bo�tes, les �&nbsp;provides&nbsp;� purs sont des triangles, 
les �&nbsp;provides&nbsp;� mixtes sont des diamants et les paquets manquants 
sont des hexagones. Les bo�tes oranges expriment un arr�t de la r�cursivit� 
[paquet feuille], les lignes bleues repr�sentent des pr�d�pendances et les 
lignes vertes repr�sentent des conflits.
	    </para>
     <para>
Attention, dotty ne peut pas repr�senter des ensembles de paquets
plus volumineux.
     </VarListEntry>

     <VarListEntry><Term>policy <replaceable/[ paquet(s) ]/</Term>
     <ListItem><Para>
     <literal/policy/ sert � d�boguer des probl�mes relatifs au fichier des
pr�f�rences. Sans argument, la commande affiche la priorit� de chaque source.
Sinon, elle affiche des informations pr�cises sur la priorit� du paquet donn�
en argument.
     </VarListEntry>

     <VarListEntry><Term>madison <replaceable/[ paquet(s) ]/</Term>
     <ListItem><Para>

     La commande <literal/madison/ d'<literal/apt-cache/ cherche � mimer le
format de sortie propre � l'outil debian de gestion d'archives, 
<literal/madison/, ainsi qu'une part de ses fonctionnalit�s. Elle affiche les
versions disponibles d'un paquet dans un tableau. Contrairement au programme
original <literal/madison/, elle n'affiche que des informations qui cocernent 
l'architecture pour laquelle Apt a lu la liste des paquets disponibles
(<literal/APT::Architecture/).
     </VarListEntry>

  </VariableList>
 </RefSect1>
 
 <RefSect1><Title>Options</>
   &apt-cmdblurb;
   
   <VariableList>
     <VarListEntry><term><option/-p/</><term><option/--pkg-cache/</>
     <ListItem><Para>
Indique le fichier servant de cache des paquets. Le cache des paquets est
le cache primaire utilis� par toutes les op�rations.
�l�ment de configuration&nbsp;: <literal/Dir::Cache::pkgcache/.
     </VarListEntry>

     <VarListEntry><term><option/-s/</><term><option/--src-cache/</>
     <ListItem><Para>
Indique le fichier servant de cache des sources. Ce cache n'est utilis� que 
par <literal/gencaches/&nbsp;; une version des informations sur les paquets,
faite � partir d'une analyse de sources distantes, est conserv�e. Quand le 
cache des paquets est cr��, le cache des sources est utilis� afin d'�viter 
d'analyser � nouveau tous les paquets.
�l�ment de configuration&nbsp;: <literal/Dir::Cache::srcpkgcache/.
     </VarListEntry>

     <VarListEntry><term><option/-q/</><term><option/--quiet/</>
     <ListItem><Para>
Mode silencieux&nbsp;; 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 <option/-q=#/ pour positionner le niveau de silence, 
annulant le fichier de configuration.
�l�ment de configuration&nbsp;: <literal/quiet/.
     </VarListEntry>

     <VarListEntry><term><option/-i/</><term><option/--important/</>
     <ListItem><Para>
N'affiche que les d�pendances importantes&nbsp;; � utiliser avec la commande
unmet pour n'afficher que les relations Depends et Pre-Depends.
�l�ment de configuration&nbsp;: <literal/APT::Cache::Important/.
     </VarListEntry>

     <VarListEntry><term><option/-f/</><term><option/--full/</>
     <ListItem><Para>
Affiche la totalit� des champs d'information sur le paquet lors d'une
recherche.
�l�ment de configuration&nbsp;: <literal/APT::Cache::ShowFull/.
     </VarListEntry>

     <VarListEntry><term><option/-a/</><term><option/--all-versions/</>
     <ListItem><Para>
Affiche la totalit� des champs d'information pour toutes les versions
disponibles&nbsp;: c'est la valeur par d�faut. Pour la d�sactiver, utilisez
l'option <option/--no-all-versions/. Quand l'option <option/--no-all-versions/
est choisie, seuls les �l�ments de la version choisie (celle qui serait 
install�e) seront affich�s.
Ctte option concerne seulement la commande <literal/show/.
�l�ment de configuration&nbsp;: <literal/APT::Cache::AllVersions/.
     </VarListEntry>

     <VarListEntry><term><option/-g/</><term><option/--generate/</>
     <ListItem><Para>
R�alise une mise � jour automatique du cache des paquets plut�t que de se
servir du cache actuel.
Pour d�sactiver cette option (option par d�faut), utiliser l'option
<option/--no-generate/.
�l�ment de configuration&nbsp;: <literal/APT::Cache::Generate/.
     </VarListEntry>

 <VarListEntry><term><option/--names-only/</><term><option/-n/</>
     <ListItem><Para>
N'effectue une recherche que sur les noms de paquets et pas sur les
descriptions longues.
�l�ment de configuration&nbsp;: <literal/APT::Cache::NamesOnly/.
     </VarListEntry>

     <VarListEntry><term><option/--all-names/</>
     <ListItem><Para>
Avec cette option <literal/pkgnames/ affiche tous les noms, les noms des
paquets virtuels et les d�pendances manquantes.
�l�ment de configuration&nbsp;: <literal/APT::Cache::AllNames/.
     </VarListEntry>

     <VarListEntry><term><option/--recurse/</>
     <ListItem><Para>
Avec cette option <literal/depends/ et <literal/rdepends/ sont r�cursives de 
mani�re � n'afficher qu'une seule fois les paquets mentionn�s.
�l�ment de configuration&nbsp;: <literal/APT::Cache::RecurseDepends/.
     </VarListEntry>

     <VarListEntry><term><option/--installed/</>
     <ListItem><Para>
Cette option limite la sortie de <literal/depends/ et de <literal/rdepends/ 
aux paquets qui sont actuellement install�s.
�l�ment de configuration&nbsp;: <literal/APT::Cache::Installed/.
     </VarListEntry>

     &apt-commonoptions;
     
   </VariableList>
 </RefSect1>

 <RefSect1><Title>Fichiers</>
   <variablelist>
     <VarListEntry><term><filename>/etc/apt/sources.list</></term>
     <ListItem><Para>
Emplacements o� aller chercher les paquets.
�l�ment de configuration&nbsp;: <literal/Dir::Etc::SourceList/.
     </VarListEntry>
     
     <VarListEntry><term><filename>&statedir;/lists/</></term>
     <ListItem><Para>
Zone de stockage pour les informations qui concernent chaque ressource de
paquet sp�cifi�e dans &sources-list;
�l�ment de configuration&nbsp;: <literal/Dir::State::Lists/.
     </VarListEntry>
  
     <VarListEntry><term><filename>&statedir;/lists/partial/</></term>
     <ListItem><Para>
Zone de stockage pour les informations en transit.
�l�ment de configuration&nbsp;: <literal/Dir::State::Lists/ (partial est implicite).
     </VarListEntry>     
   </variablelist>
 </RefSect1>

 <RefSect1><Title>Voir aussi</>
   <para>
   &apt-conf;, &sources-list;, &apt-get;
 </RefSect1>

 <RefSect1><Title>Diagnostics</>
   <para>
<command/apt-cache/ retourne z�ro apr�s un d�roulement normal, et le nombre 
d�cimal 100 en cas d'erreur.
 </RefSect1>

 &manbugs;
 &manauthor;
 &deux-traducteurs;
</refentry>