This file is indexed.

/usr/share/doc/apt-doc/guide.fr.html/ch4.html is in apt-doc 1.0.1ubuntu2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">

<html>

<head>

<meta http-equiv="content-type" content="text/html; charset=utf-8">

<title>Guide d'utilisation d'APT - L'interface</title>

<link href="index.html" rel="start">
<link href="ch3.html" rel="prev">
<link href="index.html" rel="next">
<link href="index.html#contents" rel="contents">
<link href="index.html#copyright" rel="copyright">
<link href="ch1.html" rel="chapter" title="1 Généralités">
<link href="ch2.html" rel="chapter" title="2 apt-get">
<link href="ch3.html" rel="chapter" title="3 DSelect">
<link href="ch4.html" rel="chapter" title="4 L'interface">
<link href="ch1.html#s1.1" rel="section" title="1.1 Anatomie du système de gestion des paquets">
<link href="ch4.html#s4.1" rel="section" title="4.1 Démarrage">
<link href="ch4.html#s4.2" rel="section" title="4.2 Le rapport d'état">
<link href="ch4.html#s4.3" rel="section" title="4.3 L'affichage d'état">
<link href="ch4.html#s4.4" rel="section" title="4.4 Dpkg">
<link href="ch4.html#s4.2.1" rel="subsection" title="4.2.1 La liste des paquets supplémentaires">
<link href="ch4.html#s4.2.2" rel="subsection" title="4.2.2 Les paquets à supprimer">
<link href="ch4.html#s4.2.3" rel="subsection" title="4.2.3 La liste des nouveaux paquets">
<link href="ch4.html#s4.2.4" rel="subsection" title="4.2.4 La liste des paquets conservés">
<link href="ch4.html#s4.2.5" rel="subsection" title="4.2.5 L'avertissement pour paquets retenus">
<link href="ch4.html#s4.2.6" rel="subsection" title="4.2.6 Résumé final">

</head>

<body>

<p><a name="ch4"></a></p>
<hr>

<p>
[ <a href="ch3.html">précédent</a> ]
[ <a href="index.html#contents">Table des matières</a> ]
[ <a href="ch1.html">1</a> ]
[ <a href="ch2.html">2</a> ]
[ <a href="ch3.html">3</a> ]
[ 4 ]
[ <a href="index.html">suivant</a> ]
</p>

<hr>

<h1>
Guide d'utilisation d'APT
<br>Chapitre 4 - L'interface
</h1>

<p>
La méthode APT de <code>dselect</code> et le programme <code>apt-get</code>
utilisent la même interface.  Elle consiste en un système simple qui indique
les opérations qui seront effectuées puis les réalise.[<a
href="footnotes.html#f2" name="fr2">2</a>] Après avoir indiqué un résumé
des opérations qui seront effectuées, APT donnera un certain nombre
d'informations permettant d'estimer sa progression, tout au long des actions
qu'il effectue.
</p>

<hr>

<h2 id="s4.1">4.1 Démarrage</h2>

<p>
Avant toute opération autre qu'une mise à jour, APT effectue un certain
nombre d'actions pour préparer ses mécaismes internes de fonctionnement.  Il
vérifie également l'état du système.  Ces opérations peuvent être
effectuées isolément avec la commande <samp>apt-get check</samp>.
</p>

<pre>
     # apt-get check
     Lecture de la liste des paquets... Fait
     Construction de l'arbre des dépendances... Fait
</pre>

<p>
En premier lieu, la liste des paquets est lue et placée en mémoire.  APT
utilise un mécanisme de cache et cette opération sera plus rapide si elle est
effectuée une deuxième fois.Si certains des fichiers de paquets ne sont pas
trouvés, ils seront ignorés et une informatique sera affichée quand apt-get
se terminera.
</p>

<p>
Ensuite, une analyse détaillée des dépendances du système est réalisée.
Les dépendances de chaque paquet installé ou décompressé sont vérifiées.
Si un problème est trouvé, il sera affiché et <code>apt-get</code> bloquera
des opérations ultérieures.
</p>

<pre>
     # apt-get check
     Lecture de la liste des paquets... Fait
     Construction de l'arbre des dépendances.. Fait
     Vous pouvez lancer «&nbsp;apt-get -f install&nbsp;» pour corriger ces problèmes.
     Les paquets suivants contiennent des dépendances non satisfaites&nbsp;:
       9fonts: Depends: xlib6g mais il n'est pas installé
       uucp: Depends: mailx mais il n'est pas installé
       blast: Depends: xlib6g (&gt;= 3.3-5) mais il n'est pas installé
       adduser: Depends: perl-base mais il n'est pas installé
       aumix: Depends: libgpmg1 mais il n'est pas installé
       debiandoc-sgml: Depends: sgml-base mais il n'est pas installé
       bash-builtins: Depends: bash (&gt;= 2.01) but 2.0-3 is installed
       cthugha: Depends: svgalibg1 mais il n'est pas installé
                Depends: xlib6g (&gt;= 3.3-5) mais il n'est pas installé
       libreadlineg2: Conflicts:libreadline2 (&lt;&lt; 2.1-2.1)
</pre>

<p>
Dans cet exemple, le système comporte plusieurs problèmes, notamment un
problème sérieux avec libreadline2g.  Une ligne est affichée pour chaque
paquet dont les dépendances ne sont pas satisfaites, indiquant quel est le
problème.  Une explication simple du problème est donnée.
</p>

<p>
Il existe deux façons pour le système d'aboutir à cet état.  Cela peut
d'abord être causé par des subtilités de relations entre les paquets que
<code>dpkg</code> aurait manquées lors de mises à jour.  [<a
href="footnotes.html#f3" name="fr3">3</a>].  Cela peut également être dû à
l'échec antérieur d'une installation de paquet.  Dans le cas présent, un
paquet a pu être décompressé sans que ses dépendances ne soient
satisfaites.
</p>

<p>
La seconde situation est moins grave que la première car APT met certaines
contraintes sur l'ordre d'installation des paquets.  Dans les deux cas,
l'option <samp>-f</samp> utilisée avec <code>apt-get</code> conduira APT à
rechercher une solution possible puis à continuer.  La méthode APT de
<code>dselect</code> utilise toujours cette option <samp>-f</samp> afin de
pouvoir poursuivre plus facilement ses opérations si un script de mainteneur
échoue de manière inopinée.
</p>

<p>
Cependant, si l'option <samp>-f</samp> est utilisée pour corriger un système
fortement corrompu qui est dans le premier cas, il est possible que
l'opération échoue immédiatement ou au cours des diverses tentatives de
réparation effectuées.  Dans tous les cas, il peut être nécessaire de
corriger la situation manuellement avec dpkg (éventuellement en utilisant des
options pour forcer certains opérations) avant de pouvoir utiliser à nouveau
APT.
</p>

<hr>

<h2 id="s4.2">4.2 Le rapport d'état</h2>

<p>
Avant de démarrer ses actions, <code>apt-get</code> en affiche un résumé.
En général, ce rapport dépend du type d'opération qui est entreprise, mais
de nombreux éléments sont communs aux différents types de rapports.  Ainsi,
dans tous les cas, les listes reflètent l'état final du système, en tenant
compte de l'option <samp>-f</samp> et des autres opérations découlant du type
de commande utilisée.
</p>

<hr>

<h3 id="s4.2.1">4.2.1 La liste des paquets supplémentaires</h3>

<pre>
     Les paquets supplémentaires suivants seront installés&nbsp;:
       libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl
       mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base
       bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy
       squake pgp-i python-base debmake ldso perl libreadlineg2
       ssh
</pre>

<p>
La liste des paquets supplémentaires montre tous les paquets installés ou mis
à jour en plus de ceux indiqués à la ligne de commande.  Elle n'apparaît
qu'avec la commande <samp>install</samp>.  Le plus souvent, les paquets
concernés sont le résultat d'une installation automatique.
</p>

<hr>

<h3 id="s4.2.2">4.2.2 Les paquets à supprimer</h3>

<pre>
     Les paquets suivants seront ENLEVÉS&nbsp;:
       xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix
       xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel
       xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid
       nas xpilot xfig
</pre>

<p>
La liste des paquets à enlever montre tous les paquets qui seront supprimés
du système.  Elle peut apparaître pour tout type d'opération.  Il est
conseillé de l'inspecter en détail afin de vérifier qu'aucun paquet
important ne va être supprimé.  L'option <samp>-f</samp> provoque notamment
souvent des suppressions de paquets et il est déconseillé d'être
particulièrement attentif dans ce genre de cas.  La liste peut comporter des
paquets qui seront supprimés parce qu'ils sont seulement partiellement
installés, par exemple après l'interruption d'une opération d'installation.
</p>

<hr>

<h3 id="s4.2.3">4.2.3 La liste des nouveaux paquets</h3>

<pre>
     Les NOUVEAUX paquets suivants seront installés&nbsp;:
       zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base
</pre>

<p>
La liste des nouveaux paquets est un simple rappel des opérations qui vont
avoir lieu.  Les paquets affichés ne sont pas encore présents sur le système
mais le seront une fois qu'APT aura terminé.
</p>

<hr>

<h3 id="s4.2.4">4.2.4 La liste des paquets conservés</h3>

<pre>
     Les paquets suivants ont été conservés&nbsp;:
       compface man-db tetex-base msql libpaper svgalib1
       gs snmp arena lynx xpat2 groff xscreensaver
</pre>

<p>
À chaque fois que le système entier est mis à jour, il est possible que de
nouvelles versions de paquets ne puissent pas être installées car elles ont
besoins ne nouveaux paquets ou qu'elles entrent en conflit avec des paquets
existants.  Ces paquets apparaîtront alors dans la liste des paquets
conservés.  Le meilleure méthode pour effectivement installer ces paquets est
souvent de le faire explicitement avec la commande <samp>apt-get install</samp>
ou avec <code>dselect</code>.
</p>

<hr>

<h3 id="s4.2.5">4.2.5 L'avertissement pour paquets retenus</h3>

<pre>
     Les paquets retenus suivants seront changés&nbsp;:
       cvs
</pre>

<p>
Il peut parfois être utile de demander à APT d'installer un paquet retenu
(«&nbsp;hold&nbsp;»).  Dans ce cas, le programme affichera un avertissement
indiquant que le paquet retenu va être modifié.  Cela ne se produira que lors
de l'utilisation des commandes dist-upgrade ou install.
</p>

<hr>

<h3 id="s4.2.6">4.2.6 Résumé final</h3>

<p>
Enfin, APT affichera un résumé de toutes les opérations qui prendront place.
</p>

<pre>
     206 paquets mis à jour, 8 nouvellement installés, 23 à enlever et 51 non mis à jour.
     12 paquets partiellement installés ou enlevés.
     Il est nécessaire de prendre 65,7Mo/66,7Mo dans les archives. Après cette opération, 26,5Mo d'espace disque supplémentaires seront utilisés.
</pre>

<p>
La première ligne de ce résumé est une version simplifiée de l'ensemble des
listes et indique le nombre de mises à jour (paquets déjà installés et pour
lesquels une nouvelle version est disponible).  La deuxième ligne indique le
nombre de paquets incorrectement configurés, en raison notamment
d'installations interrompues.  La dernière ligne indique l'espace disque
nécessaire pour effectuer l'installation.  Le premier couple de nombre fait
référence à la taille des fichiers d'archive.  Le premier nombre est le
nombre d'octets à récupérer depuis les sites distants et le deuxième la
taille totale de tous les fichiers nécessaires.  Le nombre suivant représente
la différence d'espace occupé entre les paquets installés actuellement et ce
qui sera ensuite installé.  Il est grossièrement égal à l'espace
supplémentaire nécessaire dans /usr après achèvement de toutes les
opérations.  Si de nombreux paquets sont supprimés, cette valeur peut
représenter l'espace qui est alors libéré.
</p>

<p>
D'autres rapports peuvent être créés avec l'option -u qui affiche les
paquets à mettre à jour.  Il sont analogues aux exemples précédents.
</p>

<hr>

<h2 id="s4.3">4.3 L'affichage d'état</h2>

<p>
Pendant le téléchargement des fichiers des paquets, APT affiche un certain
nombre de messages d'avancement.
</p>

<pre>
     # apt-get update
     Réception de&nbsp;:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages
     Réception de&nbsp;:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages
     Atteint http://llug.sep.bnl.gov/debian/ testing/main Packages
     Réception de&nbsp;:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages
     Réception de&nbsp;:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages
     11% [5 testing/non-free `Attente du fichier' 0/32.1k 0%] 2203b/s 1m52s
</pre>

<p>
Les lignes qui débutent par «&nbsp;Réception de&nbsp;» sont affichées
quand APT démarre la récupération d'un fichier alors que la dernière ligne
indique la progression du téléchargement.  La première valeur de pourcentage
de la ligne est le pourcentage de téléchargement déjà effectué, pour
l'ensemble des fichiers.  Il faut noter que, comme la taille des fichiers de
paquets n'est pas connue, <samp>apt-get update</samp> estime le pourcentage
effectué ce qui peut conduire à des imprécisions.
</p>

<p>
La section suivante de la ligne d'état est répétée pour chaque sous-tâche
de téléchargement.  Elle indique l'opération effectuée et d'autres
informations utiles sur ce qui est en cours.  Cette section indiquera parfois
<em>Forking</em> ce qui indique que le système charge le module de
téléchargement.  Le premier mot après le crochet ouvrant ([) est le numéro
d'ordre de téléchargement comme indiqué dans les lignes d'historique.  Le
mot suivant est le nom court de l'objet téléchargé.  Pour les archives, il
s'agit du nom du paquet en cours de récupération.
</p>

<p>
À l'intérieur des guillemets, on trouve une information sur la progression de
la phase de négociation du téléchargement.  Usuellement, elle évolue de
<em>Connexion</em> à <em>Attente du fichier</em>, puis
<em>Téléchargement</em> ou <em>Reprise</em>.  La valeur finale est le nombre
d'octets téléchargés depuis le site distant.  Une fois le téléchargement
commencé, cette indication prend la forme <samp>102/10,2ko</samp>, ce qui
indique que 102 octets ont été téléchargés et que 10,2 kilo-octets sont
attendus.  La taille totale est toujours représentées sur 4 digits pour des
raisons de place disponible.  Après cet affichage de taille, se trouve une
barre de progression pour le téléchargement du fichier lui-même.
L'élément suivant est la vitesse instantanée de téléchargement.  Elle est
mise à jour toutes les 5 secondes et représente la vitesse de transfert pour
cette période.  Enfin, est affiché la temps de téléchargement restant
estimé.  Cette information est mise régulièrement à jour et représete la
durée estimée de téléchargement de toute ce qui est nécessaire, à la
vitesse affichée.
</p>

<p>
La ligne d'état est mise à jour chaque demi-seconde afin de fournir un retour
régulier sur la progression du téléchargement alors que les lignes
«&nbsp;Réception de&nbsp;» reculent d'une unité à chaque fois qu'un
nouveau fichier est démarré.  Comme l'état est mis à jour régulièrement,
il ne peut pas servir pour la journalisation dans un fichier.  Il est
nécessaire d'utiliser l'option <samp>-q</samp> pour supprimer cet affichage.
</p>

<hr>

<h2 id="s4.4">4.4 Dpkg</h2>

<p>
APT utilise <code>dpkg</code> pour installer les archives et bascule vers
l'interface de ce programme une fois le téléchargement terminé.
<code>dpkg</code> peut poser un certain nombre de questions pendant le
traitement des paquets, qui peuvent eux-même être amener à poser des
questions.  Chacune de ces questions comporte un description de ce qui est
attendu et elles sont trop variables d'un paquet à l'autre pour qu'une
description détaillée soit donnée dans ce document.
</p>

<hr>

<p>
[ <a href="ch3.html">précédent</a> ]
[ <a href="index.html#contents">Table des matières</a> ]
[ <a href="ch1.html">1</a> ]
[ <a href="ch2.html">2</a> ]
[ <a href="ch3.html">3</a> ]
[ 4 ]
[ <a href="index.html">suivant</a> ]
</p>

<hr>

<p>
Guide d'utilisation d'APT
</p>

<address>
$Id: guide.sgml,v 1.7 2003/04/26 23:26:13 doogie Exp $<br>
<br>
Jason Gunthorpe <code><a href="mailto:jgg@debian.org">mailto:jgg@debian.org</a></code><br>
<br>
</address>
<hr>

</body>

</html>