Provided by:
dpkg_1.16.0.3ubuntu5_i386 
NOM
update-alternatives - maintenance des liens symboliques determinant les
noms par defaut de certaines commandes
SYNOPSIS
update-alternatives [options] commande
DESCRIPTION
update-alternatives cree, enleve, conserve et affiche des informations
concernant les liens symboliques qui forment le systeme Debian des
<< alternatives >>.
Il est possible d'installer, sur un meme systeme et en meme temps, des
programmes qui remplissent des fonctions identiques ou semblables. Par
exemple, beaucoup de systemes installent plusieurs editeurs de texte en
meme temps. Cela permet a chaque utilisateur d'un systeme de choisir,
s'il le desire, un editeur de texte different ; mais cela rend les
choses difficiles pour le programme qui doit choisir un bon editeur de
texte quand l'utilisateur n'a pas fait de choix precis.
Le systeme Debian des << alternatives >> essaie de resoudre ce
probleme. Tous les fichiers qui proposent des fonctions
interchangeables se servent d'un nom generique qui se trouve dans
l'arborescence. Le systeme des << alternatives >> et l'administrateur
systeme font connaitre ensemble le fichier qui est reellement vise par
ce nom generique. Par exemple, si les editeurs de texte ed(1) et nvi(1)
sont tous les deux installes, le systeme des << alternatives >> fait
que le nom generique /usr/bin/editor renvoie par defaut a /usr/bin/nvi.
L'administrateur systeme peut remplacer cette assignation par
/usr/bin/ed et le systeme des << alternatives >> ne la changera pas
tant qu'on ne lui aura pas demande explicitement de le faire.
Le nom generique n'est pas un lien symbolique direct vers l'alternative
choisie. C'est en fait un lien symbolique vers un nom situe dans le
r'epertoire des << alternatives >>, lequel nom est a son tour un lien
symbolique vers le fichier reellement vise. Les modifications faites
par l'administrateur systeme sont ainsi confinees dans le repertoire
/etc ; le FHS (lisez-le) donne de Bonnes Raisons de faire ainsi.
Chaque fois qu'un paquet proposant un fichier pour une fonction
determinee, est installe, modifie ou desinstalle, update-alternatives
est appele pour mettre a jour les informations concernant ce fichier
dans le systeme des << alternatives >>. En general, update-alternatives
est appele dans les scripts postinst (configure) et prerm (install) des
paquets Debian.
Il est souvent utile de synchroniser certaines alternatives, de maniere
a pouvoir les manipuler globalement ; par exemple, quand plusieurs
versions de vi(1) sont installees, la page de manuel qui est visee par
/usr/share/man/man1/vi.1 devrait correspondre a /usr/bin/vi.
update-alternatives gere ce probleme avec les liens principaux
(<< master >>) et les liens secondaires (<< slave >>). Quand le lien
principal est change, tous les liens secondaires associes sont changes.
Un lien principal et ses liens secondaires associes composent un groupe
de liens.
A tout moment, un groupe de liens est dans l'un des deux modes
suivants : automatique ou manuel. Quand un groupe est dans le mode
automatique et que des paquets sont installes ou desinstalles, le
systeme des << alternatives >> decide automatiquement s'il doit mettre
a jour les liens et comment le faire. Dans le mode manuel, le systeme
des << alternatives >> ne change pas les liens et laisse
l'administrateur systeme prendre toutes les decisions (sauf si quelque
chose est casse).
Un groupe de liens est en mode automatique quand il est cree sur un
systeme pour la premiere fois. Quand l'administrateur systeme modifie
le parametrage automatique du systeme, update-alternatives le
remarquera la prochaine fois qu'il sera lance pour ce groupe aux liens
modifies et il fera passer ce groupe en mode manuel.
A chaque alternative est associee une priorit'e. Quand un groupe de
liens est en mode automatique, l'alternative visee par les elements du
groupe est celle qui possede la priorite la plus elevee.
Quand l'option --config est utilisee, update-alternatives affiche
toutes les possibilites du groupe pour lequel nom est le lien
principal. Le choix actuel est note par un << * >>. Il sera alors
demande quel choix doit etre fait pour ce groupe. Suivant le choix
effectue, le groupe de liens peut ne plus etre en mode auto. Il vous
faudra utiliser l'option --auto pour revenir au mode automatique (ou
reutiliser --config et choisir l'entree marquee comme automatique).
Si vous voulez configurer de maniere non interactive, vous pouvez
utiliser l'option --set (voyez ci-dessous).
Les differents paquets qui fournissent un meme fichier doivent le faire
en collaborant. En d'autres termes, l'utilisation de
update-alternatives est obligatoire pour tous les paquets qui sont dans
ce cas et il n'est pas possible de remplacer un fichier d'un paquet qui
n'utilise pas le mecanisme offert par update-alternatives.
TERMINOLOGIE
Comme les operations de update-alternatives sont tres compliquees,
voici quelques termes qui faciliteront l'explication.
nom generique (ou lien alternatif)
C'est un nom, par exemple /usr/bin/editor, qui renvoie, a
travers le systeme des << alternatives >>, a l'un des fichiers
qui remplissent des fonctions similaires.
nom alternatif
Nom d'un lien symbolique dans le repertoire des alternatives.
alternative (ou chemin alternatif)
C'est le nom d'un fichier particulier dans l'arborescence ; il
peut etre accessible avec un nom generiques grace au systeme
d'alternatives.
repertoire des alternatives
C'est le repertoire qui contient les liens symboliques ; il
s'agit par defaut de /etc/alternatives.
repertoire administratif
C'est le repertoire qui contient des renseignements sur l'etat
de update-alternatives. Il s'agit par defaut de
/var/lib/dpkg/alternatives.
groupe de liens
C'est un ensemble de liens symboliques correles, de maniere
qu'on puisse les mettre a jour en une seule fois.
lien principal
Dans un groupe de liens, le lient alternatif est le lien qui
determine comment sont configures les autres liens du groupe.
lien secondaire (<< slave >>)
Un lien alternatif est un groupe de liens controles par le
reglage du lien principal.
mode automatique
Quand un groupe de liens est en mode automatique, le systeme des
<< alternatives >> assure que les liens dans le groupe pointent
vers l'alternative possedant la priorite la plus elevee dans ce
groupe.
mode manuel
Quand un groupe de liens est en mode manuel, le systeme des
<< alternatives >> ne modifie pas le parametrage de
l'administrateur systeme.
COMMANDES
--install lien nom chemin priorit'e [--slave lien nom chemin]...
Ajoute un groupe d'alternatives au systeme. lien est le nom
generique du lien principal, nom est le nom de son lien
symbolique, et chemin est l'alternative presentee pour le lien
principal. Les parametres qui suivent --slave sont le nom
generique, le lien symbolique dans le repertoire des
alternatives et l'alternative pour un lien secondaire. On peut
indiquer zero ou plusieurs options --slave chacune suivie par
trois parametres. L'alternative principale doit exister, sinon
la commande echouera. Cependant, si une alternative secondaire
n'existe pas, le lien secondaire ne sera simplement pas installe
(mais un avertissement sera affiche). Si un fichier existe a
l'emplacement ou l'alternative doit etre installee, il est
conserve sauf si --force est utilise.
Quand le lien principal specifie existe deja dans les
enregistrements du systeme des << alternatives >>, les
renseignements fournis sont ajoutes dans un nouvel ensemble
d'alternatives pour le groupe. Sinon, un nouveau groupe
contenant ces informations est ajoute et mis en mode
automatique. Quand un groupe est en mode automatique, et que la
priorite des alternatives nouvellement ajoutees est superieure a
celle de toutes les alternatives installees dans ce groupe, les
liens symboliques sont mis a jour et pointent vers les
alternatives nouvellement ajoutees.
--set nom chemin
Ajoute le programme chemin comme alternative pour nom. C'est
equivalent a --config mais ce n'est pas interactif et on peut
donc ecrire un script.
--remove nom chemin
Enleve une alternative et tous ses liens secondaires associes.
nom est un nom dans le repertoire des << alternatives >>, et
chemin est un nom de fichier auquel nom peut etre lie. Quand nom
est en effet lie a chemin, nom est mis a jour et pointe vers une
autre alternative adequate ou bien est enleve s'il n'y en a pas
d'autre. De meme, les liens secondaires associes sont mis a jour
ou enleves. Quand le lien ne pointe pas deja sur chemin, aucun
lien n'est modifie ; seules les informations sur l'alternative
sont supprimees.
--remove-all nom
Supprime toutes les alternatives et tous les liens secondaires
associes. nom est un nom dans le repertoire des alternatives.
--all Utilise --call sur toutes les alternatives. Cette option peut
etre combinee avec --skip-auto pour revoir et configurer toutes
les alternatives qui ne sont pas en mode automatique. Les
alternatives erronees sont aussi affichees. Ainsi, une methode
simple pour corriger les alternatives cassees est d'utiliser yes
'' | update-alternatives --force --all.
--auto nom
Passe le lien symbolique principal nom en mode automatique. En
meme temps, le lien symbolique principal et ses liens
secondaires sont mis a jour et pointent vers les alternatives
avec les priorites les plus elevees.
--display nom
Affiche des renseignements sur le groupe de liens. L'information
affichee comprend le mode du groupe (auto ou manuel), vers
quelle alternative le lien symbolique pointe actuellement,
quelles autres alternatives sont disponibles (et les liens
secondaires associes), et l'alternative actuellement installee
qui possede la priorite la plus elevee.
--get-selections
Affiche tous les noms principaux d'alternatives (ceux qui
controlent un groupe de liens) ainsi que leur etat. Chaque ligne
comporte jusqu'a trois champs (separes par un ou plusieurs
espaces). Le premier est le nom de l'alternative, le second est
son etat (<< auto >> ou << manual >>) et le dernier montre le
choix actuel pour l'alternative (il s'agit d'un nom de fichier,
qui peut contenir des espaces).
--set-selections
Lit la configuration des alternatives sur l'entree standard,
dans le format utilise par update-alternatives --get-selections
et les configure en consequence.
--query nom
Affiche des informations sur le groupe de liens de maniere
analogue a --display, mais sous une forme qui peut etre analysee
automatiquement (voir la section FORMAT DE REQU^ETE ci-dessous).
--list nom
Affiche toutes les cibles du groupe de liens.
--config nom
Affiche les alternatives disponibles pour un groupe de liens et
permetde choisir interactivement laquelle doit etre utilisee. Le
groupe de liens est mis a jour.
--help Affiche un message d'aide puis quitte.
--version
Affiche le numero de version puis quitte.
OPTIONS
--altdir r'epertoire
Donne le repertoire des alternatives, quand il est different de
celui par defaut.
--admindir r'epertoire
Donne le repertoire administratif, quand il est different de
celui par defaut.
--log fichier
Indique le fichier journal, pour utiliser un fichier different
du fichier par defaut (/var/log/alternatives.log).
--force
Autorise update-alternatives a remplacer tout fichier installe a
la place d'un lien d'alternative qui doit etre cree.
--skip-auto
Passe l'invite de configuration pour les alternatives qui sont
correctement configurees en mode automatique. Cette option n'est
pertinente qu'avec --config ou --all.
--verbose
produit plus de commentaires sur ce que fait
update-alternatives.
--quiet
Ne cree pas de commentaire a moins qu'une erreur ne survienne.
ENVIRONNEMENT
DPKG_ADMINDIR
If set and the --admindir option has not been specified, it will
be used as the base administrative directory.
FICHIERS
/etc/alternatives/
Le repertoire des << alternatives >> par defaut. Peut etre
remplace avec l'option --altdir.
/var/lib/dpkg/alternatives/
Le repertoire administratif par defaut. Peut etre remplace avec
l'option --admindir
CODE DE SORTIE
0 L'action demandee s'est correctement deroulee.
2 Des problemes sont survenus lors de l'analyse de la ligne de
commande ou bien pendant l'execution de l'action.
FORMAT DE REQU^ETE
Le format d'update-alternatives --query est un format a plat de type
RFC822. Il est constitue de n+1 blocs ou n est le nombre d'alternatives
disponibles dans le groupe de liens interroge. Le premier bloc contient
les champs suivants :
Link: <lien>
Nom generique de l'alternative.
Status: <etat>
Etat de l'alternative (auto ou manual).
Best: <meilleur choix>
Chemin de la meilleure alternative pour ce groupe de liens.
N'est pas present si aucun alternative n'est disponible.
Value: <alternative actuellement choisie>
Chemin de l'alternative actuellement choisie. Peut aussi prendre
la valeur speciale none, utilisee si le lien n'existe pas.
Les autres blocs decrivent les alternatives disponibles dans le
groupe de liens interroge.
Alternative: <chemin de cette alternative>
Chemin vers l'alternative de ce bloc
Priority: <valeur de la priorite>
Valeur de la priorite alternative.
Replaces: <liste des liens secondaires>
Lorsque cet en-tete est present, la ligne suivante
contient toutes les alternatives secondaires associees au
lien principal de cette alternative, a raison d'une
alternative secondaire par ligne. Chaque ligne comporte
un espace, le nom de l'alternative secondaire, un espace
et le chemin vers l'alternative secondaire.
Exemple
$ update-alternatives --query editor
Link: editor
Status: auto
Best: /usr/bin/vim.gtk
Value: /usr/bin/vim.gtk
Alternative: /bin/ed
Priority: -100
Slaves:
editor.1.gz /usr/share/man/man1/ed.1.gz
Alternative: /usr/bin/vim.gtk
Priority: 50
Slaves:
editor.1.gz /usr/share/man/man1/vim.1.gz
editor.ru.1.gz /usr/share/man/ru/man1/vim.1.gz
editor.pl.ISO8859-2.1.gz /usr/share/man/pl.ISO8859-2/man1/vim.1.gz
editor.it.ISO8859-1.1.gz /usr/share/man/it.ISO8859-1/man1/vim.1.gz
editor.pl.UTF-8.1.gz /usr/share/man/pl.UTF-8/man1/vim.1.gz
editor.it.1.gz /usr/share/man/it/man1/vim.1.gz
editor.fr.UTF-8.1.gz /usr/share/man/fr.UTF-8/man1/vim.1.gz
editor.fr.1.gz /usr/share/man/fr/man1/vim.1.gz
editor.it.UTF-8.1.gz /usr/share/man/it.UTF-8/man1/vim.1.gz
editor.pl.1.gz /usr/share/man/pl/man1/vim.1.gz
editor.fr.ISO8859-1.1.gz /usr/share/man/fr.ISO8859-1/man1/vim.1.gz
DIAGNOSTICS
Avec l'option --verbose, update-alternatives affiche de tres
nombreuses informations sur la sortie standard. Quand un
probleme survient, update-alternatives envoie des messages
d'erreur sur la sortie d'erreur standard et retourne un etat de
sortie egal a 2. Ces diagnostics devraient etre simples a
comprendre ; si ce n'est pas le cas, veuillez envoyer un rapport
de bogue.
EXEMPLES
Plusieurs paquets fournissent un editeur de texte compatible
avec vi, par exemple nvi et vim. Celui qui sera utilise est
determine par le groupe de liens vi, qui comprend des liens pour
le programme lui-meme et sa page de manuel.
Pour afficher les paquets disponibles qui fournissent vi et son
parametrage actuel, on peut utiliser l'action --display :
update-alternatives --display vi
Pour choisir une implementation particuliere de vi on peut
utiliser cette commande en tant que superutilisateur et choisir
un nombre dans la liste :
update-alternatives --config vi
Pour retrouver l'implementation par defaut de vi on peut
utiliser cette commande en tant que super-utilisateur :
update-alternatives --auto vi
BOGUES
Si vous trouvez un bogue, veuillez le signaler au systeme de
suivi des bogues de Debian.
Si vous trouvez une discordance entre l'action de
update-alternatives et cette page de manuel, c'est qu'il y a un
bogue, soit dans l'implementation soit dans la documentation ;
faites un rapport.
AUTEURS
Copyright (C) 1995 Ian Jackson
Copyright (C) 2009 Raphael Hertzog
Ce programme est un logiciel libre ; voyez la << GNU General
Public Licence >> version 2 ou superieure pour le copyright. Il
n'y a PAS de garantie.
Cette page de manuel est copyright 1997, 1998 Charles
Briscoe-Smith et autres auteurs.
Cette documentation est libre ; voyez la << GNU General Public
Licence >> version 2 ou superieure pour le copyright. Il n'y a
PAS de garantie.
VOIR AUSSI
ln(1), FHS, le standard pour l'organisation du systeme de
fichiers.
TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe
Batailler, 2006. Nicolas Francois, 2006. Veuillez signaler
toute erreur a <debian-l10n-french@lists.debian.org>.