YUM.CONF
Section : Manuel de l'administrateur Linux (
5)
Mise à jour de la version anglaise : 5 août 2005
Index
Menu principal
NOM
yum.conf - Fichier de configuration pour yum
DESCRIPTION
yum
utilise le fichier de configuration
/etc/yum/yum.conf.
Des fichiers de configuration supplémentaires sont également lus à partir des
répertoires configurés par l'option
reposdir
(la valeur par défaut est
/etc/yum/repos.d).
Voir l'option
reposdir
pour plus de détails.
PARAMÈTRES
Il y a deux types de section dans les fichiers de configuration : [main]
et [repository]. [main] définit toutes les options globales de configuration.
Il n'y a qu'une seule section [main] dans un fichier de configuration.
La section [repository] définit la configuration pour chaque dépôt/serveur.
Il peut y avoir une ou plusieurs sections [repository].
OPTIONS DE [main]
La section [main] doit exister pour que
yum
puisse faire quoique ce soit. Elle consiste en les options suivantes :
- cachedir
-
Répertoire dans lequel
yum
enregistre ses fichiers cache et base de données. La valeur par défaut est
/var/cache/yum.
- persistdir
-
Répertoire où
yum
stockera les informations qui persistent lors d'exécutions multiples.
La valeur par défaut est
/var/lib/yum.
- keepcache
-
Valeur : 1 ou 0. Déterminer si
yum
conserve ou non les caches des en-têtes et des paquetages après une
installation réussie. La valeur par défaut est 1 (conserver les caches).
- reposdir
-
Une liste de répertoires dans lesquels
yum
cherche les fichiers .repo qui définissent les dépôts à utiliser.
La valeur par défaut est
/etc/yum/repos.d.
Chaque fichier dans le répertoire doit contenir une ou plusieurs sections
[repository] comme documenté dans la section
OPTIONS DE [repository].
Ils seront fusionnés avec les dépôts définis dans
/etc/yum/yum.conf
pour former un ensemble complet de dépôts que
yum
utilisera.
- debuglevel
-
Niveau de messages de débogage. L'intervalle est de 0 à 10.
La valeur par défaut est 2.
- errorlevel
-
Niveau de messages d'erreur. L'intervalle est de 0 à 10.
La valeur par défaut est 2.
- logfile
-
Chemin absolu du fichier où
yum
écrira son fichier de journalisation.
- gpgcheck
-
Valeur : 1 ou 0.
Effectuer ou non la vérification de la signature GPG sur les paquetages.
Lorsque cette option est configurée dans la section [main], cela configure
la valeur par défaut pour tous les dépôts du fichier.
Cette option s'adresse également aux paquetages locaux.
La valeur par défaut est 0 (pas de vérification).
- assumeyes
-
Valeur : 0 ou 1.
Déterminer si
yum
doit demander ou non confirmation à l'utilisateur pour les actions critiques.
La valeur par défaut est 0 (demander confirmation).
Option de la ligne de commande :
-y
(pas de confirmation).
- alwaysprompt
-
Valeur : 1 ou 0.
Sans cette option,
yum
ne demandera pas confirmation lorsque la liste des paquetages à installer
correspondra exactement à celle fournie sur la ligne de commande.
À moins que
assumeyes
ne soit activée, il demandera toujours confirmation pour la suppression de
paquetages, ou lorsque des paquetages supplémentaires doivent être installés
pour satisfaire les dépendances.
La valeur par défaut est 1 (demander confirmation).
- tolerant
-
Valeur : 1 ou 0.
Si elle est activée,
yum
sera tolérant pour les erreurs de la ligne de commande concernant les
paquetages. Par exemple, si vous demandez l'installation de « foo »,
« bar » et « baz » et que « baz » est déjà installé,
yum
ne produira pas d'erreur parce que « baz » est déjà installé.
La valeur par défaut est 0 (pas tolérant).
Option de la ligne de commande :
-t
(être tolérant).
- exclude
-
Liste des paquetages à exclure de la mise à jour ou de l'installation.
Cela peut être une liste séparée par des espaces.
Les expressions génériques du shell (avec des jokers comme * et ?)
sont autorisées.
- exactarch
-
Valeur : 1 ou 0.
Si elle est activée (1),
yum
ne mettra à jour que les architectures des paquetages que vous avez installés.
C'est-à-dire que
yum
n'installera pas un paquetage i686 pour mettre à jour un paquetage i386.
La valeur par défaut est 1.
- installonlypkgs
-
Liste des paquetages qui devraient seulement être installés, jamais mis à jour.
Les noyaux, en particulier, entrent dans cette catégorie.
La valeur par défaut est : « kernel, kernel-smp, kernel-bigmem,
kernel-enterprise, kernel-debug, kernel-unsupported ».
- installonly_limit
-
Nombre de paquetages listés dans « installonlypkgs » à conserver
installés en même temps. Mettre 0 désactive cette fonctionnalité.
La valeur par défaut est 0.
- kernelpkgnames
-
Liste des noms de paquetages qui sont des noyaux. Ce n'est là que pour la
mise à jour des noyaux et devrait être retiré à partir de yum-2.1
(Ndt : ne doit donc plus être présente).
- showdupesfromrepos
-
Valeur : 1 ou 0.
Mettre 1 si vous voulez voir tous les paquetages en double à partir de
n'importe quel dépôt. Mettre 0 si vous voulez seulement voir les paquetages
les plus récents à partir de n'importe quel dépôt.
La valeur par défaut est 0.
- obsoletes
-
Cette option n'a d'effet que lors d'une mise à jour
(update).
Elle active la logique de traitement des obsolescences de yum.
Pratique lors d'un changement de numéro de version de la distribution.
Voir également la documentation de la commande
upgrade
de
yum(8)
pour plus de détails.
Option de la ligne de commande :
--obsoletes
- overwrite_groups
-
Valeur : 0 ou 1. Utilisée pour déterminer le comportement de
yum
si deux dépôts ou plus offrent des groupes de paquetages de même nom. Si
overwrite_groups
vaut 1, les paquetages du groupe de la dernière correspondance de dépôt
seront utilisés. Si
overwrite_groups
vaut 0, les groupes de tous les dépôts correspondants seront fusionnés dans
un grand groupe.
- enable_group_conditionals
-
Valeur : 0 ou 1. Déterminer si
yum
permet l'utilisation de paquetages conditionnels. La valeur par défaut est 1
(les paquetages conditionnels sont autorisés).
- installroot
-
Spécifier un répertoire racine d'installation alternatif, relativement
auquel tous les paquetages seront installés.
Option de la ligne de commande :
--installroot
- group_package_types
-
Peut prendre une combinaison des valeurs suivantes : optional, default,
mandatory.
Indique à yum quels types de paquetages dans les groupes seront installés
lorsque « groupinstall » est appelé.
La valeur par défaut est : default, mandatory.
- distroverpkg
-
Le paquetage utilisé par
yum
pour déterminer la « version » de la distribution.
Cela peut être un paquetage installé.
La valeur par défaut est « redhat-release ».
- diskspacecheck
-
Valeur : 0 ou 1. Mettre à 0 pour désactiver la vérification de disponibilité
d'espace avant d'effectuer une opération sur un RPM.
La valeur par défaut est 1 (effectuer la vérification).
- tsflags
-
Liste d'attributs d'opération, séparés par des espaces ou des virgules,
à passer à l'ensemble des opérations RPM. Cela inclut « noscripts »,
« notriggers », « nodocs », « test » et « repackage ».
Vous pouvez les positionner tous ou aucun d'eux. Toutefois, si vous ignorez le
contexte d'un ensemble d'opérations RPM, il vaut mieux que vous le laissiez
seul. La valeur par défaut est une liste vide.
- recent
-
Nombre de jours pendant lequels on considère qu'un paquetage ajouté à un dépôt
est récent. Cela est utilisé par la commande
list recent.
La valeur par défaut est 7.
- retries
-
Définir le nombre de fois qu'une tentative pour récupérer un fichier sera
relancée avant de renvoyer une erreur. Définir cette option à 0 fera que
yum
réessayera tout le temps.
La valeur par défaut est 6.
- keepalive
-
Valeur : 0 ou 1.
Déterminer si le « keepalive HTTP » doit être utilisé pour les serveurs
HTTP/1.1 qui le supportent. Cela peut améliorer les vitesses de transfert
quand on utilise une connexion et que l'on télécharge plusieurs fichiers
d'un dépôt. La valeur par défaut est 1.
- timeout
-
Délai d'attente, en secondes, avant de considérer qu'une connexion a échoué.
La valeur par défaut est 30 secondes. Cela peut être un délai trop court pour
les sites surchargés.
- http_caching
-
Déterminer la manière dont les caches HTTP distants doivent gérer les
téléchargements HTTP effectués par
yum.
Cette option peut prendre les valeurs suivantes :
« all » signifie que tous les téléchargements seront mis en cache.
« packages » signifie que seuls les téléchargements des paquetages RPM
seront cachés, pas les téléchargements des méta-données des dépôts.
« none » signifie qu'aucun téléchargement HTTP ne sera caché.
La valeur par défaut est « all ». Cela est recommandé à moins que vous ne
rencontriez des problèmes avec les caches. Essayez au moins d'utiliser
« packages » pour minimiser la charge sur les serveurs des dépôts.
- throttle
-
Activer l'étranglement de la bande passante pour les téléchargements.
Cette option peut s'exprimer sous la forme d'un débit de données absolu
en octets/sec. On peut ajouter un préfixe SI à la valeur de la bande passante
(par exemple, 5.5k signifie 5,5 kilooctets/sec, 2M signifie 2 Mégaoctets/sec).
Alternativement, cette option peut être exprimée en pourcentage de la bande
passante totale (par exemple, 60%). Dans ce cas, l'option
bandwidth
devra être utilisée pour spécifier la bande passante maximum disponible.
Mettre à 0 pour déactiver l'étranglement de la bande passante.
C'est la valeur par défaut.
- bandwidth
-
Spécifier la bande passante maximum disponible sur le réseau, en octet/sec.
Utilisée avec l'option
throttle
plus haut. Si
throttle
est un pourcentage et
bandwidth
vaut 0, l'étranglement de bande passante est désactivé. Si
throttle
est un débit exprimé en octet/sec, cette option est ignorée.
La valeur par défaut est 0 (pas d'étranglement de bande).
- commands
-
Liste des commandes à lancer si aucune commande n'est spécifiée sur la ligne
de commande (par exemple, « update foo bar baz quux ». Aucune des options
courtes (par exemple,
-y,
-e,
-d)
n'est acceptée dans cette option.
- proxy
-
URL du serveur proxy qu'utilisera
yum
.
- proxy_username
-
Nom d'utilisateur pour le proxy.
- proxy_password
-
Mot de passe pour le proxy.
- plugins
-
Valeur : 0 ou 1.
Commutateur global pour activer ou non les greffons de
yum
.
La valeur par défaut est 0 (greffons désactivés). Voir la section
PLUGINS
de la page manuel de
yum(8)
pour plus d'information sur l'installation de greffons pour
yum.
- pluginpath
-
Une liste de répertoire dans lesquels
yum
cherchera les modules greffons. La valeur par défaut est
/usr/share/yum-plugins.
- pluginconfpath
-
Une liste de répertoires dans lesquelq yum ira chercher les fichiers de
configuration des greffons. La valeur par defaut est
/etc/yum/pluginconf.d.
- metadata_expire
-
Délai (en secondes) au bout duquel les méta-données expireront. Ainsi, si les
méta-données sont moins vieilles que ce délai,
yum
ne mettra pas à jour celles-ci par rapport au dépôt. Si vous trouvez que
yum
ne met pas à jour ces informations aussi souvent que vous le souhaitez,
diminuez la valeur de cette option.
- mirrorlist_expire
-
Durée (en secondes) après laquelle la liste des miroirs caché localement
expirera. Si la liste des mirroirs actuelle est moins vieille que cette
durée, yum ne téléchargera pas d'autre copie de la liste des miroirs.
Si vous estimez que yum ne télécharge pas assez souvent les listes de
mirroirs, vous devriez diminuer la valeur de cette option.
OPTIONS DE [repository]
La section [repository] est de la forme :
- Exemple :
-
[repositoryid]
name=Un nom pour ce dépôt
baseurl=url://chemin/vers/dépôt/
- repositoryid
-
Doit être un nom unique pour chaque dépôt, un seul mot.
- name
-
Une chaîne de caractère compréhensible décrivant le dépôt.
- baseurl
-
Doit être une URL vers le répertoire où se trouve le répertoire « repodata »
du dépot de
yum.
Cette URL peut être de type « http:// », « ftp:// » ou « file:// ».
Vous pouvez spécifier plusieurs URL dans une instruction
baseurl.
La meilleure façon de le faire est :
[repositoryid]
name=Un nom pour ce dépôt
baseurl=url://serveur1/chemin/vers/dépôt/
url://serveur2/chemin/vers/dépôt/
url://serveur3/chemin/vers/dépôt/
Si vous mettez plus d'une instruction
baseurl
pour un dépôt, vous verrez que
yum
ignorera les premières et agira probablement bizarremment.
Ne le faites pas, vous êtes averti.
Vous pouvez utiliser l'authentification HTTP de base en ajoutant
« utilisateur:mdp@ » au nom du serveur dans la ligne de l'URL. Par exemple,
« baseurl=http://utilisateur:mdp@example.com/ ».
- mirrorlist
-
Spécifier une URL vers un fichier contenant une liste de « baseurl ».
Cela peut être utilisé à la place ou avec l'option
baseurl.
Les variables de substitution, décrites plus loin, peuvent être utilisées
dans cette option.
- enabled
-
Valeur : 1 ou 0. Indiquer à
yum
d'utiliser ou non ce dépôt.
- gpgcheck
-
Valeur : 1 ou 0. Indiquer à
yum
de vérifier la signature GPG des paquetages récupérés dans ce dépôt.
- gpgkey
-
Une URL pointant vers un fichier ASCII de clé GPG pour le dépôt. Cette option
est utilisée si
yum
a besoin d'une clé publique pour vérifier un paquetage et que la clé requise
n'est pas présente dans la base de données RPM. Si cette option est présente,
yum
importera automatiquement la clé à partir de l'URL spécifiée. Il vous demandera
confirmation avant de l'installer, à moins que l'option
assumeyes
soit active.
Plusieurs URL peuvent être spécifiées de la même manière que dans l'option
baseurl
plus haut. Si une clé GPG est nécessaire pour installer un paquetage à partir
d'un dépôt, toutes les clés spécifiées pour ce dépôt seront installées.
- exclude
-
Identique à l'option
exclude
de la section [main], mais seulement pour ce dépôt. La substitution
de variables, décrite plus loin, est effectuée.
- includepkgs
-
L'inverse de
exclude.
C'est une liste de paquetages que vous voulez récupérer dans le dépôt.
S'il n'y a qu'un seul nom dans cette liste, c'est tout ce que
yum
verra pour ce dépôt. La valeur par défaut est une liste vide. La substitution
de variables, décrite plus loin, est effectuée.
- enablegroups
-
Valeur : 0 ou 1. Déterminer si
yum
autorise l'utilisation des groupes de paquetages pour ce dépôt. La valeur
par défaut est 1 (autoriser les groupes de paquetages).
- failovermethod
-
Valeur : « roundrobin » ou « priority ».
« roundrobin » sélectionne aléatoirement une URL dans la liste des URL pour
démarrer et traiter une connexion avec chacune d'elles chaque fois que l'on
échouera à contacter l'hôte.
« priority » démarrera à partir de la première URL de la liste et lira
cette dernière séquentiellement.
La valeur par défaut est « roundrobin ».
- keepalive
-
Valeur : 0 ou 1.
Déterminer si le « keepalive HTTP » doit être utilisé pour ce dépôt.
Voir l'option globale dans la section [main] plus haut pour plus d'information.
- timeout
-
Surcharge l'option
timeout
de la section [main] pour ce dépôt.
- http_caching
-
Surcharge l'option
http_caching
de la section [main] pour ce dépôt.
- retries
-
Surcharge l'option
retries
de la section [main] pour ce dépôt.
- throttle
-
Surcharge l'option
throttle
de la section [main] pour ce dépôt.
- bandwidth
-
Surcharge l'option
bandwidth
de la section [main] pour ce dépôt.
- metadata_expire
-
Surcharge l'option
metadata_expire
de la section [main] pour ce dépôt.
- mirrorlist_expire
-
Outrepasse, pour ce dépôt, l'option mirrorlist_expire
- proxy
-
URL du serveur proxy pour ce dépôt. Mettre « _none_ » pour désactiver
la configuration proxy globale pour ce dépôt.
S'il n'y a rien, elle hérite de la configuration globale.
- proxy_username
-
Nom d'utilisateur pour le proxy.
S'il n'y a rien, elle hérite de la configuration globale.
- proxy_password
-
Mot de passe pour ce proxy.
S'il n'y a rien, elle hérite de la configuration globale.
- cost
-
Coût relatif de l'accès à ce répertoire. Utile pour pondérer les paquetages
d'un dépôt plus ou moins qu'un autre. La valeur par défaut est 1000.
SYNTAXE DE INCLUDE URL
L'inclusion de fichiers de configuration externes est supportée
pour les fichiers
/etc/yum/yum.conf
et .repo dans le répertoire
/etc/yum/yum.repos.d.
Pour inclure une URL, utiliser une ligne de la forme suivante :
include=url://vers/quelque/part
Le fichier de configuration sera inséré à la position de la ligne
« include= ». Les fichiers inclus peuvent contenir des lignes d'inclusion.
yum
échouera s'il détecte une boucle d'inclusion.
ENVIRONNEMENT
Il y a plusieurs variables qui vous facilitent la maintenance des fichiers
de configuration de
yum.
Elles sont disponibles dans les valeurs de plusieurs options comme
name,
baseurl
ou
commands.
- $releasever
-
Elle sera remplacée par la valeur de la version du paquetage listé dans
distroverpkg.
La valeur par défaut est la version du paquetage « redhat-release ».
- $arch
-
Elle sera remplacée par l'architecture de votre système telle qu'elle est
récupérée par la fonction Python os.uname()[4].
- $basearch
-
Elle sera remplacée par l'architecture de base dans
yum.
Par exemple, si votre $arch est i686, votre $basearch sera i386.
- $YUM0-$YUM9
-
Elle sera remplacée par la variable d'environnement de même nom.
Si cette variable d'environnement n'existe pas, la variable du fichier
de configuration ne sera pas remplacée.
FICHIERS
/etc/yum/yum.conf
/etc/yum/yum.repos.d/
/etc/yum/pluginconf.d/
VOIR AUSSI
yum(8)
TRADUCTION
Ce document est une traduction réalisée par Alain Portal
<aportal AT univ-montp2 DOT fr> le 22 juin 2006
et révisée le 19 novembre 2007.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 5 yum.conf ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- DESCRIPTION
-
- PARAMÈTRES
-
- OPTIONS DE [main]
-
- OPTIONS DE [repository]
-
- SYNTAXE DE INCLUDE URL
-
- ENVIRONNEMENT
-
- FICHIERS
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 19 novembre 2007