NAME

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

SYNOPSIS

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

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 :

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

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

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

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

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 urpmi.addmedia. Pour supprimer un support existant, utilisez urpmi.removemedia. Pour mettre à jour la liste des paquetages (par exemple si l'archive ftp a été modifiée), utilisez urpmi.update.

OPTIONS

--help

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

--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.

--media 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 --update est précisé). Aucun rpm ne sera récupéré sur un autre support.

--excludemedia media1,...,mediaN

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

--searchmedia 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 à --auto-select. Les dépendances de ces paquetages peuvent cependant être trouvées sur un autre support.

--sortmedia 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, media1 sera utilisé en premier, puis le media2, et ainsi de suite. Les supports non listés sont pris en compte après les autres.

--synthesis 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.

--auto

Installer toutes les dépendances requises automatiquement.

--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.

--auto-update

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

--no-install

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

--no-uninstall

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

--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 --auto-select) lorsque qu'une erreur de dépendance se produit.

--split-level nombre

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

--split-length nombre

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

--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 -y).

--src nom

Rechercher un paquetage source correspondant à nom et sélectionner toutes ses dépendances (c'est à dire ses BuildRequires) par défaut, sauf si l'option --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).

--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).

--clean

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

--noclean

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

--force

Répondre oui à toutes les questions.

--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.

--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.

--parallel 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). alias définit quel module d'extension doit être utilisé par urpmi (actuellement, urpmi-parallel-ka-run ou urpmi-parallel-ssh sont disponibles) et quelles machines doivent être mises à jour. Cet alias est défini dans le fichier /etc/urpmi/parallel.cfg comme décrit ci-dessous.

--root répertoire

Utiliser le 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.

--use-distrib répertoire

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

--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.

--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.

--curl-options 'options'

--rsync-options 'options'

--wget-options '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.

--limit-rate débit

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

--resume

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

--retry nombre

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

--proxy proxyhost[:port]

Utiliser le proxy HTTP spécifié.

--proxy-user utilisateur:mot_de_passe

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

--bug répertoire

Créer un rapport de bogue dans 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.

--env 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 --bug.

--verify-rpm

--no-verify-rpm

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

--test

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

--excludepath chaine

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

--excludedocs

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

--ignorearch

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

--ignoresize

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

--repackage

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

Note: si vous utilisez urpmi.recover pour activer la politique de sauvegarde des paquetage, vous n'avez pas besoin de cette option car 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.

--noscripts

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

--skip 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 /etc/urpmi/skip.list (voir urpmi.files(5)).

--more-choices

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

--nolock

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

--norebuild

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

--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).

-a

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

-p

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

-P

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

-y

C'est l'équivalent de --fuzzy.

-s nom

C'est l'équivalent de --src.

-q

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

-v

Propose un mode bavard avec différents messages.

EXEMPLES

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

Récupérer /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 foo- dans leur nom.

FICHIERS

Voir urpmi.files(5).

CODES DE SORTIE

1. Incohérence de la ligne de commande.

2. Problèmes d'enregistrement des paquetages locaux.

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

4. Support non sélectionné.

5. Support déjà existant.

6. Impossibilité de sauvegarder la configuration.

7. Base de données urpmi verrouillée.

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

9. Impossibilité d'ouvrir rpmdb.

10. Certains fichiers manquent pour l'installation.

11. Certaines transactions ont échoué mais pas toutes.

12. Toutes les transactions ont échoué.

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

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

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é 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.

AUTEUR

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

VOIR AUSSI

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

TRADUCTION

Christophe Berthelé 2006

cpanm urpm

perl -MCPAN -e shell
install urpm