summaryrefslogtreecommitdiffstats
path: root/pod/fr/urpmi.8.pod
blob: 5e050a0ecb40a119bb7a59a477d75609bafa92e2 (plain)
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
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
=head1 NAME

urpmi - téléchargement, installation et résolution de dépendances de rpm

=head1 SYNOPSIS

    urpmi [options] [noms_paquetages | fichiers_rpm...]

=head1 DESCRIPTION

Le rôle d'urpmi est d'installer des paquetages rpm, ainsi que leurs
dépendances. Il peut aussi être utilisé pour installer les dépendances
de fabrication d'un srpm (paquetage source d'un rpm), ou les dépendances de
fabrication à partir du fichier spec d'un rpm; ou bien installer un
paquetage source lui-même afin de le refabriquer plus tard.

Urpmi peut-être comparé à rpm, comme insmod l'est avec modprobe, ou
dpkg avec apt-get. Lancez juste urpmi avec ce que vous pensez être le nom
du paquetage et urpmi va :

=over 4

=item *

Proposer différents noms de paquetages si le nom est ambigü et sortir.

=item *

Si un seul paquetage est trouvé, vérifier si les dépendances sont déjà
installées.

=item *

Si ça n'est pas le cas, proposer d'installer les dépendances et en cas
d'acceptation, réalise cette opération.

=item *

Terminer par l'installation du ou des paquetages demandés.

=back

Urpmi supporte les installations à partir de divers supports (ftp, http,
rsync, volumes locaux ou nfs, supports amovibles tels que CDROMs ou DVDs)
et est capable d'installer les dépendances à partir d'un support différent
de celui du paquetage. Pour les supports amovibles, urpmi peut vous
demander d'insérer le disque adéquat si nécessaire.

Pour ajouter un nouveau support contenant des rpms, lancez C<urpmi.addmedia>.
Pour supprimer un support existant, utilisez C<urpmi.removemedia>.
Pour mettre à jour la liste des paquetages (par exemple si l'archive ftp
a été modifiée), utilisez C<urpmi.update>.

=head1 OPTIONS

=over

=item B<--help>

Afficher un message d'aide et sortir (même chose que B<-h> or B<-?>).

=item B<--update>

N'utiliser que le support de mise à jour. Cela signifie qu'urpmi ne
cherchera les paquetages et ne résoudra les dépendances que sur le
support de mise à jour.

=item B<--media> I<media1,...,mediaN>

Selectionner un support spécifique a utiliser, au lieu d'utiliser
par défaut tous les supports disponibles (ou tous les supports de mise
à jour si B<--update> est précisé).
Aucun rpm ne sera récupéré sur un autre support.

=item B<--excludemedia> I<media1,...,mediaN>

Ne pas utiliser le ou les supports spécifiés.

=item B<--searchmedia> I<media>

N'utiliser que le support précisé pour rechercher les paquetages listés
dans la ligne de commande, ou qui sont trouvés grâce à B<--auto-select>.
Les dépendances de ces paquetages peuvent cependant être trouvées sur un
autre support.

=item B<--sortmedia> I<media1,...,mediaN>

Définir l'ordre d'utilisation des supports spécifiés. Des sous-chaines
peuvent être utilisées pour désigner plus simplement plusieurs supports.
Avec cette option, C<media1> sera utilisé en premier, puis le C<media2>, et
ainsi de suite. Les supports non listés sont pris en compte après les autres.

=item B<--synthesis> I<fichier>

Utiliser le fichier de synthèse précisé au lieu de celui de la base urpmi pour
rechercher les paquetages et résoudre les dépendances.

=item B<--auto>

Installer toutes les dépendances requises automatiquement.

=item B<--auto-select>

Sélectionner tous les paquetages qui peuvent être mis à jour, en comparant
les paquetages installés et ceux présents sur les supports déclarés.

=item B<--auto-update>

Comme B<--auto-select>, mais mettre à jour les supports avant de sélectionner
les paquetages à mettre à jour. Ceci évite d'appeler C<urpmi.update> avant.

=item B<--no-install>

Télécharger seulement les paquetages sans les installer. Après l'opération
ils seront dans F</var/cache/urpmi/rpms>.

=item B<--no-uninstall>

Ne pas demander la désinstallation d'un paquetage mais interrompre plutôt.
Ceci peut être plus prudent en mode automatique.

=item B<--keep>

Quand certaines dépendances ne peuvent pas être satisfaites, modifier la
sélection des paquetages pour conserver les paquetages installés au lieu de
les désinstaller. Ce comportement bloque généralement la mise à jour des
paquetages listés dans la ligne de commande (ou en utilisant B<--auto-select>)
lorsque qu'une erreur de dépendance se produit.

=item B<--split-level> I<nombre>

Eclater l'opération urpmi en plusieurs petites transactions lorsque
le nombre de paquetages à mettre à jour est supérieur au I<nombre> précisé.
Cette option est active par défaut et la valeur par défaut de I<nombre>
est 20.

=item B<--split-length> I<nombre>

Eclater l'opération urpmi en plusieurs petites transactions d'au
minimum I<nombre> paquetages. La valeur par défaut est 1 et mettre une
valeur de 0 désactive l'éclatement en plusieurs transactions.

=item B<--fuzzy>

Désactiver la recherche rapide sur le nom exact du paquetage; cela
signifie qu'urpmi proposera tous les paquetages dont le nom correspond,
même si l'un d'entre eux correspond exactement au nom spécifié (c'est
équivalent de B<-y>).

=item B<--src> I<nom>

Rechercher un paquetage source correspondant à I<nom> et sélectionner toutes
ses dépendances (c'est à dire ses C<BuildRequires>) par défaut, sauf si
l'option B<--install-src> est utilisée pour installer le paquetage source
lui-même. (Vous pouvez aussi installer les dépendances de fabrication
directement à partir d'un fichier spec de rpm).

=item B<--install-src>

Installer uniquement le paquetage source (c'est à dire qu'aucun paquetage
binaire ne sera installé). Il n'est pas nécessaire d'être root pour utiliser
cette option (vous devez cependant avoir les droits d'écriture sur votre
arborescence de fabrication des paquetages).

=item B<--clean>

Supprimer tous les paquetages du répertoire cache F</var/cache/urpmi/rpms>.

=item B<--noclean>

N'enlever aucun paquetage du répertoire cache F</var/cache/urpmi/rpms>.

=item B<--force>

Répondre oui à toutes les questions.

=item B<--allow-nodeps>

Avec cette option, urpmi demandera à l'utilisateur lorsqu'une erreur se
produit si l'installation doit se poursuivre sans vérifier les dépendances.
Par défaut, urpmi sort immédiatement dans ce cas.

=item B<--allow-force>

Avec cette option, urpmi demandera à l'utilisateur lorsqu'une erreur se
produit si l'installation doit être forcée. Par défaut, urpmi sort
immédiatement dans ce cas.

=item B<--parallel> I<alias>

Activer l'exécution distribuée d'urpmi sur plusieurs machines (urpmi doit
être obligatoirement installé, mais il n'est pas nécessaire d'avoir un support
défini sur ces machines). I<alias> définit quel module d'extension doit
être utilisé par urpmi (actuellement, C<urpmi-parallel-ka-run> ou
C<urpmi-parallel-ssh> sont disponibles) et quelles machines doivent être
mises à jour. Cet alias est défini dans le fichier F</etc/urpmi/parallel.cfg>
comme décrit ci-dessous.

=item B<--root> I<répertoire>

Utiliser le I<répertoire> en mode chroot pour installer les paquetages.
Toutes les opérations et les scripts seront lancés après un chroot(2).
La base de données rpm qui repose dans l'arborescence cible sera
utilisée mais la configuration d'urpmi sera celle du système normal.

=item B<--use-distrib> I<répertoire>

Configurer urpmi à la volée à partir d'une arborescence de distribution, utile
pour installer en mode chroot grâce à l'option B<--root>. Consultez la description
de l'option B<--distrib> dans la page du manuel de C<urpmi.addmedia>.

=item B<--wget>

Utiliser wget pour le téléchargement des fichiers distants. Par défault, curl est
utilisé en priorité s'il est disponible, et wget sinon.

=item B<--curl>

Utiliser curl pour le téléchargement des fichiers distants. Par défault, curl est
utilisé en priorité s'il est disponible, et wget sinon.

=item B<--curl-options> I<'options'>

=item B<--rsync-options> I<'options'>

=item B<--wget-options> I<'options'>

Spécifier des options additionnelles qui doivent être passées à curl, rsync
ou wget pour le téléchargement des fichiers. Si plusieurs options doivent
être passées, séparez-les par des espaces et encadrez-les de guillemets.

=item B<--limit-rate> I<débit>

Essayer de limiter la vitesse de téléchargement. I<débit> est exprimé en
octets/sec. Cette option est désactivée par défaut.

=item B<--resume>

Continuer le transfert des fichiers partiellement téléchargés.

=item B<--retry> I<nombre>

Retenter I<nombre> de fois le téléchargement des fichiers via ftp ou http.

=item B<--proxy> I<proxyhost[:port|1080]>

Utiliser le proxy HTTP spécifié.

=item B<--proxy-user> I<utilisateur:mot_de_passe>

Utiliser l'utilisateur et le mot de passe spécifiés lors de l'authentification
du proxy. La syntaxe B<--proxy-user=ask> forcera urpmi a demander un utilisateur
et un mot de passe.

=item B<--bug> I<répertoire>

Créer un rapport de bogue dans I<répertoire>. Vous devrez envoyer une archive
compressée du répertoire au mainteneur d'urpmi afin de tenter de reproduire
(dans la mesure du possible) l'anomalie.

=item B<--env> I<répertoire>

Utiliser un environnement différent directement à partir d'un rapport d'anomalie
afin de la reproduire. L'argument est le même que celui donné à l'option B<--bug>.

=item B<--verify-rpm>

=item B<--no-verify-rpm>

Activer ou désactiver la vérification de la signature du rpm. La vérification
est activée par défaut.

=item B<--test>

Tester l'installation des paquetages mais sans réellement installer quoique
ce soit ni modifier le système. (C'est l'équivalent de C<rpm --test>).

=item B<--excludepath> I<chaine>

Ne pas installer les fichiers dont le nom commence par I<chaine> (comme
C<rpm --excludepath>).

=item B<--excludedocs>

Ne pas installer les fichiers de documentation (comme C<rpm --excludedocs>).

=item B<--ignorearch>

Autoriser l'installation des paquetages qui ne correspondent pas à l'architecture
de la machine hôte. C'est l'équivalent de C<rpm --ignorearch>.

=item B<--ignoresize>

Ne pas vérifier la taille disponible sur le système de fichiers avant l'installation.
C'est l'équivalent de C<rpm --ignoresize>.

=item B<--repackage>

Sauvegarder l'état des paquetages mis à jour; en d'autres termes, sauvegarder
les anciens paquetages (généralement dans F</var/spool/repackage> mais vous
pouvez modifier cela par une macro rpm). C'est l'équivalent de l'option
B<--repackage> de la commande rpm.

I<Note:> si vous utilisez C<urpmi.recover> pour activer la politique de
sauvegarde des paquetage, vous n'avez pas besoin de cette option car
C<urpmi.recover> surchargera globalement la macro rpm permettant la sauvegarde
des transactions de re-génération des paquetages sur l'ensemble du système.

=item B<--noscripts>

Ne pas exécuter les scriptlets.
C'est l'équivalent de C<rpm --noscripts>.

=item B<--skip> I<motif,...>

Vous pouvez spécifier une liste de paquetages dont l'installation doit être
sautée. Vous pouvez aussi inclure des motifs encadrés par //, exactement
comme dans F</etc/urpmi/skip.list> (voir urpmi.files(5)).

=item B<--more-choices>

Quand plusieurs paquetages sont trouvés, proposer plus de choix que celui
par défaut.

=item B<--nolock>

Ne pas verrouiller la base de données rpm et urpmi. Cela peut être utile conjugué
avec l'option B<--root>.

=item B<--norebuild>

Ne pas tenter de reconstruire les fichiers hdlist à partir des paquetages si le
hdlist original n'était pas lisible ou était corrompu.

=item B<--strict-arch>

Ne mettre à jour les paquetages que si la nouvelle version correspond à
l'architecture installée. Principalement utile pour les machines qui supportent
plusieurs architectures (32 et 64 bit).

=item B<-a>

Si plusieurs paquetages correspondent au nom donné, les installer tous.

=item B<-p>

Autoriser la recherche dans les applications que fournit le paquetage (c'est
le comportement par défaut)

=item B<-P>

Ne pas rechercher dans les applications que fournit le paquetage (c'est
l'opposé de B<-p>).

=item B<-y>

C'est l'équivalent de B<--fuzzy>.

=item B<-s> I<nom>

C'est l'équivalent de B<--src>.

=item B<-q>

Mode silencieux : lors de l'appel d'un paquetage aucun message de mise à jour
n'est affiché.

=item B<-v>

Propose un mode bavard avec différents messages.

=back

=head1 EXEMPLES

    urpmi ssh://foo@bar.net/home/foo/test.rpm

Récupérer F</home/foo/test.rpm> sur le serveur bar.net via ssh en tant
qu'utilisateur foo.
Vous pouvez utiliser votre clé publique ou entrer votre mot de passe.

    urpmi --media foo- --auto-select

Récupérer toutes les mises à jour sur les supports contenant C<foo-> dans leur nom.

=head1 FICHIERS

Voir urpmi.files(5).

=head1 CODES DE SORTIE

=over

=item 1

Incohérence de la ligne de commande.

=item 2

Problèmes d'enregistrement des paquetages locaux.

=item 3

Impossibilité de récupérer le paquetage source.

=item 4

Support non sélectionné.

=item 5

Support déjà existant.

=item 6

Impossibilité de sauvegarder la configuration.

=item 7

Base de données urpmi verrouillée.

=item 8

Impossibilité de lire ou écrire un rapport d'anomalie.

=item 9

Impossibilité d'ouvrir rpmdb.

=item 10

Certains fichiers manquent pour l'installation.

=item 11

Certaines transactions ont échoué mais pas toutes.

=item 12

Toutes les transactions ont échoué.

=item 13

Certains fichiers manquent et quelques transactions ont échoué mais pas toutes.

=item 14

Certains fichiers manquent et toutes les transactions ont échoué.

=back

=head1 RAPPORT D'ANOMALIE

Si vous trouvez une anomalie dans urpmi, merci de la rapporter et
utilisant la commande :

    urpmi --bug répertoire_anomalie ...

Ceci va créer automatiquement un répertoire appelé F<répertoire_anomalie>
contenant les fichiers nécessaires pour le reproduire si possible. Merci
de tester le rapport en utilisant :

    urpmi --env répertoire_anomalie ...

afin de vérifier si l'anomalie est toujours présente. Evidemment, seules
les anomalies reproductibles ont une chance d'être résolues. Pour envoyer le rapport
d'anomalie, créez un fichier tarball de ce répertoire et envoyez le directement
au mainteneur courant avec la description de ce qui, d'après vous, ne va pas.

=head1 AUTEUR

Pascal Rigaux (auteur original), François Pons,
Rafael Garcia-Suarez, <rgarciasuarez@mandriva.com> (maintaineur courant)

=head1 VOIR AUSSI

urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpme(8),
urpmf(8), urpmq(8), urpmi.cfg(5), urpmi.files(5).

=head1 TRADUCTION

Christophe Berthelé 2006