1
<?xml version="1.0" encoding="iso-8859-15" standalone="no"?>
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
5
<!ENTITY % aptent SYSTEM "apt.ent.fr">
13
&apt-author.jgunthorpe;
17
<!-- The last update date -->
18
<date>29 F�vrier 2004</date>
22
<refentrytitle>apt-get</refentrytitle>
23
<manvolnum>8</manvolnum>
27
<refname>apt-get</refname>
28
<refpurpose>Utilitaire d'APT pour la manipulation de paquets -- interface en ligne de commande.</refpurpose>
33
<command>apt-get</command>
34
<arg><option>-hvs</option></arg>
35
<arg><option>-o=<replaceable>option de configuration</replaceable></option></arg>
36
<arg><option>-c=<replaceable>fichier</replaceable></option></arg>
40
<arg>dselect-upgrade</arg>
41
<arg>install <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
42
<arg>remove <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
43
<arg>source <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
44
<arg>build-dep <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
52
<refsect1><title>Description</title>
54
<command>Apt-get</command> est l'outil en ligne de commande pour manipuler les
55
paquets. Il peut �tre consid�r� par l'utilisateur comme un g�n�rateur de
56
sortie pour les autres outils de la biblioth�que APT.
57
Plusieurs interfaces utilisateur existent, comme dselect, aptitude,
58
synaptic, gnome-apt ou wajig.
61
� moins que l'option <option>-h</option>, ou <option>--help</option> ne soit donn�e, l'une des
62
commandes suivantes doit �tre pr�sente.
64
<variablelist><varlistentry><term>update</term>
66
La commande <literal>update</literal> permet de resynchroniser un fichier r�pertoriant
67
les paquets disponibles et sa source. Ces fichiers sont r�cup�r�s aux
68
endroits sp�cifi�s dans <filename>/etc/apt/sources.list</filename>. Ainsi, lorsqu'on
69
utilise une archive Debian, cette commande r�cup�re les fichiers
70
<filename>Packages.gz</filename> et les analyse de mani�re � rendre disponibles
71
les informations concernant les nouveaux paquets et les paquets mis � jour.
72
On doit toujours ex�cuter une commande <literal>update</literal> avant les commandes
73
<literal>upgrade</literal> ou <literal>dist-upgrade</literal>. Il faut savoir que l'indicateur
74
de progression d'ensemble n'est pas correct puisque la taille de ces fichiers
75
ne peut �tre connue � l'avance.
79
<varlistentry><term>upgrade</term>
81
La commande <literal>upgrade</literal> permet d'installer les versions les plus
82
r�centes de tous les paquets pr�sents sur le syst�me en utilisant les
83
sources �num�r�es dans <filename>/etc/apt/sources.list</filename>. Les paquets
84
install�s dont il existe de nouvelles versions sont r�cup�r�s et mis �
85
niveau. En aucun cas des paquets d�j� install�s ne sont supprim�s ; de
86
m�me, des paquets qui ne sont pas d�j� install�s ne sont ni r�cup�r�s ni
87
install�s. Les paquets dont de nouvelles versions ne peuvent pas �tre
88
install�es sans changer le statut d'installation d'un autre paquet sont
89
laiss�s dans leur version courante. On doit d'abord ex�cuter la commande
90
<literal>update</literal> pour que <command>apt-get</command> connaisse
91
l'existence de nouvelles versions des paquets.
95
<varlistentry><term>dselect-upgrade</term>
97
<literal>dselect-upgrade</literal> est utilis�e conjointement avec &dselect;, l'interface
98
traditionnelle Debian pour la gestion des paquets.
99
La commande <literal>dselect-upgrade</literal> suit les modifications faites par
100
&dselect; dans le champ <literal>Status</literal> des paquets disponibles, et effectue
101
les actions n�cessaires � la r�alisation de cet �tat (par exemple,
102
suppression d'anciens paquets, installation de nouveaux paquets).
106
<varlistentry><term>dist-upgrade</term>
108
La commande <literal>dist-upgrade</literal> effectue la fonction <literal>upgrade</literal> en
109
y ajoutant une gestion intelligente des changements de d�pendances dans les
110
nouvelles versions des paquets ; <command>apt-get</command> poss�de un syst�me
111
� intelligent � de r�solution des conflits et il essaye, quand c'est
112
n�cessaire, de mettre � niveau les paquets les plus importants aux d�pens
113
des paquets les moins importants. Le fichier <filename>/etc/apt/sources.list</filename>
114
contient une liste de sources o� r�cup�rer les paquets d�sir�s.
115
Voyez aussi &apt-preferences; pour un m�canisme de remplacement des param�tres
116
g�n�raux pour certains paquets.
120
<varlistentry><term>install</term>
122
La commande <literal>install</literal> est suivie par un ou plusieurs paquets �
123
installer. Chaque paquet est un nom de paquet ; ce n'est pas un nom de
124
fichier enti�rement d�fini (par exemple, dans un syst�me Debian GNU/Linux,
125
on indiquera libc6 et non pas <literal>libc6_1.9.6-2.deb</literal>). Tous les
126
paquets requis par le(s) paquet(s) que l'on veut installer sont aussi
127
r�cup�r�s et install�s. On se sert du fichier
128
<filename>/etc/apt/sources.list</filename> pour localiser les paquets d�sir�s. Quand
129
un trait d'union est accol� (sans espace interm�diaire) au nom d'un paquet
130
d�j� install�, ce paquet est supprim�. De m�me on peut ajouter un signe
131
� + � pour d�signer un paquet � installer.
132
Cette derni�re fonctionnalit� peut �tre utilis�e pour annuler les d�cisions
133
prises par le syst�me de r�solution des conflits d'apt-get.
136
On peut choisir d'installer une version particuli�re d'un paquet en faisant
137
suivre son nom par un signe �gal et par la version. Cette version sera
138
localis�e et l'installation sera demand�e. On peut aussi choisir une
139
distribution particuli�re en faisant suivre le nom du paquet par une barre
140
oblique et par le nom de la distribution ou de l'archive (stable, testing,
144
Avec ces possibilit�s de choisir la version, de vieilles versions d'un paquet
145
peuvent �tre install�es. Il faut faire attention.
148
Enfin, le m�canisme d'&apt-preferences; permet de cr�er d'autres r�gles pour
149
l'installation des paquets.
152
Quand aucun paquet ne correspond � l'expression donn�e en argument et que cette
153
expression contient l'un des caract�res � . �, � ? � ou
154
� * �, on consid�re que c'est une expression rationnelle POSIX et
155
elle est appliqu�e � tous les paquets de la base de donn�es. Tout paquet
156
correspondant est install� (ou supprim�). Notez que la comparaison est
157
effectu�e par sous-cha�ne et � lo � correspond aussi bien �
158
� how-lo � qu'� � lowest �. Si vous ne le voulez pas, ancrez
159
l'expression par un caract�re � ^ � ou un caract�re � $ �,
160
ou bien cr�ez une expression plus pr�cise.
164
<varlistentry><term>remove</term>
166
La commande <literal>remove</literal> est identique � la commande <literal>install</literal> ;
167
Mais les paquets sont supprim�s et non pas install�s. Quand un signe plus est
168
accol� (sans espace interm�diaire) au nom du paquet, le paquet est install� au lieu
173
<varlistentry><term>source</term>
175
Avec la commande <literal>source</literal>, <command>apt-get</command> r�cup�re des paquets
176
sources. APT examine les paquets disponibles pour choisir le paquet source
177
� r�cup�rer. Il trouve ensuite et t�l�charge dans le r�pertoire courant
178
la version la plus r�cente. Les paquets source sont g�r�s ind�pendamment
179
des paquets binaires, via les lignes de type <literal>deb-src</literal> dans le fichier
180
&sources-list;. On n'obtiendra probablement pas les m�mes sources que celles
181
du paquet install� ou celles du paquet qu'on pourrait installer. Si l'option
182
<option>--compile</option> est sp�cifi�e, le paquet est compil� en un binaire .deb
183
avec <command>dpkg-buildpackage</command>. Si <option>--download-only</option> est
184
sp�cifi�, le source n'est pas d�compact�.
187
De la m�me fa�on qu'avec les paquets binaires, on peut r�cup�rer une version
188
particuli�re d'un paquet source en faisant suivre son nom par un signe �gal
189
et par la version. Cela permet une comparaison exacte entre le nom du paquet
190
source et la version ; cela lance implicitement la commande
191
<literal>APT::Get::Only-Source</literal>.
194
Notez que les paquets sources ne sont pas suivis comme le sont les paquets
195
binaires. Ils ne sont pr�sents que dans le r�pertoire courant et sont
196
semblables � des sources t�l�charg�s sous forme de tarball.
200
<varlistentry><term>build-dep</term>
202
Avec la commande <literal>build-dep</literal>, apt-get installe ou supprime des paquets
203
dans le but de satisfaire les d�pendances de construction d'un paquet source.
204
Pour l'instant, dans la cas d'un paquet virtuel, un paquet est choisi au
208
<varlistentry><term>check</term>
210
La commande <literal>check</literal> est un outil de diagnostic ; il met � jour
211
le cache des paquets et cherche des d�pendances d�fectueuses.
215
<varlistentry><term>clean</term>
217
La commande <literal>clean</literal> nettoie le r�f�rentiel local des paquets
218
r�cup�r�s. Il supprime tout, except� le fichier lock situ� dans
219
<filename>&cachedir;/archives/</filename> et <filename>&cachedir;/archives/partial/</filename>.
220
Quand APT est utilis� comme mode de &dselect;, <literal>clean</literal> est effectu�
221
automatiquement. Quand on n'utilise pas dselect, il faut ex�cuter
222
<literal>apt-get clean</literal> de temps en temps si l'on veut lib�rer de l'espace
227
<varlistentry><term>autoclean</term>
229
Tout comme <literal>clean</literal>, <literal>autoclean</literal> nettoie le r�f�rentiel local
230
des paquets r�cup�r�s. La diff�rence est qu'il supprime uniquement les paquets
231
qui ne peuvent plus �tre t�l�charg�s et qui sont grandement inutiles.
232
On peut ainsi contr�ler la taille de ce cache sur une longue p�riode.
233
Tant qu'elle n'est pas activ�e, l'option de configuration
234
<literal>APT::Clean-Installed</literal> emp�che la suppression de paquets install�s.
239
<refsect1><title>Options</title>
244
<varlistentry><term><option>-d</option></term><term><option>--download-only</option></term>
246
R�cup�ration seule ; les paquets sont r�cup�r�s mais ne sont ni d�paquet�s
247
ni install�s. �l�ment de configuration : <literal>APT::Get::Download-Only</literal>.
251
<varlistentry><term><option>-f</option></term><term><option>--fix-broken</option></term>
253
Correction ; essaye de r�parer un syst�me dont les d�pendances sont
254
d�fectueuses. Cette option, utilis�e avec install ou remove, peut omettre
255
tout paquet de fa�on � permettre � APT de d�duire une solution viable.
256
Chaque paquet sp�cifi� doit compl�tement corriger le probl�me. Cette option
257
est quelquefois n�cessaire lorsque l'on ex�cute APT pour la premi�re fois ;
258
APT lui-m�me interdit les d�pendances d�fectueuses dans un syst�me. Il est
259
possible que la structure de d�pendances d'un syst�me soit tellement
260
corrompue qu'elle requiert une intervention manuelle (ce qui veut dire la
261
plupart du temps utiliser &dselect; ou <command>dpkg --remove</command> pour �liminer
262
les paquets en cause). L'utilisation de cette option conjointement avec
263
<option>-m</option> peut produire une erreur dans certaines situations.
264
�l�ment de configuration : <literal>APT::Get::Fix-Broken</literal>.
268
<varlistentry><term><option>-m</option></term><term><option>--ignore-missing</option></term>
269
<term><option>--fix-missing</option></term>
271
Ignorer les paquets manquants ; si des paquets ne peuvent �tre
272
r�cup�r�s, ou, apr�s r�cup�ration, ne satisfont pas au contr�le d'int�grit�,
273
cette commande met ces paquets de c�t� et g�re le r�sultat. Utiliser cette
274
option conjointement avec <option>-f</option> peut produire une erreur dans
275
certaines situations. Quand un paquet, s�lectionn� pour une installation
276
(particuli�rement si c'est mentionn� en ligne de commande), ne peut �tre
277
r�cup�r�, il est mis silencieusement de c�t�. �l�ment de configuration :
278
<literal>APT::Get::Fix-Missing</literal>.
282
<varlistentry><term><option>--no-download</option></term>
284
Pas de r�cup�ration. Le mieux est d'utiliser cette option avec
285
<option>--ignore-missing</option> pour forcer APT � n'utiliser que les .deb qu'il a
287
�l�ment de configuration : <literal>APT::Get::Download</literal>.
291
<varlistentry><term><option>-q</option></term><term><option>--quiet</option></term>
293
Mode silencieux ; cette commande produit une sortie destin�e �
294
l'enregistrement dans un fichier-journal en omettant les indicateurs de
295
progression. Un plus grand nombre de � q � (2 au plus) produit un
297
On peut aussi utiliser <option>-q=#</option> pour positionner le niveau de silence,
298
et annuler le fichier de configuration. Notez qu'un niveau de silence �gal � 2
299
implique <option>-y</option> et vous ne devez jamais utiliser <option>-qq</option> sans
300
l'accompagner d'un modificateur tel que <option>-d</option>, <option>--print-uris</option>
301
ou <option>-s</option> : APT pourrait ex�cuter des actions inattendues !
302
�l�ment de configuration : <literal>quiet</literal>.
306
<varlistentry><term><option>-s</option></term>
307
<term><option>--simulate</option></term>
308
<term><option>--just-print</option></term>
309
<term><option>--dry-run</option></term>
310
<term><option>--recon</option></term>
311
<term><option>--no-act</option></term>
313
Simulation ; cette commande r�alise une simulation des actions qui
314
seraient ex�cut�es mais ne modifie pas le syst�me.
315
�l�ment de configuration : <literal>APT::Get::Simulate</literal>.
318
La simulation affiche une s�rie de lignes repr�sentant chacune une op�ration
319
de dpkg, Configure (Conf),Remove (Remv),Unpack (Inst). Les crochets encadrent
320
des paquets endommag�s et des crochets n'encadrant rien indiquent que les
321
dommages n'ont aucune cons�quence (rare).
325
<varlistentry><term><option>-y</option></term><term><option>--yes</option></term>
326
<term><option>--assume-yes</option></term>
328
R�pond automatiquement oui aux questions ; pr�sume � oui �
329
comme r�ponse � toutes les questions et s'ex�cute de mani�re non interactive.
330
Dans le cas d'une situation ind�sirable, comme le changement d'un paquet
331
gel�, l'installation d'un paquet non authentifi� ou la suppression d'un
332
paquet essentiel, <literal>apt-get</literal> s'interrompt.
333
�l�ment de configuration : <literal>APT::Get::Assume-Yes</literal>.
337
<varlistentry><term><option>-u</option></term><term><option>--show-upgraded</option></term>
339
Afficher les paquets mis � niveau ; affiche une liste de tous les paquets �
340
mettre � niveau. �l�ment de configuration : <literal>APT::Get::Show-Upgraded</literal>.
344
<varlistentry><term><option>-V</option></term><term><option>--verbose-versions</option></term>
346
Afficher les versions compl�tes des paquets install�s ou mis � niveau.
347
�l�ment de configuration : <literal>APT::Get::Show-Versions</literal>.
351
<varlistentry><term><option>-b</option></term><term><option>--compile</option></term>
352
<term><option>--build</option></term>
354
Cette commande compile un paquet source apr�s l'avoir r�cup�r�.
355
�l�ment de configuration : <literal>APT::Get::Compile</literal>.
359
<varlistentry><term><option>--ignore-hold</option></term>
361
Cette commande ignore la marque � Hold � d'un paquet ; par ce biais,
362
<command>apt-get</command> ignore un � hold � plac� sur un paquet. cela peut �tre utile
363
avec <literal>dist-upgrade</literal> pour annuler un grand nombre de � hold �
364
ind�sirables. �l�ment de configuration : <literal>APT::Ignore-Hold</literal>.
368
<varlistentry><term><option>--no-upgrade</option></term>
370
Aucune mise � niveau ; quand elle est utilis�e avec <literal>install</literal>,
371
cette commande emp�che les paquets list�s sur la ligne de commande d'�tre mis
373
�l�ment de configuration : <literal>APT::Get::Upgrade</literal>.
377
<varlistentry><term><option>--force-yes</option></term>
379
Forcer l'acceptation ; cette option est dangereuse parce qu'elle laisse
380
APT continuer sans poser de questions quand il r�alise quelque chose de
381
potentiellement dommageable. Cette option ne doit �tre utilis�e que dans des
382
circonstances tr�s sp�ciales. Utiliser <literal>force-yes</literal> peut d�truire le syst�me !
383
�l�ment de configuration : <literal>APT::Get::force-yes</literal>.
387
<varlistentry><term><option>--print-uris</option></term>
389
Au lieu d'aller chercher les paquets � installer, leurs URI sont affich�es.
390
Chaque URI a un chemin, un nom de fichier destination, une taille et une
391
cl� md5 attendue. Notez que le nom de fichier � afficher ne correspond pas
392
toujours au nom de fichier sur le site distant ! Cette option fonctionne
393
aussi avec la commande <literal>source</literal> et avec la commande
394
<literal>update</literal>. Avec la commande <literal>update</literal>,
395
la somme MD5 et la taille ne sont pas donn�es et c'est � l'utilisateur de
396
d�compresser les fichiers compress�s.
397
�l�ment de configuration : <literal>APT::Get::Print-URIs</literal>.
401
<varlistentry><term><option>--purge</option></term>
403
Utiliser purge � la place de remove pour supprimer tout ce qui peut �tre
405
Un ast�risque (*) sera affich� pr�s des paquets qui vont �tre purg�s.
406
�l�ment de configuration : <literal>APT::Get::Purge</literal>.
410
<varlistentry><term><option>--reinstall</option></term>
412
R�installer les paquets d�j� install�s avec leur version la plus r�cente.
413
�l�ment de configuration : <literal>APT::Get::ReInstall</literal>.
416
<varlistentry><term><option>--list-cleanup</option></term>
418
Cette option est activ�e par d�faut ; utilisez <literal>--no-list-cleanup</literal>
419
pour la d�sactiver. Quand elle est activ�e, <command>apt-get</command> g�re
420
automatiquement le contenu de <filename>&statedir;/lists</filename> afin d'assurer
421
que les fichiers obsol�tes soient effac�s. La seule raison de la d�sactiver
422
est une modification fr�quente de votre liste de sources.
423
�l�ment de configuration : <literal>APT::Get::List-Cleanup</literal>.
427
<varlistentry><term><option>-t</option></term>
428
<term><option>--target-release</option></term>
429
<term><option>--default-release</option></term>
431
Cette option contr�le l'entr�e par d�faut pour les questions de
432
distribution ; une �tiquette (pin) par d�faut dont la priorit� vaut 990
433
est cr�� en utilisant la cha�ne sp�cifi�e. Le fichier des pr�f�rences peut
434
annuler cette d�cision. En clair, cette option permet de contr�ler simplement
435
dans quelle distribution seront r�cup�r�s les paquets. Par exemple :
436
<option>-t '2.1*'</option> ou <option>-t unstable</option>.
437
�l�ment de configuration : <literal>APT::Default-Release</literal>.
438
Voyez aussi la page de manuel d'&apt-preferences;.
442
<varlistentry><term><option>--trivial-only</option></term>
444
Ne r�alise que les op�rations � triviales �. Logiquement ceci peut �tre
445
consid�r� comme relatif � <option>--assume-yes</option>. Alors que
446
<option>--assume-yes</option> r�pond oui � n'importe quelle question,
447
<option>--trivial-only</option> r�pond non.
448
�l�ment de configuration : <literal>APT::Get::Trivial-Only</literal>.
452
<varlistentry><term><option>--no-remove</option></term>
454
Quand des paquets doivent �tre supprim�s, apt-get s'arr�te imm�diatement sans
455
poser de questions. �l�ment de configuration : <literal>APT::Get::Remove</literal>.
459
<varlistentry><term><option>--only-source</option></term>
461
Cette option n'a de sens qu'avec les commandes <literal>source</literal> et
462
<literal>build-dep</literal>. Elle indique
463
que les noms de sources donn�s ne doivent pas �tre rep�r�s � travers le
464
tableau des binaires. Cela signifie que si cette option est choisie, la commande
465
<literal>source</literal> acceptera seulement des noms de paquets source
466
comme argument ; elle n'acceptera pas de les rechercher � partir des noms de
467
paquets binaires correspondants.
468
�l�ment de configuration : <literal>APT::Get::Only-Source</literal>
472
<varlistentry><term><option>--diff-only</option></term><term><option>--tar-only</option></term>
474
Ne r�cup�rer que le fichier diff ou tar d'une archive de source.
475
�l�ment de configuration : <literal>APT::Get::Diff-Only</literal> et
476
<literal>APT::Get::Tar-Only</literal>.
480
<varlistentry><term><option>--arch-only</option></term>
482
Ne traiter que les d�pendances de construction pour telle architecture.
483
�l�ment de configuration : <literal>APT::Get::Arch-Only</literal>
487
<varlistentry><term><option>--allow-unauthenticated</option></term>
489
Ignorer le fait que les paquets ne peuvent pas �tre authentifi�s ; pas
490
d'interrogation de l'utilisateur. C'est tr�s utile pour certains outils
492
�l�ment de configuration :
493
<literal>APT::Get::AllowUnauthenticated</literal>.
502
<refsect1><title>Fichiers</title>
504
<varlistentry><term><filename>/etc/apt/sources.list</filename></term>
506
Liste les emplacements o� aller chercher les paquets.
507
�l�ment de configuration : <literal>Dir::Etc::SourceList</literal>.
511
<varlistentry><term><filename>/etc/apt/apt.conf</filename></term>
512
<listitem><para>Fichier de configuration d'APT.
513
�l�ment de configuration : <literal>Dir::Etc::Main</literal>.
517
<varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>
519
�l�ments du fichier de configuration d'APT.
520
�l�ment de configuration : <literal>Dir::Etc::Parts</literal>.
524
<varlistentry><term><filename>/etc/apt/preferences</filename></term>
526
Fichier des pr�f�rences.
527
C'est dans ce fichier qu'on peut faire de l'�tiquetage (pinning) c'est-�-dire,
528
choisir d'obtenir des paquets d'une source distincte ou d'une distribution
530
�l�ment de configuration : <literal>Dir::Etc::Preferences</literal>.
534
<varlistentry><term><filename>&cachedir;/archives/</filename></term>
536
Zone de stockage pour les paquets r�cup�r�s.
537
�l�ment de configuration : <literal>Dir::Cache::Archives</literal>.
541
<varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>
543
Zone de stockage pour les paquets en transit.
544
�l�ment de configuration : <literal>Dir::Cache::Archives</literal> (implicitement, partial).
548
<varlistentry><term><filename>&statedir;/lists/</filename></term>
550
Zone de stockage des informations concernant chaque ressource sp�cifi�e dans
552
�l�ment de configuration : <literal>Dir::State::Lists</literal>.
556
<varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
558
Zone de stockage pour les informations d'�tat des paquets en transit.
559
�l�ment de configuration : <literal>Dir::State::Lists</literal> (implicit partial).
565
<refsect1><title>Voir aussi</title>
567
&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;,
568
&apt-conf;, &apt-config;,
569
le guide � APT users guide � dans &docdir;, &apt-preferences;,
574
<refsect1><title>Diagnostic</title>
575
<para><command>apt-get</command> renvoie z�ro apr�s une op�ration normale, le d�cimal 100
576
en cas d'erreur.</para>