=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]>

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