This file is indexed.

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

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
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <title>Chapitre 4. L'interface</title>
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1"/>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
    <link rel="home" href="index.html" title="Guide d'utilisation d'APT"/>
    <link rel="up" href="index.html" title="Guide d'utilisation d'APT"/>
    <link rel="prev" href="ch3.html" title="Chapitre 3. DSelect"/>
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">Chapitre 4. L'interface</th>
        </tr>
        <tr>
          <td align="left"><a accesskey="p" href="ch3.html">Précédent</a> </td>
          <th width="60%" align="center"> </th>
          <td align="right"> </td>
        </tr>
      </table>
      <hr/>
    </div>
    <div class="chapter">
      <div class="titlepage">
        <div>
          <div>
            <h1 class="title"><a id="ch4"/>Chapitre 4. L'interface</h1>
          </div>
        </div>
      </div>
      <div class="toc">
        <p>
          <strong>Table des matières</strong>
        </p>
        <dl class="toc">
          <dt>
            <span class="section">
              <a href="ch4.html#s4.1">4.1. Démarrage</a>
            </span>
          </dt>
          <dt>
            <span class="section">
              <a href="ch4.html#s4.2">4.2. Le rapport d'état</a>
            </span>
          </dt>
          <dt>
            <span class="section">
              <a href="ch4.html#s4.3">4.3. L'affichage d'état</a>
            </span>
          </dt>
          <dt>
            <span class="section">
              <a href="ch4.html#s4.4">4.4. Dpkg</a>
            </span>
          </dt>
        </dl>
      </div>
      <p>
La méthode APT de <span class="command"><strong>dselect</strong></span> et le programme
<span class="command"><strong>apt-get</strong></span> 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="#ftn.idp52540816" class="footnote" id="idp52540816"><sup class="footnote">[2]</sup></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>
      <div class="section">
        <div class="titlepage">
          <div>
            <div>
              <h2 class="title"><a id="s4.1"/>4.1. Démarrage</h2>
            </div>
          </div>
        </div>
        <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  <code class="literal">apt-get check</code>.
</p>
        <pre class="screen">
# 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 <span class="command"><strong>apt-get</strong></span> bloquera
des opérations ultérieures.
</p>
        <pre class="screen">
# apt-get check
Lecture de la liste des paquets... Fait
Construction de l'arbre des dépendances... Fait
Vous pouvez lancer « apt-get -f install » pour corriger ces problèmes.
Les paquets suivants contiennent des dépendances non satisfaites :
  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
<span class="command"><strong>dpkg</strong></span> aurait manquées lors de mises à jour. <a href="#ftn.idp52552144" class="footnote" id="idp52552144"><sup class="footnote">[3]</sup></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  <code class="literal">-f</code> utilisée avec <span class="command"><strong>apt-get</strong></span>
conduira APT à rechercher une solution possible puis à continuer. La méthode
APT de <span class="command"><strong>dselect</strong></span> utilise toujours cette option
<code class="literal">-f</code> 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 <code class="literal">-f</code> 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>
      </div>
      <div class="section">
        <div class="titlepage">
          <div>
            <div>
              <h2 class="title"><a id="s4.2"/>4.2. Le rapport d'état</h2>
            </div>
          </div>
        </div>
        <p>
Avant de démarrer ses actions, <span class="command"><strong>apt-get</strong></span> 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 <code class="literal">-f</code> et des autres
opérations découlant du type de commande utilisée.
</p>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.1"/>4.2.1. La liste des paquets supplémentaires</h3>
              </div>
            </div>
          </div>
          <pre class="screen">
Les paquets supplémentaires suivants seront installés :
  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 <code class="literal">install</code>. Le plus souvent, les paquets
concernés sont le résultat d'une installation automatique.
</p>
        </div>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.2"/>4.2.2. Les paquets à supprimer</h3>
              </div>
            </div>
          </div>
          <pre class="screen">
Les paquets suivants seront ENLEVÉS :
  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  <code class="literal">-f</code> 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>
        </div>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.3"/>4.2.3. La liste des nouveaux paquets</h3>
              </div>
            </div>
          </div>
          <pre class="screen">
Les NOUVEAUX paquets suivants seront installés :
  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>
        </div>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.4"/>4.2.4. La liste des paquets conservés</h3>
              </div>
            </div>
          </div>
          <pre class="screen">
Les paquets suivants ont été conservés :
  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 <code class="literal">apt-get
install</code> ou avec <span class="command"><strong>dselect</strong></span>.
</p>
        </div>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.5"/>4.2.5. L'avertissement pour paquets retenus</h3>
              </div>
            </div>
          </div>
          <pre class="screen">
Les paquets retenus suivants seront changés :
  cvs
</pre>
          <p>
Il peut parfois être utile de demander à APT d'installer un paquet retenu
(« hold »). 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>
        </div>
        <div class="section">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="s4.2.6"/>4.2.6. Résumé final</h3>
              </div>
            </div>
          </div>
          <p>
Enfin, APT affichera un résumé de toutes les opérations qui prendront place.
</p>
          <pre class="screen">
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>
        </div>
      </div>
      <div class="section">
        <div class="titlepage">
          <div>
            <div>
              <h2 class="title"><a id="s4.3"/>4.3. L'affichage d'état</h2>
            </div>
          </div>
        </div>
        <p>
Pendant le téléchargement des fichiers des paquets, APT affiche un certain
nombre de messages d'avancement.
</p>
        <pre class="screen">
# apt-get update
Réception de :1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages
Réception de :2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages
Atteint http://llug.sep.bnl.gov/debian/ testing/main Packages
Réception de :4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages
Réception de :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 « Réception de » 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, <code class="literal">apt-get update</code> 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
<span class="emphasis"><em>Forking</em></span> 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
<span class="emphasis"><em>Connexion</em></span> à <span class="emphasis"><em>Attente du fichier</em></span>,
puis <span class="emphasis"><em>Téléchargement</em></span> ou <span class="emphasis"><em>Reprise</em></span>. 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
<code class="literal">102/10,2ko</code>, 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
« Réception de » 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 <code class="literal">-q</code> pour supprimer cet affichage.
</p>
      </div>
      <div class="section">
        <div class="titlepage">
          <div>
            <div>
              <h2 class="title"><a id="s4.4"/>4.4. Dpkg</h2>
            </div>
          </div>
        </div>
        <p>
APT utilise <span class="command"><strong>dpkg</strong></span> pour installer les archives et bascule
vers l'interface de ce programme une fois le téléchargement
terminé. <span class="command"><strong>dpkg</strong></span> 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>
      </div>
      <div class="footnotes">
        <br/>
        <hr/>
        <div id="ftn.idp52540816" class="footnote">
          <p><a href="#idp52540816" class="para"><sup class="para">[2] </sup></a> La méthode <span class="command"><strong>dselect</strong></span> consiste en fait en un jeu de scripts
qui encapsulent <span class="command"><strong>apt-get</strong></span>. Cela approte des fonctionnalités
supplémentaires à celles d'<span class="command"><strong>apt-get</strong></span> utilisé isolément. </p>
        </div>
        <div id="ftn.idp52552144" class="footnote">
          <p><a href="#idp52552144" class="para"><sup class="para">[3] </sup></a> Cependant, APT prend en compte les dépendances connues et s'efforce d'éviter
que cette situation ne se produise </p>
        </div>
      </div>
    </div>
    <div class="navfooter">
      <hr/>
      <table width="100%" summary="Navigation footer">
        <tr>
          <td align="left"><a accesskey="p" href="ch3.html">Précédent</a> </td>
          <td align="center"> </td>
          <td align="right"> </td>
        </tr>
        <tr>
          <td align="left" valign="top">Chapitre 3. DSelect </td>
          <td align="center">
            <a accesskey="h" href="index.html">Sommaire</a>
          </td>
          <td align="right" valign="top"> </td>
        </tr>
      </table>
    </div>
  </body>
</html>