pacman.conf - fichier de configuration pour le gestionnaire de
paquetage pacman
Pacman utilise la libalpm, pour lire pacman.conf à
chaque fois qu'il est invoqué. Ce fichier de configuration est
divisé en sections ou répertoires. Chaque section
définit un dépôt de paquetage que pacman utilise quand
il cherche un paquetage avec --sync. Les exceptions sont
décrites dans la section options, qui définit les options
globales.
Les lignes commençant par un caractère dièse
(#) sont traitées comme commentaires. Les champs commentaires doivent
commencer au premier caractère d'une ligne.
#
# 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 être codée en CamelCase. Si la
casse n'est pas respectée, la directive pourrait ne pas être
reconnue. Par exemple : ni noupgrade, ni NOUPGRADE ne correspondent à
une directive connue.
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 répertoires de recherche
supplémentaires au répertoire de recherche du système
(/usr/share/libalpm/hooks/) pour l'amorçage d'alpm. On peut ainsi
multiplier les répertoires, mais ceux cités en dernier auront
précédence sur les premiers. NOTE : il faut donner ici un
chemin absolu, et le chemin racine n'est pas a priori
prépondérant.
GPGDir = /chemin/vers/rep-gpg
Modifie l'emplacement par défaut des fichiers de
configuration pour GnuPG.L'emplacement par défaut est
/etc/pacman.d/gnupg/. Ce répertoire 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, et le chemin racine n'est
pas a priori prépondérant.
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 = /path/to/command %u [%o]
Si actif, pacman va utiliser un programme externe pour le
téléchargement. Toutes les instances de %u seront
remplacées par l'URL de téléchargement. Si elle est
présente, l'instance %o sera remplacée par le nom du fichier
local, avec l'extension “.part”, afin de permettre à des
programmes comme wget de reprendre à leur compte ces fichiers.
Cette option est utile pour les utilisateurs ayant des
problèmes avec l'aide native de pacman sur les protocoles HTTP/FTP,
ou qui ont besoin d'informations plus détaillées 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 défaut d'authentification de
certificat. Pour plus d'informations, voir ci-après le AUTHENTIFICATION
DE BASE DE DONNÉES ET DE PAQUETAGE.
LocalFileSigLevel = ...
Fixe le niveau par défaut d'authentification de
certificat pour autoriser l'installation des paquetages avec l'action
"-U" sur un fichier local ; utilise par défaut le niveau
donné par SigLevel.
RemoteFileSigLevel = ...
Fixe le niveau par défaut 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
défaut le niveau donné par SigLevel.
UseSyslog
Archive les messages système avec syslog(). Cela
va ajouter les messages de pacman dans votre /var/log/messages ou
équivalent.
Color
Active automatiquement les couleurs quand la sortie
standard de pacman’s est envoyée sur un terminal.
NoProgressBar
Disables progress bars. This is useful for terminals
which do not support escape characters.
CheckSpace
Effectue un contrôle 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 opérations de mise
à niveau, de synchronisation et de suppression.
DisableDownloadTimeout
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.
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).
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 façon ordinaire de définir l'emplacement d'une
base de donnée est d'utiliser la directive Include. Pour
chaque dépôt défini dans un fichier de configuration,
une simple directive Include peut contenir un fichier qui liste les
serveurs pour ce dépôt.
[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 dépôts dans le fichier de configuration
est important : chaque fois qu'un paquetage est présent sous le
même nom dans deux dépôts différents, quels que
soient les numéros de version indiqués, les premiers
dépôts de la liste seront utilisés 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.
CacheServer = url
A full URL to a location where the packages, and
signatures (if available) for this repository can be found. Cache servers will
be tried before any non-cache servers, will not be removed from the server
pool for 404 download errors, and will not be used for database files.
Server = url
Une adresse URL de dépôt complète
où l'on peut trouver la base de données d'Arch Linux, le
paquetage et le cas échéant 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 dépôt. Pour plus d'informations, voir ci-après le
AUTHENTIFICATION DE BASE DE DONNÉES ET DE PAQUETAGE.
Usage = ...
Fixe les autorisations pour ce dépôt. Cette
option accepte un certain nombre d'options, et il faut en choisir au moins une
parmi les suivantes :
Sync
Autorise ce dépôt à mettre à
jour.
Search
Autorise ce dépôt à chercher des
données.
Install
Autorise l'installation de paquetages depuis ce
dépôt 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 à ce
dépôt : c'est l'option par défaut. Observez qu'on peut
effectuer une installation explicite depuis un dépôt quel que
soit le niveau d'usage qui lui a été concédé.
Note that an enabled repository can be operated on explicitly,
regardless of the Usage level set.
La directive SigLevel agit aussi bien dans les options que
dans les sections des dépôts. Employée en [option] de
commande, elle affecte une valeur par défaut aux dépôts
qui ne décrivent pas leur configuration.
•Si la valeur est Never, il n'y aura pas
dexamen de certificat.
•Si la valeur est Optional, les certificats
présents seront authentifiés, mais les bases et paquetages non
certifiés seront acceptés aussi bien.
•Si la valeur est Required, les clefs
seront systématiquement examinées.
Vous pouvez bénéficier d'un contrôle plus
sûr en combinant certains préfixes et options décrits
ci-après. Toutes les options d'un fichier de config sont
traitées du début à la fin et de gauche à
droite, les dernières options écrasant ou modifiant celles qui
précèdent. Si un SigLevel est fixé pour une
section d'un dépôt, sa valeur initiale est celle de la section
[options] ou, à défaut, celle du système en place comme
on le montre ci-dessous.
Les options se répartissent en deux catégories,
décrites 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 vérification, même s'il y a
des clefs à 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 entraîne une erreur fatale, tout comme une clef manquant au
trousseau.
Gestion des permissions
Ces options contrôlent quelles clefs sont
considérées comme acceptables. Observez qu'aucune de ces options
n'autorise les clefs invalides ou périmées, ni les clefs
déjà révoquées.
TrustedOnly (defaut)
La clef examinée doit être présente
dans le trousseau et authentifiée parfaitement ; une authentification
partielle est insuffisante.
TrustAll
La clef examinée doit être présente
dans le trousseau ; il n'est pas nécessaire qu'elle satisfasse un
quelconque niveau d'authentification.
En outre, les options de ces deux groupes peuvent être
précédées de Package ou de Database, ce
qui limitera la règle a chacune de ces catégories d'objet :
paquetages, ou base. Par exemple, PackageTrustAll autoriserait des clefs
incomplètement authentifiées pour les paquetages.
La discipline d'authentification par défaut est la suivante
:
SigLevel = Optional TrustedOnly
Si vous avez de nombreux paquetages personnalisés, il est
assez facile de générer votre dépôt local
personnalisé qui installe tout avec l'option --upgrade. Tout
ce que vous avez à faire est de créer une archive
compressée de la base de données dans le répertoire
où sont les paquetages pour que pacman puisse le retrouver lors de
l'exécution 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).
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.
Développeurs actuels :
•Allan McRae <allan@archlinux.org>
•Andrew Gregory
<andrew.gregory.8@gmail.com>
•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>
•Eli Schwartz
<eschwartz@archlinux.org>
Pour des contributeurs supplémentaires, utiliser git
shortlog -s sur le dépôt pacman.git.
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 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.