PACMAN.CONF(5) Manuel de Pacman PACMAN.CONF(5) NOM pacman.conf - fichier de configuration pour le gestionnaire de paquetage pacman SYNOPSIS /etc/pacman.conf DESCRIPTION Pacman utilise la libalpm, pour lire pacman.conf a chaque fois qu'il est invoque. Ce fichier de configuration est divise en sections ou repertoires. Chaque section definit un depot de paquetage que pacman utilise quand il cherche un paquetage avec --sync. Les exceptions sont decrites dans la section options, qui definit les options globales. Les lignes commencant par un caractere diese (#) sont traitees comme commentaires. Les champs commentaires doivent commencer au premier caractere d'une ligne. EXEMPLE # # pacman.conf # [options] NoUpgrade = etc/passwd etc/group etc/shadow NoUpgrade = etc/fstab [core] Include = /etc/pacman.d/core [custom] Server = file:///home/pkgs Note Chaque directive doit etre codee en CamelCase. Si la casse n'est pas respectee, la directive pourrait ne pas etre reconnue. Par exemple : ni noupgrade, ni NOUPGRADE ne correspondent a une directive connue. OPTIONS RootDir = /chemin/vers/rep-root Set the default root directory for pacman to install to. This option is used if you want to install a package on a temporary mounted partition which is "owned" by another system, or for a chroot install. 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. DBPath = /chemin/vers/rep-db Overrides the default location of the toplevel database directory. The default is /var/lib/pacman/. Most users will not need to set this option. NOTE: if specified, this is an absolute path and the root path is not automatically prepended. CacheDir = /chemin/vers/rep-cache Overrides the default location of the package cache directory. The default is /var/cache/pacman/pkg/. Multiple cache directories can be specified, and they are tried in the order they are listed in the config file. If a file is not found in any cache directory, it will be downloaded to the first cache directory with write access. NOTE: this is an absolute path, the root path is not automatically prepended. HookDir = /chemin/vers/rep-hook Ajoute des repertoires de recherche supplementaires au repertoire de recherche du systeme (/usr/share/libalpm/hooks/) pour l'amorcage d'alpm. On peut ainsi multiplier les repertoires, mais ceux cites en dernier auront precedence sur les premiers. NOTE : il faut donner ici un chemin absolu, et le chemin racine n'est pas a priori preponderant. GPGDir = /chemin/vers/rep-gpg Modifie l'emplacement par defaut des fichiers de configuration pour GnuPG.L'emplacement par defaut est /etc/pacman.d/gnupg/. Ce repertoire contenir deux fichiers : pubring.gpg et trustdb.gpg. pubring.gpg contient la clef publique de tous les paquetages ; trustdb.gpg, la base de donnees dite d'authentification, qui sert a confirmer que les clefs du trousseau sont sinceres. NOTE : il faut donner ici un chemin absolu, et le chemin racine n'est pas a priori preponderant. LogFile = /path/to/log/file Overrides the default location of the pacman log file. The default is /var/log/pacman.log. This is an absolute path and the root directory is not prepended. HoldPkg = paquetage If a user tries to --remove a package that's listed in HoldPkg, pacman will ask for confirmation before proceeding. Shell-style glob patterns are allowed. IgnorePkg = paquetage Instructs pacman to ignore any upgrades for this package when performing a --sysupgrade. Shell-style glob patterns are allowed. IgnoreGroup = groupe Instructs pacman to ignore any upgrades for all packages in this group when performing a --sysupgrade. Shell-style glob patterns are allowed. Include = /path/to/config/file Include another configuration file. This file can include repositories or general configuration options. Wildcards in the specified paths will get expanded based on glob(7) rules. Architecture = auto &| i686 &| x86_64 | ... If set, pacman will only allow installation of packages with the given architectures (e.g. i686, x86_64, etc). The special value auto will use the system architecture, provided via "uname -m". If unset, no architecture checks are made. NOTE: Packages with the special architecture any can always be installed, as they are meant to be architecture independent. XferCommand = /chemin/vers/commande %u Si actif, pacman va utiliser un programme externe pour le telechargement. Toutes les instances de %u seront remplacees par l'URL de telechargement. Si elle est presente, l'instance %o sera remplacee par le nom du fichier local, avec l'extension ".part", afin de permettre a des programmes comme wget de reprendre a leur compte ces fichiers. Cette option est utile pour les utilisateurs ayant des problemes avec l'aide native de pacman sur les protocoles HTTP/FTP, ou qui ont besoin d'informations plus detaillees sur les proxys, fournies par des outils comme wget. NoUpgrade = fichier ... All files listed with a NoUpgrade directive will never be touched during a package install/upgrade, and the new files will be installed with a .pacnew extension. These files refer to files in the package archive, so do not include the leading slash (the RootDir) when specifying them. Shell-style glob patterns are allowed. It is possible to invert matches by prepending a file with an exclamation mark. Inverted files will result in previously blacklisted files being whitelisted again. Subsequent matches will override previous ones. A leading literal exclamation mark or backslash needs to be escaped. NoExtract = fichier All files listed with a NoExtract directive will never be extracted from a package into the filesystem. This can be useful when you don't want part of a package to be installed. For example, if your httpd root uses an index.php, then you would not want the index.html file to be extracted from the apache package. These files refer to files in the package archive, so do not include the leading slash (the RootDir) when specifying them. Shell-style glob patterns are allowed. It is possible to invert matches by prepending a file with an exclamation mark. Inverted files will result in previously blacklisted files being whitelisted again. Subsequent matches will override previous ones. A leading literal exclamation mark or backslash needs to be escaped. CleanMethod = KeepInstalled &| KeepCurrent If set to KeepInstalled (the default), the -Sc operation will clean packages that are no longer installed (not present in the local database). If set to KeepCurrent, -Sc will clean outdated packages (not present in any sync database). The second behavior is useful when the package cache is shared among multiple machines, where the local databases are usually different, but the sync databases in use could be the same. If both values are specified, packages are only cleaned if not installed locally and not present in any known sync database. SigLevel = ... Fixe le niveau par defaut d'authentification de certificat. Pour plus d'informations, voir ci-apres le AUTHENTIFICATION DE BASE DE DONNEES ET DE PAQUETAGE. LocalFileSigLevel = ... Fixe le niveau par defaut d'authentification de certificat pour autoriser l'installation des paquetages avec l'action "-U" sur un fichier local ; utilise par defaut le niveau donne par SigLevel. RemoteFileSigLevel = ... Fixe le niveau par defaut d'authentification de certificat pour autoriser l'installation des paquetages avec l'action "-U" sur un fichier dont on donne l'adresse URL ; utilise par defaut le niveau donne par SigLevel. UseSyslog Archive les messages systeme avec syslog(). Cela va ajouter les messages de pacman dans votre /var/log/messages ou equivalent. Color Active automatiquement les couleurs quand la sortie standard de pacman's est envoyee sur un terminal. NoProgressBar Disables progress bars. This is useful for terminals which do not support escape characters. CheckSpace Effectue un controle approximatif de l'espace-disque disponible avant d'installer les paquetages. VerbosePkgLists Affiche le nom, la version et la taille des paquetages-cible sous forme de tableau pour les operations de mise a niveau, de synchronisation et de suppression. DisableDownloadTimeout Desactive les limites par defaut sur la vitesse de transfert et les delais de connexion. A activer si vous avez des problemes de proxy ou avec de ports securises. ParallelDownloads = ... Specifies number of concurrent download streams. The value needs to be a positive integer. If this config option is not set then only one download stream is used (i.e. downloads happen sequentially). SECTIONS DEPOT Each repository section defines a section name and at least one location where the packages can be found. The section name is defined by the string within square brackets (the two above are core and custom). Repository names must be unique and the name local is reserved for the database of installed packages. Locations are defined with the Server directive and follow a URL naming structure. If you want to use a local directory, you can specify the full path with a "file://" prefix, as shown above. Une facon ordinaire de definir l'emplacement d'une base de donnee est d'utiliser la directive Include. Pour chaque depot defini dans un fichier de configuration, une simple directive Include peut contenir un fichier qui liste les serveurs pour ce depot. [core] # use this server first Server = ftp://ftp.archlinux.org/$repo/os/$arch # next use servers as defined in the mirrorlist below Include = {sysconfdir}/pacman.d/mirrorlist L'ordre des depots dans le fichier de configuration est important : chaque fois qu'un paquetage est present sous le meme nom dans deux depots differents, quels que soient les numeros de version indiques, les premiers depots de la liste seront utilises avant ceux qui suivent. Include = chemin Include another config file. This file can include repositories or general configuration options. Wildcards in the specified paths will get expanded based on glob(7) rules. Server = url Une adresse URL de depot complete ou l'on peut trouver la base de donnees d'Arch Linux, le paquetage et le cas echeant les certificats d'authentification. During parsing, pacman will define the $repo variable to the name of the current section. This is often utilized in files specified using the Include directive so all repositories can use the same mirrorfile. pacman also defines the $arch variable to the first (or only) value of the Architecture option, so the same mirrorfile can even be used for different architectures. SigLevel = ... Fixe le niveau par d'authentification de certificat pour ce depot. Pour plus d'informations, voir ci-apres le AUTHENTIFICATION DE BASE DE DONNEES ET DE PAQUETAGE. Usage = ... Fixe les autorisations pour ce depot. Cette option accepte un certain nombre d'options, et il faut en choisir au moins une parmi les suivantes : Sync Autorise ce depot a mettre a jour. Search Autorise ce depot a chercher des donnees. Install Autorise l'installation de paquetages depuis ce depot pendant une action --sync. Upgrade Allows this repository to be a valid source of packages when performing a --sysupgrade. All Donne toutes les autorisations ci-dessus a ce depot : c'est l'option par defaut. Observez qu'on peut effectuer une installation explicite depuis un depot quel que soit le niveau d'usage qui lui a ete concede. Note that an enabled repository can be operated on explicitly, regardless of the Usage level set. AUTHENTIFICATION DE BASE DE DONNEES ET DE PAQUETAGE La directive SigLevel agit aussi bien dans les options que dans les sections des depots. Employee en [option] de commande, elle affecte une valeur par defaut aux depots qui ne decrivent pas leur configuration. o Si la valeur est Never, il n'y aura pas dexamen de certificat. o Si la valeur est Optional, les certificats presents seront authentifies, mais les bases et paquetages non certifies seront acceptes aussi bien. o Si la valeur est Required, les clefs seront systematiquement examinees. Vous pouvez beneficier d'un controle plus sur en combinant certains prefixes et options decrits ci-apres. Toutes les options d'un fichier de config sont traitees du debut a la fin et de gauche a droite, les dernieres options ecrasant ou modifiant celles qui precedent. Si un SigLevel est fixe pour une section d'un depot, sa valeur initiale est celle de la section [options] ou, a defaut, celle du systeme en place comme on le montre ci-dessous. Les options se repartissent en deux categories, decrites ci-dessous. La terminologie, par ex. "marginally trusted" , est celle de GnuPG. Consulter gpg(1) pour en savoir plus. Discipline d'authentification Les options suivantes fixent quand pacman doit authentifier les clefs. Never Supprime toute verification, meme s'il y a des clefs a examiner. Optional (defaut) Verifie les clefs s'il y en a, mais l'absence de clef n'interrompt pas le processus. Toutefois une clef invalide constitue une erreur fatale. Required Clefs indispensables ; l'absence d'une clef, ou une clef invalide entraine une erreur fatale, tout comme une clef manquant au trousseau. Gestion des permissions Ces options controlent quelles clefs sont considerees comme acceptables. Observez qu'aucune de ces options n'autorise les clefs invalides ou perimees, ni les clefs deja revoquees. TrustedOnly (defaut) La clef examinee doit etre presente dans le trousseau et authentifiee parfaitement ; une authentification partielle est insuffisante. TrustAll La clef examinee doit etre presente dans le trousseau ; il n'est pas necessaire qu'elle satisfasse un quelconque niveau d'authentification. En outre, les options de ces deux groupes peuvent etre precedees de Package ou de Database, ce qui limitera la regle a chacune de ces categories d'objet : paquetages, ou base. Par exemple, PackageTrustAll autoriserait des clefs incompletement authentifiees pour les paquetages. La discipline d'authentification par defaut est la suivante : SigLevel = Optional TrustedOnly AVEC VOTRE PROPRE DEPOT Si vous avez de nombreux paquetages personnalises, il est assez facile de generer votre depot local personnalise qui installe tout avec l'option --upgrade. Tout ce que vous avez a faire est de creer une archive compressee de la base de donnees dans le repertoire ou sont les paquetages pour que pacman puisse le retrouver lors de l'execution de --refresh. repo-add /home/pkgs/custom.db.tar.gz /home/pkgs/*.pkg.tar.gz The above command will generate a compressed database named /home/pkgs/custom.db.tar.gz. Note that the database must be of the form defined in the configuration file and {ext} is a valid compression type as documented in repo-add(8). That's it! Now configure your custom section in the configuration file as shown in the config example above. Pacman will now use your package repository. If you add new packages to the repository, remember to re-generate the database and use pacman's --refresh option. Pour plus d'information sur la commande repo-add, utilisez "repo-add --help" ou repo-add(8). VOIR AUSSI pacman(8), libalpm(3) Consulter le site internet de pacman a l'adresse https://.archlinux.org/pacman/ pour de nouvelles informations sur pacman et ses outils associes. 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 details que possible dans la section Pacman du systeme de suivi de bogues de Arch Linux. AUTEURS Developpeurs actuels : o Allan McRae o Andrew Gregory o Eli Schwartz o Morgan Adamiec Contributeurs anterieurs majeurs : o Judd Vinet o Aurelien Foret o Aaron Griffin o Dan McGee o Xavier Chantry o Nagy Gabor o Dave Reisner Pour des contributeurs supplementaires, utiliser git shortlog -s sur le depot pacman.git. TRADUCTION La traduction francaise de cette page de manuel a ete creee par Marc Poiroud et Jean-Jacques Brioist Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pacman 6.0.2 6 fevrier 2024 PACMAN.CONF(5)