PACMAN(8)

NOM
pacman - Utilitaire de gestion de paquetage

SYNOPSIS

pacman <operation> [options] [targets]

DESCRIPTION

Pacman is a package management utility that tracks installed packages on a Linux system. It features dependency support, package groups, install and uninstall scripts, and the ability to sync your local machine with a remote repository to automatically upgrade packages. Pacman packages are a zipped tar format.

Depuis la version 3.0.0, pacman est une interface à libalpm(3), la bibliothèque du “Gestionnaire de paquetage Arch Linux”. Cette bibliothèque permet d'écrire d'autres interfaces (par exemple, une interface graphique).

L'appel de pacman doit préciser la nature de l'opération désirée et la cible, généralement un paquetage ou un fichier, mais parfois aussi une URL ou une chaîne de caractère à rechercher. Les cibles sont passées comme arguments de la ligne de commande. On peut aussi donner comme argument un simple tiret (-) : les cibles seront alors lues sur l'entrée standard stdin, ce qui peut présenter un intérêt si l'entrée standard ne pointe pas vers le terminal mais vers la redirection d'une autre commande.

OPERATIONS

-D, --database
    Opère sur la base de données des paquetages, par exemple pour modifier dans la base de données de pacman certains attributs des paquetages installés, ou pour vérifier la compatbilité interne des bases de données des paquetages. Voyez les options afférentes ci-après.

-Q, --query
    Query the package database. This operation allows you to view installed packages and their files, as well as meta-information about individual packages (dependencies, conflicts, install date, build date, size). This can be run against the local package database or can be used on individual package files. In the first case, if no package names are provided in the command line, all installed packages will be queried. Additionally, various filters can be applied on the package list. See Query Options below.

-R, --remove
    Supprime des paquetages de votre système. On peut aussi marquer des groupes à supprimer : dans ce cas tous les paquetages du groupe seront supprimés. Les fichiers appartenant aux paquetages précisés seront supprimés et la base de donnée sera mise à jour. La plupart des fichiers de configuration seront sauvegardés avec l'extension .pacsave sauf si l'option --nosave est saisie. Voir REMOVE OPTIONS ci-dessous.

-S, --sync
    Synchronize packages. Packages are installed directly from the remote repositories, including all dependencies required to run the packages. For example, pacman -S qt will download and install qt and all the packages it depends on. If a package name exists in more than one repository, the repository can be explicitly specified to clarify the package to install: pacman -S testing/qt. You can also specify version requirements: pacman -S "bash>=3.2". Quotes are needed, otherwise the shell interprets ">" as redirection to a file.

    Outre des paquetages, on peut spécifier des groupes de paquetages. Par exemple, si gnome est le nom d'un groupe de paquetages déterminé, pacman -S gnome va ouvrir une boucle de saisie pour vous permettre de choisir les paquetages à installer à partir d'une liste numérotée. Le choix de paquetages se fait en donnant une liste de numéros séparés par des espaces ou des virgules. On peut même donner une suite de numéros consécutifs de paquetages en donnant le premier et le dernier numéro de paquetage séparés par un tiret (-). On peut exclure un paquetage ou une séquence de paquetage en faisant précéder le numéro ou l'intervalle de numéros d'un accent circonflexe (^).

    Packages that provide other packages are also handled. For example, pacman -S foo will first look for a foo package. If foo is not found, packages that provide the same functionality as foo will be searched for. If any package is found, it will be installed. A selection prompt is provided if multiple packages providing foo are found.

    Vous pouvez aussi utiliser pacman -Su pour mettre à jour tous les paquetages périmés. Voir les options Sync ci-dessous. Lors d'une mise à jour, pacman compare les versions pour déterminer quels paquetages ont besoin d'être mis à jour. Cette opération se déroule comme ceci :

        Alphanumérique:
          1.0a < 1.0b < 1.0beta < 1.0p < 1.0pre < 1.0rc < 1.0 < 1.0.a < 1.0.1
        Numérique:
          1 < 1.0 < 1.1 < 1.1.1 < 1.2 < 2.0 < 3.0.0

    De plus, il est possible d'intégrer une valeur date au nom de version : celle-ci sera prioritaire pour les comparaisons de version, à moins bien sûr que deux valeurs de date ne soient égales. Le format de date est version-rel. Par exemple 2:1.0-1 est toujours plus récent que 1:3.6-1.

-T, --deptest
    Check dependencies; this is useful in scripts such as makepkg to check installed packages. This operation will check each dependency specified and return a list of dependencies that are not currently satisfied on the system. This operation accepts no other options. Example usage: pacman -T qt "bash>=3.2".

-U, --upgrade
    Upgrade or add package(s) to the system and install the required dependencies from sync repositories. Either a URL or file path can be specified. This is a “remove-then-add” process. See Upgrade Options below; also see Handling Config Files for an explanation on how pacman takes care of configuration files.

-F, --files
    Consulte la base de données. Cette opération vous permet de retrouver les paquetages contenant un certain fichier, ou d'afficher les fichiers d'un paquetage donné. La recherche ne se fait que dans les paquetages répertoriés par votre base de donnée synchronisée. Voir les options de File ci-après.

-V, --version
    Affiche la version et rend la main.

-h, --help
    Affiche la syntaxe de l'actions demandée. Si aucune action n'est précisée, la page de syntaxe générale est affichée.

OPTIONS

-b, --dbpath <chemin>
    Specify an alternative database location (the default is /var/lib/pacman). This should not be used unless you know what you are doing. NOTE: If specified, this is an absolute path, and the root path is not automatically prepended.

-r, --root <chemin>
    Specify an alternative installation root (default is /). This should not be used as a way to install software into /usr/local instead of /usr. NOTE: If database path or log file are not specified on either the command line or in pacman.conf(5), their default location will be inside this root path. NOTE: This option is not suitable for performing operations on a mounted guest system. See --sysroot instead.

-v, --verbose
    Affiche le chemin de Root, des fichiers de configuration, de la base de données, du cache, etc.

--arch <arch>
    Specify an alternate architecture.

--cachedir <répertoire>
    Specify an alternative package cache location (the default is /var/cache/pacman/pkg). Multiple cache directories can be specified, and they are tried in the order they are passed to pacman. NOTE: This is an absolute path, and the root path is not automatically prepended.

--color <when>
    Indique quand il convient d'afficher en couleurs. Les options valides sont always, never, or auto. always force l'écriture en couleurs ; never la désactive, et auto active automatiquement la couleur pour l'affichage sur un terminal.

--config <fichier>
    Précise un fichier de configuration à utiliser.

--debug
    Affiche les messages de débugage. Il est conseillé d’activer cette option pour signaler les bugs à la Communauté ou sur un forum de discussion.

--gpgdir <répertoire>
    Fournit un répertoire de fichier où GnuPG pourra authentifier les signatures de paquetage (/etc/pacman.d/gnupg par défaut). Ce répertoire doit contenir deux fichiers : pubring.gpg et trustdb.gpg. pubring.gpg contient la clef publique de tous les paquetages ; trustdb.gpg, la base de données dite d'authentification, qui sert à confirmer que les clefs du trousseau sont sincères. NOTE: il faut donner ici un chemin absolu, le répertoire racine n'est pas a priori prépondérant.

--hookdir <répertoire>
    Précise le répertoire contenant les fichiers d'amorce (/etc/pacman.d/hooks par défaut). On peut ici donner plusieurs répertoires d'amorce, mais les derniers cités auront précédence pour pacman. NOTE: il faut donner des chemins absolus, le répertoire racine n'étant pas a priori prépondérant.

--logfile <fichier>
    Précise le nom du fichier-journal à créer. Il faut donner un chemin absolu ; peu importe ici le choix du répertoire-racine de l'installation.

--noconfirm
    acquitte automatiquement tous les messages et demandes de confirmation. À éviter sauf si vous souhaitez exécuter pacman dans un script.

--confirm
    Annule les effets d'une directive --noconfirm antérieure.

--disable-download-timeout
    Désactive les limites par défaut sur la vitesse de transfert et les délais de connexion. À activer si vous avez des problèmes de proxy ou avec de ports sécurisés.

--sysroot <répertoire>
    Fournit un répertoire racine pour l'installation. Pacman executera les chroot et chdir requis avant l'installation. Cela permet notamment d'adresser les périphériques ou hôtes montés sur votre système. Tous les chemins seront positionnés relativement à cette racine. Nécessite les privilègesd'administateur.

OPTIONS D'ECHANGE (POUR -S, -R AND -U)

-d, --nodeps
    Skips dependency version checks. Package names are still checked. Normally, pacman will always check a package’s dependency fields to ensure that all dependencies are installed and there are no package conflicts in the system. Specify this option twice to skip all dependency checks.

--assume-installed <package=version>
    Annexe un paquetage "bidon" virtuel, de numéro de version "version" à la liste des opérations, pour résoudre les dépendances. Cela permet de passer outre certaines vérifications de dépendance sans pour cela supprimer toutes les vérifications de dépendance ; pour les supprimer toutes, voir l'option --nodeps.

--dbonly
    Ajoute/supprime uniquement la base de donnée. Laisse tous les fichiers en place.

--noprogressbar
    Ne pas afficher la barre de progression pendant le téléchargement. Pour les scripts qui appellent pacman et récupèrent le code de sortie.

--noscriptlet
    Si un script d'install existe, ne pas l'exécuter. À éviter à moins de savoir ce que vous faites.

-p, --print
    N'affiche que les cibles, sans effectuer les opérations de maintenance (sync, remove ou upgrade). Utiliser --print-format pour configurer l'affichage des noms des cibles. Le format par défaut est"%l", qui préfixes les URLs d'un -S, les noms de fichier de -U, et les pkgname-pkgver d'un -R.

--print-format <format>
    Configure le format d'affichage pour l'option --print selon la syntaxe de la commande printf. Les attributs possibles sont : "%n" pour pkgname, "%v" pour pkgver, "%l" pour un emplacement, "%r" pour un dépôt, et "%s" pour les tailles de fichier. Complément de l'option de --print.

OPTIONS DE MISE À NIVEAU (POUR -S AND -U)

-w, --downloadonly
    Télécharge tous les paquetages depuis le serveur, mais rien n'est installé ni mis à jour.

--asdeps
    Installe tacitement des paquetages ; autrement dit, impose leur installation en leur donnant le statut de dépendances. C'est pratique pour makepkg et certains logiciels auxiliaires, qui ont besoin d'installer des paquetages comme dépendance avant de compiler le paquetage demandé.

--asexplicit
    Installe un paquetage explicitement. Autrement dit, modifie la raison de leur installation en explicitement installé. C'est pratique lorsque vous souhaitez marquer qu'une dépendance doit explicitement être installée, et que l'option de suppression --recursive ne devra pas supprimer.

--ignore <paquetage>
    Ordonne à pacman d'ignorer la mise à jour du paquetage même si une version plus récente est disponible. Il est ici possible de donner une liste de paquetages, séparés par des virgules.

--ignoregroup <groupe>
    Ordonne à pacman d'ignorer la mise à jour de tous les paquetages d'un groupe même si une version plus récente est disponible. Il est ici possible de donner une liste de groupes, séparés par des virgules.

--needed
    Installe seulement la cible qui n'est pas installée ou à jour.

--overwrite <glob>
    Passe outre les vérifications de conflit de fichier et écrase les fichiers contradictoires. Si le paquetage qu'on est sur le point d'installer contient des fichiers déjà installés et de même nom que glob, cette option écrasera ces fichiers. L'option --overwrite n'autorise pas l'écrasement d'un répertoire par un fichier conflictuel ou par paquetage comportant un fichier ou un répertoire conflictuel. Il est possible de donner une liste de noms séparés par des virgules. Il est possible d'exclure des noms en les précédant d'un point d'exclamation. Les derniers noms cités sur la lignes ont priorité sur ceux qui précédent. Un point d'exclamation en tête ou un contre-oblique doit être "protégés" par un caractère d'échappement.

OPTIONS DE REQUÊTE (POUR -Q)

-c, --changelog
    Lire l'historique des mises à jour d'un paquetage s'il y en a un.

-d, --deps
    Restreint ou filtre l’affichage des paquetages installés en dépendances. Cette option peut être utilisée avec -t pour lister les paquetages orphelins installés comme dépendances et qui ne sont plus demandé par aucun paquetages installés.

-e, --explicit
    Restrict or filter output to explicitly installed packages. This option can be combined with -t to list explicitly installed packages that are not required by any other package.

-g, --groups
    Affiche le groupe avec les paquetages qu'il comporte. Faute de nom, tous les groupes seront affichés.

-i, --info
    Affiche les informations sur le paquetage. L'option -p peut être utilisée pour rechercher le fichier d'un paquetage dans la base locale. Passer deux paramètres --info ou -i va afficher la liste des fichiers de sauvegarde et leur état de modification.

-k, --check
    Check that all files owned by the given package(s) are present on the system. If packages are not specified or filter flags are not provided, check all installed packages. Specifying this option twice will perform more detailed file checking (including permissions, file sizes, and modification times) for packages that contain the needed mtree file.

-l, --list
    Liste tous les fichiers inclus dans <paquetage>. Plusieurs paquetages peuvent être donnés sur la ligne de commande.

-m, --foreign
    Restreint ou filtre l'affichage aux paquetages absents de la base de donnée synchronisée, c'est-à-dire généralement les paquetages que vous avez téléchargés manuellement et installés avec --upgrade.

-n, --native
    Restrict or filter output to packages that are found in the sync database(s). This is the inverse filter of --foreign.

-o, --owns <fichier>
    Search for packages that own the specified file(s). The path can be relative or absolute, and one or more files can be specified.

-p, --file
    Précise à pacman que le nom donné dans la commande est un fichier et non un paquetage de la base de donnée. Pacman va décompresser le fichier et l'utiliser. Complément aux options --info et --list.

-q, --quiet
    Affiche moins d'information pour certaines requêtes (utile quand la la sortie de pacman est utilisée dans un script ). L'option --search --quiet affichera uniquement le nom des paquetages sans leur version, leur groupe ou leur description. --owns --quiet affiche seulement le nom à la place du message “Ce fichier appartient à”; --groups --quiet affichera uniquement le nom du paquetage sans le nom du groupe, --list --quiet affichera uniquement les fichiers sans le nom du paquetage. --check --quiet affichera le du nom du paquetage et des fichiers manquants. L'option -Qq seule affiche uniquement les noms des paquetages sans leur version.

-s, --search <regexp>
    Search each locally-installed package for names or descriptions that match regexp. When including multiple search terms, only packages with descriptions matching ALL of those terms are returned.

-t, --unrequired
    Restreint ou filtre l'affichage aux seuls paquetages superflus, même en option, pour les paquetages déjà installés. Si cette option apparaît deux fois sur la ligne de commande, pacman incluera les paquetages requis optionnellement (c'est-à-dire pas systématiquement) par les paquetages installés.

-u, --upgrades
    Restreint ou filtre l’affichage aux paquetages périmés sur le système local. N'utilise que les versions du paquetage pour trouver les paquetages périmés. Ne vérifie pas les remplacements. L'option n'est vraiment efficace qu'en conjonction avec une synchronisation de la base de donnée : -Sy.

OPTIONS DE SUPPRESSION (POUR -R)

-c, --cascade
    Supprime tous les paquetages cibles ainsi que le ou les paquetages dont ils dépendent. Cette opération est récursive et doit être employée avec prudence puisqu'elle est susceptible de supprimer implicitement plusieurs paquetages potentiellement utiles par ailleurs.

-n, --nosave
    Demande à pacman d'ignorer la variable backup. Normalement quand un fichier va être supprimé du système la base de donnée est vérifiée pour voir si le fichier doit être renommé avec l'extension .pacsave.

-s, --recursive
    Pour chaque paquetage demandé, le supprime avec toutes ses dépendances, à condition que ces dépendances (A) ne soient pas nécessaires à un autre paquetage installé et (B) qu'elles n'aient pas été installées explicitement par l'utilisateur. Cette option est l'inverse de l'option --sync. Pour se passer de la condition (B), appeler l'option deux fois sur la même ligne de commande.

-u, --unneeded
    Supprime les cibles qui ne sont plus utilisées par aucun paquetage. Ceci est très utile quand vous supprimez un groupe avec l'option -c pour ne pas casser les dépendances.

OPTIONS DE SYNCHRONISATION (POUR -S)

-c, --clean
    Remove packages that are no longer installed from the cache as well as currently unused sync databases to free up disk space. When pacman downloads packages, it saves them in a cache directory. In addition, databases are saved for every sync DB you download from and are not deleted even if they are removed from the configuration file pacman.conf(5). Use one --clean switch to only remove packages that are no longer installed; use two to remove all files from the cache. In both cases, you will have a yes or no option to remove packages and/or unused downloaded databases.

    Si vous utilisez le cache partagé du réseau, allez voir l'option CleanMethod dans le pacman.conf(5).

-g, --groups
    Affiche tous les membres d'un groupe de paquetages. Si aucun groupe n'est saisi, tous les groupes vont être affichés. Répéter l'option à la commande pour voir tous les groupes avec leurs membres.

-i, --info
    Display information on a given sync database package. Passing two --info or -i flags will also display those packages in all repositories that depend on this package.

-l, --list
    Liste tous les fichiers du serveur indiqué. Plusieurs serveurs peuvent être indiqués dans la commande.

-q, --quiet
    Show less information for certain sync operations. This is useful when pacman’s output is processed in a script. Search will only show package names and not repository, version, group, and description information; list will only show package names and omit databases and versions; group will only show package names and omit group names.

-s, --search <regexp>
    Recherche dans chaque paquetage installé localement le nom ou la description correspondant à l'expression régulière “regexp”. Si vous indiquez plusieurs sélecteurs, seuls les paquetages dont la description active TOUS les sélecteurs seront affichés.

-u, --sysupgrade
    Met à jour tous les paquetages périmés. Chaque paquetage installé sur votre système va être examiné et mis à jour si un paquetage plus récent existe. Une liste de tous les paquetages à mettre à jour sera affichée et demandera une confirmation à l'utilisateur avant de lancer la mise à jour. Les dépendances sont automatiquement résolues et sont installés ou mises à jour si besoin.

    Soumettre cette option deux fois pour activer la rétrogration de paquetage. Dans ce cas pacman va sélectionner les paquetages synchronisés dont la version ne correspond pas avec la version locale. Cela peut être utile pour les utilisateurs qui passent du dépôt testing au dépôt stable.

    Il est possible de spécfier manuellement d'autres cibles : ainsi -Su foo déclenchera une mise à jour du système pour installer ou mettre à jour le paquetage "foo".

-y, --refresh
    Download a fresh copy of the master package database from the server(s) defined in pacman.conf(5). This should typically be used each time you use --sysupgrade or -u. Passing two --refresh or -y flags will force a refresh of all package databases, even if they appear to be up-to-date.

OPTIONS DE BASE DE DONNÉES (POUR -D)

--asdeps <paquetage>
    Marque un paquetage comme non installé a priori pour forcer sa (ré-)installation comme dépendance.

--asexplicit <paquetage>
    Mark a package as explicitly installed; in other words, set their install reason to be explicitly installed. This is useful if you want to keep a package installed even when it was initially installed as a dependency of another package.

-k, --check
    S'assure que la base de données des paquetages est cohérente. Vérifie pour cela que tous les fichiers requis sont présents et que les paquetages installés possèdent les dépendances requises, ne sont pas en conflit mutuel et que plusieurs paquetages ne comportent pas le même fichier. Pour vérifier sur les bases de données synchronisées que toutes les dépendances sont résolues, appeler cette option deux fois sur la liggne de commande.

-q, --quiet
    Supprime les messages en cas de succès des opérations sur la base de données.

OPTIONS DE FICHIER (POUR -F)

-y, --refresh
    Télécharge une base de données neuve depuis les dépôts. Pour forcer le rafraîchissement même si la base de données à est à jour, appeler l'option deux fois sur la lignes de commande.

-l, --list
    Liste des fichiers du paquetage indiqué.

-x, --regex
    Interprète chaque requête comme une expression regulière.

-q, --quiet
    Affiche moins de détails our certaines opérations sur fichier. Utile si la sortie standard de pacman est utilisée dans un script ; mais vous pourriez préférer l'option --machinereadable à la place.

--machinereadable
    Affiche pour chaque fichier une ligne au format machine. Ce format est dépôt\0pkgname\0pkgver\0chemin\n, où \0 est le caractère NULL et \n un caractère fin-de-ligne..

TRAITEMENT DES FICHIERS DE CONFIGURATION

Pacman utilise la même logique que rpm pour déterminer l'action sur les fichiers qui doivent être sauvegardés. Pendant une mise à jour, il utilise 3 hashs MD5 pour chaque fichier de sauvegarde pour déterminer l'action adéquate : une pour le fichier originel installé, une pour le nouveau fichier qui doit être installé, et une pour le fichier présent sur le système. Après avoir comparé ces 3 hashs, voici ce qui peut se passer :

original=X, current=X, nouveau=X
    Tous les fichiers sont identiques, donc on gagne un tour. Installation du nouveau fichier.

original=X, current=X, nouveau=Y
    Le fichier actuel est strictement identique à l'original mais le nouveau est différent. Si l'utilisateur n'a jamais modifié le fichier et que le nouveau contient de nouvelles fonctionnalités / correction de bugs, nous installons le nouveau.

original=X, current=Y, nouveau=X
    Toutes les versions contiennent exactement le même fichier, mais celui présent sur le système a été modifié. Dans ce cas, nous laissons le fichier current en place.

original=X, current=Y, nouveau=Y
    Le fichier nouveau est identique au current. Installation du nouveau fichier.

original=X, current=Y, nouveau=Z
    Les trois fichiers sont différents, donc nous installons le fichier nouveau avec l'extension .pacnew et informons l'utilisateur, qu'il peut remplacer le fichier original après l'avoir modifié.

original=NULL, current=Y, nouveau=Z
    The package was not previously installed, and the file already exists on the file system. Install the new file with a .pacnew extension and warn the user. The user must then manually merge any necessary changes into the original file.

EXEMPLES

pacman -Ss ne.hack
    Recherche l'expression régulière "ne.hack" dans la base de données.

pacman -S gpm
    Télécharge et installe gpm et toutes ses dépendances.

pacman -U /home/user/ceofhack-0.6-1-x86_64.pkg.tar.gz
    Installe le paquetage ceofhack-0.6-1 depuis un fichier .tar.gz local.

pacman -Syu
    Met à jour la liste des paquetages, et met à niveau tous les paquetages ensuite.

pacman -Syu gpm
    Met à jour la liste des paquetages, les met tous à niveau puis installe gpm s'il n'était pas déjà présent.

CONFIGURATION

Voir pacman.conf(5) pour de plus amples informations pour configurer pacman en utilisant le fichier pacman.conf.

VOIR AUSSI

alpm-hooks(5), libalpm(3), makepkg(8), pacman.conf(5)

Consulter le site internet de pacman à l'adresse https://.archlinux.org/pacman/ pour de nouvelles informations sur pacman et ses outils associés.

BOGUES

Bogues ? C'est une blague ; il n'y a pas de bogues dans ce logiciel. Mais s'il y en a, envoyez un rapport de bogue contenant autant de détails que possible dans la section Pacman du système de suivi de bogues de Arch Linux.

AUTEURS

Développeurs actuels :

    • Allan McRae <allan@archlinux.org>

    • Andrew Gregory <andrew.gregory.8@gmail.com>

    • Eli Schwartz <eschwartz@archlinux.org>

    • Morgan Adamiec <morganamilo@archlinux.org>

Contributeurs antérieurs majeurs :

    • Judd Vinet <jvinet@zeroflux.org>

    • Aurelien Foret <aurelien@archlinux.org>

    • Aaron Griffin <aaron@archlinux.org>

    • Dan McGee <dan@archlinux.org>

    • Xavier Chantry <shiningxc@gmail.com>

    • Nagy Gabor <ngaba@bibl.u-szeged.hu>

    • Dave Reisner <dreisner@archlinux.org>

Pour des contributeurs supplémentaires, utiliser git shortlog -s sur le dépôt pacman.git.

TRADUCTION
La traduction française de cette page de manuel a été créée par Marc Poiroud <marci1@archlinux.fr> et Jean-Jacques Brioist <jean.brioist@numericable.fr> Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 (https://www.gnu.org/licenses/gpl-3.0.html) concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.