1
.\" This manpage has been automatically generated by docbook2man
2
.\" from a DocBook document. This tool can be found at:
3
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
4
.\" Please send any bug reports, improvements, comments, patches,
5
.\" etc. to Steve Cheng <steve@ggi-project.org>.
6
.TH "APT-GET" "8" "26 March 2005" "" ""
9
apt-get \- Utilitaire d'APT pour la manipulation de paquets -- interface en ligne de commande.
12
\fBapt-get\fR [ \fB-hvs\fR ] [ \fB-o=\fIoption de configuration\fB\fR ] [ \fB-c=\fIfichier\fB\fR ] { \fBupdate\fR | \fBupgrade\fR | \fBdselect-upgrade\fR | \fBinstall \fIpaquet\fB\fI ...\fB\fR | \fBremove \fIpaquet\fB\fI ...\fB\fR | \fBsource \fIpaquet\fB\fI ...\fB\fR | \fBbuild-dep \fIpaquet\fB\fI ...\fB\fR | \fBcheck\fR | \fBclean\fR | \fBautoclean\fR }
16
\fBapt-get\fR est l'outil en ligne de commande pour manipuler les
17
paquets. Il peut �tre consid�r� par l'utilisateur comme un g�n�rateur de
18
sortie pour les autres outils de la biblioth�que APT.
20
� moins que l'option \fB-h\fR, ou \fB--help\fR ne soit donn�e, l'une des
21
commandes suivantes doit �tre pr�sente.
24
La commande update permet de resynchroniser un fichier r�pertoriant
25
les paquets disponibles et sa source. Ces fichiers sont r�cup�r�s aux
26
endroits sp�cifi�s dans \fI/etc/apt/sources.list\fR\&. Ainsi, lorsqu'on
27
utilise une archive Debian, cette commande r�cup�re les fichiers
28
\fIPackages.gz\fR et les analyse de mani�re � rendre disponibles
29
les informations concernant les nouveaux paquets et les paquets mis � jour.
30
On doit toujours ex�cuter une commande update avant les commandes
31
upgrade ou dist-upgrade\&. Il faut savoir que l'indicateur
32
de progression d'ensemble n'est pas correct puisque la taille de ces fichiers
33
ne peut �tre connue � l'avance.
36
La commande upgrade permet d'installer les versions les plus
37
r�centes de tous les paquets pr�sents sur le syt�me en utilisant les
38
sources �num�r�es dans \fI/etc/apt/sources.list\fR\&. Les paquets
39
install�s dont il existe de nouvelles versions sont r�cup�r�s et mis �
40
niveau. En aucun cas des paquets d�j� install�s ne sont supprim�s\~; de
41
m�me, des paquets qui ne sont pas d�j� install�s ne sont ni r�cup�r�s ni
42
install�s. Les paquets dont de nouvelles versions ne peuvent pas �tre
43
install�es sans changer le statut d'installation d'un autre paquet sont
44
laiss�s dans leur version courante. On doit d'abord ex�cuter la commande
45
update pour que \fBapt-get\fR connaisse l'existence de
46
nouvelles versions des paquets.
49
dselect-upgrade est utilis�e conjointement avec \fBdselect\fR(8), l'interface
50
traditionnelle Debian pour la gestion des paquets.
51
La commande dselect-upgrade suit les modifications faites par
52
\fBdselect\fR(8) dans le champ Status des paquets disponibles, et effectue
53
les actions n�cessaires � la r�alisation de cet �tat (par exemple,
54
suppression d'anciens paquets, installation de nouveaux paquets).
57
La commande dist-upgrade effectue la fonction upgrade en
58
y ajoutant une gestion intelligente des changements de d�pendances dans les
59
nouvelles versions des paquets\~; \fBapt-get\fR poss�de un syst�me
60
�\~intelligent\~� de r�solution des conflits et il essaye, quand c'est
61
n�cessaire, de mettre � niveau les paquets les plus importants aux d�pens
62
des paquets les moins importants. Le fichier \fI/etc/apt/sources.list\fR
63
contient une liste de sources o� r�cup�rer les paquets d�sir�s.
64
Voyez aussi \fBapt_preferences\fR(5) pour un m�canisme d'annulation des param�tres
68
La commande install est suivie par un ou plusieurs paquets �
69
installer. Chaque paquet est un nom de paquet\~; ce n'est pas un nom de
70
fichier pleinement d�termin� (par exemple, dans un syst�me Debian GNU/Linux,
71
on indiquera libc6 et non pas libc6_1.9.6-2.deb). Tous les
72
paquets requis par le(s) paquet(s) que l'on veut installer sont aussi
73
r�cup�r�s et install�s. On se sert du fichier
74
\fI/etc/apt/sources.list\fR pour localiser les paquets d�sir�s. Quand
75
un trait d'union est accol� (sans espace interm�diaire) au nom d'un paquet
76
d�j� install�, ce paquet est supprim�. De m�me on peut ajouter un signe
77
�\~+\~� pour d�signer un paquet � installer.
78
Cette derni�re fonctionnalit� peut �tre utilis�e pour annuler les d�cisions
79
prises par le syst�me de r�solution des conflits d'apt-get.
81
On peut choisir d'installer une version particuli�re d'un paquet en faisant
82
suivre son nom par un signe �gal et par la version. Cette version sera
83
localis�e et l'installation sera demand�e. On peut aussi choisir une
84
distribution particuli�re en faisant suivre le nom du paquet par une barre
85
oblique et par le nom de la distribution ou de l'archive (stable, testing,
88
Avec ces possibilit�s de choisir la version, de vieilles versions d'un paquet
89
peuvent �tre install�es. Il faut faire attention.
91
Enfin, le m�canisme de \fBapt_preferences\fR(5) permet de cr�er d'autres r�gles pour
92
l'installation des paquets.
94
Quand aucun paquet ne correspond � l'expression donn�e en argument et que cette
95
expression contient l'un des caract�res �\~\&.\~�, �\~?\~� ou
96
�\~*\~�, on consid�re que c'est une expression rationnelle POSIX et
97
elle est appliqu�e � tous les paquets de la base de donn�es. Tout paquet
98
correspondant est install� (ou supprim�). Notez que la comparaison est
99
effectu�e par sous-cha�ne et �\~lo\~� correspond aussi bien �
100
�\~how-lo\~� qu'� �\~lowest\~�. Si vous ne le voulez pas, ancrez
101
l'expression par un caract�re �\~^\~� ou un caract�re �\~$\~�,
102
ou bien cr�ez une expression plus pr�cise.
105
La commande remove est identique � la commande install\~;
106
Mais les paquets sont supprim�s et non pas install�s. Quand un signe plus est
107
accol� (sans espace interm�diaire) au nom du paquet, le paquet est install� au lieu
111
Avec la commande source, \fBapt-get\fR r�cup�re des paquets
112
sources. APT examine les paquets disponibles pour choisir le paquet source
113
� r�cup�rer. Il trouve ensuite et t�l�charge dans le r�pertoire courant
114
la version la plus r�cente. Les paquets source sont suivis diff�remment que
115
les paquets binaires, via les lignes de type deb-src dans le fichier
116
\fB\fIsources.list\fB\fR(5)
117
\&. On n'obtiendra probablement pas les m�mes sources que celles
118
du paquet install� ou celles du paquet qu'on pourrait installer. Si l'option
119
\fB--compile\fR est sp�cifi�e, le paquet est compil� en un binaire .deb
120
avec \fBdpkg-buildpackage\fR\&. Si \fB--download-only\fR est
121
sp�cifi�, le source n'est pas d�compact�.
123
De la m�me fa�on qu'avec les paquets binaires, on peut r�cup�rer une version
124
particuli�re d'un paquet source en faisant suivre son nom par un signe �gal
125
et par la version. Cela permet une comparaison exacte entre le nom du paquet
126
source et la version\~; cela lance implicitement la commande
127
APT::Get::Only-Source\&.
129
Notez que les paquets sources ne sont pas suivis comme le sont les paquets
130
binaires. Ils ne sont pr�sents que dans le r�pertoire courant et sont
131
semblables � des sources t�l�charg�s sous forme de tarball.
134
Avec la commande build-dep, apt-get installe ou supprime des paquets
135
dans le but de satisfaire les d�pendances de construction d'un paquet source.
136
Pour l'instant, dans la cas d'un paquet virtuel, un paquet est choisi au
140
La commande check est un outil de diagnostic\~; il met � jour
141
le cache des paquets et cherche des d�pendances d�fectueuses.
144
La commande clean nettoie le r�f�rentiel local des paquets
145
r�cup�r�s. Il supprime tout, except� le fichier lock situ� dans
146
\fI/var/cache/apt/archives/\fR et \fI/var/cache/apt/archives/partial/\fR\&.
147
Quand APT est utilis� comme mode de \fBdselect\fR(8), clean est effectu�
148
automatiquement. Quand on n'utilise pas \fBdselect\fR(8), il faut ex�cuter
149
apt-get clean de temps en temps si l'on veut lib�rer de l'espace
153
Tout comme clean, autoclean nettoie le r�f�rentiel local
154
des paquets r�cup�r�s. La diff�rence est qu'il supprime uniquement les paquets
155
qui ne peuvent plus �tre t�l�charg�s et qui sont grandement inutiles.
156
On peut ainsi contr�ler la taille de ce cache sur une longue p�riode.
157
Tant qu'elle n'est pas activ�e, l'option de configuration
158
APT::Clean-Installed emp�che la suppression de paquets install�s.
161
Toutes les options en ligne de commande peuvent �tre positionn�es via le
162
fichier de configuration\~; les descriptifs indiquent l'option de
163
configuration � positionner. En ce qui concerne les options bool�ennes,
164
on peut annuler le fichier de configuration en utilisant quelque chose comme
165
\fB-f-\fR,\fB--no-f\fR, \fB-f=no\fR ou d'autres variantes.
169
\fB--download-only\fR
170
R�cup�ration seule\~; les paquets sont ramen�s mais ne sont ni d�paquet�s
171
ni install�s. �l�ment de configuration\~: APT::Get::Download-Only\&.
176
Correction\~; essaye de r�parer un syst�me dont les d�pendances sont
177
d�fectueuses. Cette option, utilis�e avec install ou remove, peut omettre
178
tout paquet de fa�on � permettre � APT de d�duire une solution viable.
179
Chaque paquet sp�cifi� doit compl�tement corriger le probl�me. Cette option
180
est quelquefois n�cessaire lorsque l'on ex�cute APT pour la premi�re fois\~;
181
APT lui-m�me interdit les d�pendances d�fectueuses dans un syst�me. Il est
182
possible que la structure de d�pendances d'un syst�me soit tellement
183
corrompue qu'elle requiert une intervention manuelle (ce qui veut dire la
184
plupart du temps utiliser \fBdselect\fR(8) ou \fBdpkg --remove\fR pour �liminer
185
les paquets en cause). L'utilisation de cette option conjointement avec
186
\fB-m\fR peut produire une erreur dans certaines situations.
187
�l�ment de configuration\~: APT::Get::Fix-Broken\&.
191
\fB--ignore-missing\fR
194
Ignorer les paquets manquants\~; si des paquets ne peuvent �tre
195
r�cup�r�s, ou, apr�s r�cup�ration, ne satisfont pas au contr�le d'int�grit�,
196
cette commande met ces paquets de c�t� et g�re le r�sultat. Utiliser cette
197
option conjointement avec \fB-f\fR peut produire une erreur dans
198
certaines situations. Quand un paquet, s�lectionn� pour une installation
199
(particuli�rement si c'est mentionn� en ligne de commande), ne peut �tre
200
r�cup�r�, il est mis silencieusement de c�t�. �l�ment de configuration\~:
201
APT::Get::Fix-Missing\&.
204
Pas de r�cup�ration. Le mieux est d'utiliser cette option avec
205
\fB--ignore-missing\fR pour forcer APT � n'utiliser que les .deb qu'il a
207
�l�ment de configuration\~: APT::Get::Download\&.
212
Mode silencieux\~; cette commande produit une sortie destin�e �
213
l'enregistrement dans un fichier-journal en omettant les indicateurs de
214
progression. Un plus grand nombre de �\~q\~� (2 au plus) produit un
216
On peut aussi utiliser \fB-q=#\fR pour positionner le niveau de silence,
217
et annuler le fichier de configuration. Notez qu'un niveau de silence �gal � 2
218
implique \fB-y\fR et vous ne devez jamais utiliser \fB-qq\fR sans
219
l'accompagner d'un modificateur tel que \fB-d\fR, \fB--print-uris\fR
220
ou \fB-s\fR\~: APT pourrait ex�cuter des actions inattendues\~!
221
�l�ment de configuration\~: quiet\&.
234
Simulation\~; cette commande r�alise une simulation des actions qui
235
seraient ex�cut�es mais ne modifie pas le syst�me.
236
�l�ment de configuration\~: APT::Get::Simulate\&.
238
la simulation affiche une s�rie de lignes repr�sentant chacune une op�ration
239
de dpkg, Configure (Conf),Remove (Remv),Unpack (Inst). Les crochets encadrent
240
des paquets endommag�s et des crochets n'encadrant rien indiquent que les
241
dommages n'ont aucune cons�quence (rare).
248
R�pond automatiquement oui aux questions\~; pr�sume �\~oui\~�
249
comme r�ponse � toutes les questions et s'ex�cute de mani�re non interactive.
250
Dans le cas d'une situation ind�sirable, comme le changement d'un paquet
251
gel� ou la suppression d'un paquet essentiel, apt-get
253
�l�ment de configuration\~: APT::Get::Assume-Yes\&.
257
\fB--show-upgraded\fR
258
Afficher les paquets mis � niveau\~; affiche une liste de tous les paquets �
259
mettre � niveau. �l�ment de configuration\~: APT::Get::Show-Upgraded\&.
263
\fB--verbose-versions\fR
264
Afficher les versions compl�tes des paquets install�s ou mis � niveau.
265
�l�ment de configuration\~: APT::Get::Show-Versions\&.
272
Cette commande compile un paquet source apr�s l'avoir r�cup�r�.
273
�l�ment de configuration\~: APT::Get::Compile\&.
276
Cette commande ignore la marque �\~Hold\~� d'un paquet\~; par ce biais,
277
\fBapt-get\fR ignore un �\~hold\~� plac� sur un paquet. cela peut �tre utile
278
avec dist-upgrade pour annuler un grand nombre de �\~hold\~�
279
ind�sirables. �l�ment de configuration\~: APT::Ignore-Hold\&.
282
Aucune mise � niveau\~; quand elle est utilis�e avec install,
283
cette commande emp�che les paquets list�s sur la ligne de commande d'�tre mis
285
�l�ment de configuration\~: APT::Get::Upgrade\&.
288
Forcer l'acceptation\~; cette option est dangereuse parce qu'elle laisse
289
APT continuer sans poser de questions quand il r�alise quelque chose de
290
potentiellement dommageable. Cette option ne doit �tre utilis�e que dans des
291
circonstances tr�s sp�ciales. Utiliser force-yes peut d�truire le syst�me\~!
292
�l�ment de configuration\~: APT::Get::force-yes\&.
295
Au lieu d'aller chercher les paquets � installer, leurs URI sont affich�es.
296
Chaque URI a un chemin, un nom de fichier destination, une taille et une
297
cl� md5 attendue. Notez que le nom de fichier � afficher ne correspond pas
298
toujours au nom de fichier sur le site distant\~! Cette option marche
299
aussi avec la commande source\&.
300
�l�ment de configuration\~: APT::Get::Print-URIs\&.
303
Utiliser purge � la place de remove pour supprimer tout ce qui peut �tre
305
Un ast�risque (*)sera affich� pr�s des paquets qui vont �tre purg�s.
306
�l�ment de configuration\~: APT::Get::Purge\&.
309
R�installer les paquets d�j� install�s avec leur version la plus r�cente.
310
�l�ment de configuration\~: APT::Get::ReInstall\&.
313
Cette option est activ�e par d�faut\~; utilisez --no-list-cleanup
314
pour la d�sactiver. Quand elle est activ�e, \fBapt-get\fR g�re
315
automatiquement le contenu de \fI/var/lib/apt/lists\fR afin d'assurer
316
que les fichiers obsol�tes sont effac�s. La seule raison de la d�sactiver
317
est une modification fr�quente de votre liste de sources.
318
�l�ment de configuration\~: APT::Get::List-Cleanup\&.
322
\fB--target-release\fR
324
\fB--default-release\fR
325
Cette option contr�le l'entr�e par d�faut pour les questions de
326
distribution\~; une �tiquette (pin) par d�faut dont la priorit� vaut 990
327
est cr�� en utilisant la cha�ne sp�cifi�e. Le fichier des pr�f�rences peut
328
annuler cette d�cision. En clair, cette option permet de contr�ler simplement
329
dans quelle distribution seront r�cup�r�s les paquets. Par exemple\~:
330
\fB-t '2.1*'\fR ou \fB-t unstable\fR\&.
331
�l�ment de configuration\~: APT::Default-Release\&.
332
Voyez aussi la page de manuel \fBapt_preferences\fR(5)\&.
335
Ne r�alise que les op�rations �\~triviales\~�. Logiquement ceci peut �tre
336
consid�r� comme relatif � \fB--assume-yes\fR\&. Alors que
337
\fB--assume-yes\fR r�pond oui � n'importe quelle question,
338
\fB--trivial-only\fR r�pond non.
339
�l�ment de configuration\~: APT::Get::Trivial-Only\&.
342
Quand des paquets doivent �tre supprim�s, apt-get s'arr�te imm�diatement sans
343
poser de questions. �l�ment de configuration\~: APT::Get::Remove\&.
346
Cette option n'a de sens qu'avec la commande source\&. Elle indique
347
que les noms de sources donn�s ne doivent pas �tre rep�r�s � travers la
348
table binaire. Cela signifie que si cette option est choisie, la commande
349
source acceptera seulement des noms de paquets-source
350
comme argument\~; elle n'acceptera pas de les rechercher � partir des noms de
351
paquets binaires correspondants.
352
�l�ment de configuration\~: APT::Get::Only-Source
357
Ne r�cup�rer que le fichier diff ou tar d'une archive de source.
358
�l�ment de configuration\~: APT::Get::Diff-Only et
359
APT::Get::Tar-Only\&.
362
Ne traiter que les d�pendances de construction pour telle architecture.
363
�l�ment de configuration\~: APT::Get::Arch-Only
368
Affiche un mode d'emploi succinct.
373
Affiche la version du programme.
378
Fichier de configuration\~; indique quel fichier de configuration utiliser.
379
Le programme lit le fichier de configuration par d�faut, puis celui-ci.
380
Voyez \fB\fIapt.conf\fB\fR(5)
386
Donne une option de configuration\~; cela fixe une option de configuration
387
arbitraire. La syntaxe est : \fB-o Foo::Bar=bar\fR\&.
390
\fB\fI/etc/apt/sources.list\fB\fR
391
Liste les emplacements o� aller chercher les paquets.
392
�l�ment de configuration\~: Dir::Etc::SourceList\&.
394
\fB\fI/etc/apt/apt.conf\fB\fR
395
Fichier de configuration d'APT.
396
�l�ment de configuration\~: Dir::Etc::Main\&.
398
\fB\fI/etc/apt/apt.conf.d/\fB\fR
399
�l�ments du fichier de configuration d'APT.
400
�l�ment de configuration\~: Dir::Etc::Parts\&.
402
\fB\fI/etc/apt/preferences\fB\fR
403
Fichier des pr�f�rences.
404
C'est dans ce fichier qu'on peut faire de l'�tiquetage (pinning) c'est-�-dire,
405
choisir d'obtenir des paquets d'une source distincte ou d'une distribution
407
�l�ment de configuration\~: Dir::Etc::Preferences\&.
409
\fB\fI/var/cache/apt/archives/\fB\fR
410
Zone de stockage pour les paquets r�cup�r�s.
411
�l�ment de configuration\~: Dir::Cache::Archives\&.
413
\fB\fI/var/cache/apt/archives/partial/\fB\fR
414
Zone de stockage pour les paquets en transit.
415
�l�ment de configuration\~: Dir::Cache::Archives (implicitement, partial).
417
\fB\fI/var/lib/apt/lists/\fB\fR
418
Zone de stockage des informations concernant chaque ressource sp�cifi�e dans
419
\fB\fIsources.list\fB\fR(5)
421
�l�ment de configuration\~: Dir::State::Lists\&.
423
\fB\fI/var/lib/apt/lists/partial/\fB\fR
424
Zone de stockage pour les informations d'�tat des paquets en transit.
425
�l�ment de configuration\~: Dir::State::Lists (implicit partial).
430
, \fBdselect\fR(8), \fB\fIsources.list\fB\fR(5)
431
, \fB\fIapt.conf\fB\fR(5)
434
le guide �\~APT users guide\~� dans /usr/share/doc/apt/, \fBapt_preferences\fR(5),
438
\fBapt-get\fR retourne z�ro apr�s un d�roulement normal, et le nombre
439
d�cimal 100 en cas d'erreur.
442
Voyez la page concernant les bogues de APT <URL:http://bugs.debian.org/src:apt>\&.
443
Si vous voulez rapporter un bogue, consultez le texte
444
\fI/usr/share/doc/debian/bug-reporting.txt\fR ou utilisez la
445
commande \fBreportbug\fR(1)
449
APT a �t� �crit par l'�quipe APT <apt@packages.debian.org>\&.
452
J�r�me Marant. 2000\~; mise � jour : Philippe Batailler. 2004.