- initial import of revision 374 from cnc
[apt.git] / doc / fr / apt-cache.fr.8.sgml
1 <!-- -*- mode: sgml; mode: fold -*- -->
2 <!-- translation of version 1.10 -->
3 <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
4
5 <!ENTITY % aptent SYSTEM "apt.ent.fr">
6 %aptent;
7
8 ]>
9
10 <refentry lang=fr>
11  &apt-docinfo;
12  
13  <refmeta>
14    <refentrytitle>apt-cache</>
15    <manvolnum>8</>
16  </refmeta>
17  
18  <!-- Man page title -->
19  <refnamediv>
20     <refname>apt-cache</>
21     <refpurpose>Gestion des paquets et manipulation du cache par APT</>
22  </refnamediv>
23
24  <!-- Arguments -->
25  <refsynopsisdiv>
26    <cmdsynopsis>
27       <command>apt-cache</>
28       <arg><option>-hvs</></arg>
29       <arg><option>-o=<replaceable/option de configuration/</></arg>
30       <arg><option>-c=<replaceable/fichier/</></arg>
31       <group choice=req>
32          <arg>add <arg choice="plain" rep="repeat"><replaceable>fichier</replaceable></arg></arg>
33          <arg>gencaches</>
34          <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
35          <arg>showsrc <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
36          <arg>stats</>
37          <arg>dump</>
38          <arg>dumpavail</>
39          <arg>unmet</>
40          <arg>search <arg choice="plain"><replaceable>regex</replaceable></arg></arg>
41          <arg>show <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
42          <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
43          <arg>depends <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
44          <arg>pkgnames <arg choice="plain"><replaceable>prefix</replaceable></arg></arg>
45          <arg>dotty <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
46          <arg>policy <arg choice="plain" rep="repeat"><replaceable>paquets</replaceable></arg></arg>
47       </group>   
48    </cmdsynopsis>
49  </refsynopsisdiv>
50  
51  <RefSect1><Title>Description</>
52    <para>
53 <command/apt-cache/ réalise différentes opérations sur le cache de paquet d' 
54 APT. <command/apt-cache/ ne manipule pas l'état du système mais fournit des
55 moyens de recherche dans les métadonnées d'un paquet desquelles il extrait
56 d'intéressantes informations.
57
58    <para>
59 À moins que l'option <option>-h</> ou <option>--help</> ne soit donnée, l'une 
60 des commandes suivantes doit être présente.
61
62    <VariableList>
63      <VarListEntry><Term>add</Term>
64      <ListItem><Para>
65 La commande <literal/add/ ajoute des fichiers indexant des paquets au cache des
66 paquets. Cela sert uniquement pour le débogage.
67      </VarListEntry>
68      
69      <VarListEntry><Term>gencaches</Term>
70      <ListItem><Para>
71 La commande <literal/gencaches/ fait la même chose que 
72 <command/apt-get check/. Elle construit les caches des sources et des paquets 
73 à partir des sources répertoriées dans &sources-list; et dans 
74 <filename>/var/lib/dpkg/status</>.
75      </VarListEntry>
76
77      <VarListEntry><Term>showpkg</Term>
78      <ListItem><Para>
79 La commande <literal/showpkg/ affiche des informations sur les paquets donnés
80 en argument. Les arguments restants sont les noms de paquets. Les versions
81 disponibles et les dépendances inverses de chaque paquet répertorié sont 
82 listées, ainsi que les dépendances normales pour chaque version. Les 
83 dépendances normales d'un paquet sont constituées par les paquets dont il 
84 dépend&nbsp;; les
85 dépendances inverses sont les paquets qui dépendent du paquet en question.
86 Les dépendances normales doivent donc être satisfaites et les dépendances
87 inverses n'ont pas besoin de l'être. Ainsi, la commande 
88 <command>apt-cache showpkg libreadline2</> donnerait ce résultat&nbsp;:
89      
90 <informalexample><programlisting>
91 Package: libreadline2
92 Versions: 2.1-12(/var/state/apt/lists/foo_Packages),
93 Reverse Depends: 
94   libreadlineg2,libreadline2
95   libreadline2-altdev,libreadline2
96 Dependencies:
97 2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
98 Provides:
99 2.1-12 - 
100 Reverse Provides: 
101 </programlisting></informalexample>
102                             
103      <para>
104 On peut voir que libreadline2, version 2.1-8, dépend de libc5, ncurses3.0, et 
105 ldso&nbsp;; ces paquets doivent être installés au préalable pour que 
106 libreadline2 fonctionne. À leur tour, libreadlineg2 et libreadline2-altdev 
107 dépendent de libreadline2. Si libreadline2 est installé, libc5, ncurses3.0 et 
108 ldso doivent être installés&nbsp;; libreadlineg2 et libreadline2-altdev 
109 n'ont pas à l'être. Pour connaître le sens de la fin de chaîne, il est 
110 préférable de consulter le code source d'APT.
111      </VarListEntry>
112
113      <VarListEntry><Term>stats</Term>
114      <ListItem><Para>
115 La commande <literal/stats/ affiche des statistiques à propos du cache. Aucun
116 autre argument n'est attendu. Voici les informations rapportées&nbsp;:
117      <itemizedlist>
118        <listitem><para>
119 <literal/Total package names/ est le nombre de paquets trouvés dans le cache.
120        </listitem>
121        
122        <listitem><para>
123 <literal/Normal packages/ est le nombre de paquets simples, 
124 ordinaires&nbsp;; ces paquets tolèrent une correspondance bijective entre 
125 leur nom et le nom utilisé par les autres paquets pour les qualifier comme 
126 dépendance. La majorité des paquets appartient à cette catégorie.
127        </listitem>
128
129        <listitem><para>
130 <literal/Pure virtual packages/ est le nombre des paquets qui n'existent que 
131 sous la forme d'un nom représentant un paquet virtuel&nbsp;; ces paquets 
132 «&nbsp;fournissent&nbsp;» seulement un nom de paquet virtuel et aucun paquet
133 n'utilise véritablement ce nom. Par exemple, au sein du système Debian 
134 GNU/Linux, le nom «&nbsp;mail-transport-agent&nbsp;» est un paquet virtuel 
135 pur&nbsp;; plusieurs paquets peuvent «&nbsp;remplir&nbsp;» ce nom 
136 «&nbsp;mail-transport-agent&nbsp;», mais il
137 n'existe aucun paquet nommé «&nbsp;mail-transport-agent&nbsp;».
138        </listitem>
139    
140        <listitem><para>
141 <literal/Single virtual packages/ est le nombre de paquets virtuels qui ne
142 peuvent être remplis que par un seul paquet. Par exemple, au sein du système
143 Debian GNU/Linux, «&nbsp;X11-text-viewer&nbsp;» est un paquet virtuel&nbsp;; 
144 seul le paquet «&nbsp;xless&nbsp;» remplit «&nbsp;X11-text-viewer&nbsp;».
145        </listitem>
146
147        <listitem><para>
148 <literal/Mixed virtual packages/ est le nombre des paquets qui remplissent un
149 paquet virtuel particulier ou dont le nom est un nom de paquet virtuel.
150 Par exemple, au sein du système Debian GNU/Linux, «&nbsp;debconf&nbsp;» est 
151 un paquet réel et il est aussi rempli par «&nbsp;debconf-tiny&nbsp;».
152        </listitem>
153    
154        <listitem><para>
155 <literal/Missing/ est le nombre de paquets référencés dans une
156 dépendance mais qui ne sont fournis par aucun paquet. Les paquets manquants
157 peuvent être mis en évidence quand on n'accède pas à une distribution complète
158 ou si un paquet (réel ou virtuel) a été sorti d'une distribution.
159 Habituellement on les trouve dans les champs «&nbsp;Conflicts&nbsp;».
160        </listitem>
161
162        <listitem><para>
163 <literal/Total distinct/ versions est le nombre de versions de paquets trouvées
164 dans le cache&nbsp;; cette valeur est par conséquent au moins égale au 
165 nombre total de paquets. Quand on accède à plus d'une distribution 
166 («&nbsp;stable&nbsp;» et «&nbsp;unstable&nbsp;», par exemple), cette valeur 
167 peut être considérablement plus grande que le nombre total de paquets.
168        </listitem>
169
170        <listitem><para>
171 <literal/Total dependencies/ est le nombre de relations de dépendances 
172 déclarées par tous les paquets présents dans le cache.
173        </listitem>
174      </itemizedlist>
175      </VarListEntry>
176
177      <VarListEntry><Term>showsrc</Term>
178      <ListItem><Para>
179      <literal/showsrc/ affiche toutes les entrées de paquet-source qui
180 correspondent aux noms donnés. Toutes les versions sont affichées et toutes
181 les entrées qui déclarent que ces noms correspondent à des paquets binaires.
182      </VarListEntry>
183
184      
185      <VarListEntry><Term>dump</Term>
186      <ListItem><Para>
187 La commande <literal/dump/ affiche un court résumé sur chaque paquet du cache.
188 Elle est d'abord destinée au débogage.
189      </VarListEntry>
190
191      <VarListEntry><Term>dumpavail</Term>
192      <ListItem><Para>
193 La commande <literal/dumpavail/ affiche sur la sortie standard une liste des
194 paquets disponibles. Elle convient à une utilisation avec &dpkg; et la
195 méthode &dselect; s'en sert.
196      </VarListEntry>
197
198      <VarListEntry><Term>unmet</Term>
199      <ListItem><Para>
200 La commande <literal/unmet/ affiche un résumé concernant toutes les 
201 dépendances absentes dans le cache de paquets.
202      </VarListEntry>
203
204      <VarListEntry><Term>show</Term>
205      <ListItem><Para>
206 La commande <literal/show/ est semblable à <literal/dpkg --print-avail/&nbsp;; 
207 elle affiche des informations sur les paquets donnés en argument.
208      </VarListEntry>
209
210      <VarListEntry><Term>search</Term>
211      <ListItem><Para>
212 La commande <literal/search/ recherche l'expression régulière donnée en
213 argument sur tous les paquets disponibles. Elle cherche une occurrence de la 
214 chaîne dans les noms de paquets et dans les descriptions puis elle affiche
215 le nom du paquet et sa description courte. Quand on donne l'option
216 <option/--full/, la sortie est identique à <literal/show/ pour chaque 
217 paquet&nbsp;; l'option <option/--names-only/ ne recherche pas la chaîne 
218 dans les descriptions longues mais seulement dans les noms de paquets.
219 <para>
220 On peut utiliser des arguments distincts pour indiquer des expressions
221 régulières différentes sur lesquelles sera réalisé un «&nbsp;et&nbsp;» logique.
222      </VarListEntry>
223
224      <VarListEntry><Term>depends</Term>
225      <ListItem><Para>
226 La commande <literal/depends/ affiche la liste de toutes les dépendances
227 d'un paquet et la liste de tous les paquets possibles qui satisfont ces
228 dépendances.
229      </VarListEntry>
230
231      <VarListEntry><Term>pkgnames</Term>
232      <ListItem><Para>
233 Cette commande affiche le nom de chaque paquet du système. Un préfixe pour
234 filtrer la liste des noms peut être donné en argument. La sortie est
235 appropriée à une utilisation au sein d'une fonction complète de shell&nbsp;; 
236 elle est produite très rapidement. On utilise au mieux cette commande avec
237 l'option <option/--generate/.
238      </VarListEntry>
239      
240      <VarListEntry><Term>dotty</Term>
241      <ListItem><Para>
242 La commande <literal/dotty/ prend une liste de paquets sur la ligne de commande
243 et affiche une sortie appropriée à une utilisation par dotty avec le paquet
244 <ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphViz</>.
245 Il en résulte un ensemble de noeuds et d'arcs représentant les relations 
246 entre les paquets. Par défaut les paquets donnés en argument suivent toutes
247 leurs dépendances, ce qui peut produire un graphe très volumineux. On peut
248 désactiver ce comportement en  positionnant l'option
249 <literal>APT::Cache::GivenOnly</literal>.
250               </para>
251 <para>
252 Les noeuds résultants ont plusieurs formes&nbsp;; les paquets normaux sont 
253 des boîtes, les «&nbsp;provides&nbsp;» purs sont des triangles, 
254 les «&nbsp;provides&nbsp;» mixtes sont des diamants et les paquets manquants 
255 sont des hexagones. Les boîtes oranges expriment un arrêt de la récursivité 
256 [paquet feuille], les lignes bleues représentent des prédépendances et les 
257 lignes vertes représentent des conflits.
258             </para>
259      <para>
260 Attention, dotty ne peut pas représenter des ensembles de paquets
261 plus volumineux.
262      </VarListEntry>
263
264      <VarListEntry><Term>policy</Term>
265      <ListItem><Para>
266      <literal/policy/ sert à déboguer des problèmes relatifs au fichier des
267 préférences. Sans argument, la commande affiche la priorité de chaque source.
268 Sinon, elle affiche des informations précises sur la priorité du paquet donné
269 en argument.
270      </VarListEntry>
271  
272   </VariableList>
273  </RefSect1>
274  
275  <RefSect1><Title>Options</>
276    &apt-cmdblurb;
277    
278    <VariableList>
279      <VarListEntry><term><option/-p/</><term><option/--pkg-cache/</>
280      <ListItem><Para>
281 Indique le fichier servant de cache des paquets. Le cache des paquets est
282 le cache primaire utilisé par toutes les opérations.
283 Élément de configuration&nbsp;: <literal/Dir::Cache::pkgcache/.
284      </VarListEntry>
285
286      <VarListEntry><term><option/-s/</><term><option/--src-cache/</>
287      <ListItem><Para>
288 Indique le fichier servant de cache des sources. Ce cache n'est utilisé que 
289 par <literal/gencaches/&nbsp;; une version des informations sur les paquets,
290 faite à partir d'une analyse de sources distantes, est conservée. Quand le 
291 cache des paquets est créé, le cache des sources est utilisé afin d'éviter 
292 d'analyser à nouveau tous les paquets.
293 Élément de configuration&nbsp;: <literal/Dir::Cache::srcpkgcache/.
294      </VarListEntry>
295
296      <VarListEntry><term><option/-q/</><term><option/--quiet/</>
297      <ListItem><Para>
298 Mode silencieux&nbsp;; produit une sortie pertinente pour l'enregistrement 
299 dans un fichier-journal, sans afficher d'indicateur de progression. Un plus 
300 grand nombre de q produira un plus grand silence, avec un maximum de 2. Vous 
301 pouvez aussi utiliser <option/-q=#/ pour positionner le niveau de silence, 
302 annulant le fichier de configuration.
303 Élément de configuration&nbsp;: <literal/quiet/.
304      </VarListEntry>
305
306      <VarListEntry><term><option/-i/</><term><option/--important/</>
307      <ListItem><Para>
308 N'affiche que les dépendances importantes&nbsp;; à utiliser avec la commande
309 unmet pour n'afficher que les relations Depends et Pre-Depends.
310 Élément de configuration&nbsp;: <literal/APT::Cache::Important/.
311      </VarListEntry>
312
313      <VarListEntry><term><option/-f/</><term><option/--full/</>
314      <ListItem><Para>
315 Affiche la totalité des champs d'information sur le paquet lors d'une
316 recherche.
317 Élément de configuration&nbsp;: <literal/APT::Cache::ShowFull/.
318      </VarListEntry>
319
320      <VarListEntry><term><option/-a/</><term><option/--all-versions/</>
321      <ListItem><Para>
322 Affiche la totalité des champs d'information pour toutes les versions
323 disponibles&nbsp;: cette option concerne seulement la commande show.
324 Élément de configuration&nbsp;: <literal/APT::Cache::AllVersions/.
325      </VarListEntry>
326
327      <VarListEntry><term><option/-g/</><term><option/--generate/</>
328      <ListItem><Para>
329 Réalise une mise à jour automatique du cache des paquets plutôt que de se
330 servir du cache actuel.
331 Pour désactiver cette option (option par défaut), utiliser l'option
332 <option/--no-generate/.
333 Élément de configuration&nbsp;: <literal/APT::Cache::Generate/.
334      </VarListEntry>
335
336      <VarListEntry><term><option/--names-only/</>
337      <ListItem><Para>
338 N'effectue une recherche que sur les noms de paquets et non sur les
339 descriptions longues.
340 Élément de configuration&nbsp;: <literal/APT::Cache::NamesOnly/.
341      </VarListEntry>
342
343      <VarListEntry><term><option/--all-names/</>
344      <ListItem><Para>
345 Avec cette option <literal/pkgnames/ affiche tous les noms, les noms des
346 paquets virtuels et les dépendances manquantes.
347 Élément de configuration&nbsp;: <literal/APT::Cache::AllNames/.
348      </VarListEntry>
349
350      <VarListEntry><term><option/--recurse/</>
351      <ListItem><Para>
352 Avec cette option <literal/depends/ est récursive de manière à n'afficher 
353 qu'une seule fois les paquets mentionnés.
354 Élément de configuration&nbsp;: <literal/APT::Cache::RecurseDepends/.
355      </VarListEntry>
356
357      &apt-commonoptions;
358      
359    </VariableList>
360  </RefSect1>
361
362  <RefSect1><Title>Fichiers</>
363    <variablelist>
364      <VarListEntry><term><filename>/etc/apt/sources.list</></term>
365      <ListItem><Para>
366 Emplacements où aller chercher les paquets.
367 Élément de configuration&nbsp;: <literal/Dir::Etc::SourceList/.
368      </VarListEntry>
369      
370      <VarListEntry><term><filename>&statedir;/lists/</></term>
371      <ListItem><Para>
372 Zone de stockage pour les informations qui concernent chaque ressource de
373 paquet spécifiée dans &sources-list;
374 Élément de configuration&nbsp;: <literal/Dir::State::Lists/.
375      </VarListEntry>
376   
377      <VarListEntry><term><filename>&statedir;/lists/partial/</></term>
378      <ListItem><Para>
379 Zone de stockage pour les informations en transit.
380 Élément de configuration&nbsp;: <literal/Dir::State::Lists/ (partial est implicite).
381      </VarListEntry>     
382    </variablelist>
383  </RefSect1>
384
385  <RefSect1><Title>Voir aussi</>
386    <para>
387    &apt-conf;, &sources-list;, &apt-get;
388  </RefSect1>
389
390  <RefSect1><Title>Diagnostics</>
391    <para>
392 <command/apt-cache/ retourne zéro après un déroulement normal, et le nombre 
393 décimal 100 en cas d'erreur.
394  </RefSect1>
395
396  &manbugs;
397  &manauthor;
398  &deux-traducteurs;
399 </refentry>