Man page - update-alternatives(1)

Packages contains this manual

Available languages:

en fr pt nl sv de

Manual

update-alternatives

NOM
SYNOPSIS
DESCRIPTION
TERMINOLOGIE
COMMANDES
OPTIONS
CODE DE SORTIE
ENVIRONNEMENT
FICHIERS
FORMAT DE REQUÊTE
Exemple
DIAGNOSTICS
EXEMPLES
VOIR AUSSI
TRADUCTION

NOM

update-alternatives - Maintenance des liens symboliques déterminant les noms par défaut de certaines commandes

SYNOPSIS

update-alternatives [ option ...] commande

DESCRIPTION

update-alternatives creates, removes, maintains and displays information about the symbolic links comprising the alternatives system.

Il est possible d’installer, sur un mĂȘme systĂšme et en mĂȘme temps, des programmes qui remplissent des fonctions identiques ou semblables. Par exemple, beaucoup de systĂšmes installent plusieurs Ă©diteurs de texte en mĂȘme temps. Cela permet Ă  chaque utilisateur d’un systĂšme de choisir, s’il le dĂ©sire, un Ă©diteur de texte diffĂ©rent ; mais cela rend les choses difficiles pour le programme qui doit choisir un bon Ă©diteur de texte quand l’utilisateur n’a pas fait de choix prĂ©cis.

The alternatives system aims to solve this problem. A generic name in the filesystem is shared by all files providing interchangeable functionality. The alternatives system and the system administrator together determine which actual file is referenced by this generic name. For example, if the text editors ed (1) and nvi (1) are both installed on the system, the alternatives system will cause the generic name /usr/bin/editor to refer to /usr/bin/nvi by default. The system administrator can override this and cause it to refer to /usr/bin/ed instead, and the alternatives system will not alter this setting until explicitly requested to do so.

Le nom gĂ©nĂ©rique n’est pas un lien symbolique direct vers l’alternative choisie. C’est en fait un lien symbolique vers un nom situĂ© dans le rĂ©pertoire des « alternatives » , lequel nom est Ă  son tour un lien symbolique vers le fichier rĂ©ellement visĂ©. Les modifications faites par l’administrateur systĂšme sont ainsi confinĂ©es dans le rĂ©pertoire /etc ; le FHS (lisez-le) donne de Bonnes Raisons de faire ainsi.

When each package providing a file with a particular functionality is installed, changed or removed, update-alternatives is called to update information about that file in the alternatives system. update-alternatives is usually called from the following Debian package maintainer scripts, postinst (configure) to install the alternative and from prerm and postrm (remove) to remove the alternative. Note : In most (if not all) cases no other maintainer script actions should call update-alternatives , in particular neither of upgrade nor disappear , as any other such action can lose the manual state of an alternative, or make the alternative temporarily flip-flop, or completely switch when several of them have the same priority.

It is often useful for a number of alternatives to be synchronized, so that they are changed as a group; for example, when several versions of the vi (1) editor are installed, the manual page referenced by /usr/share/man/man1/vi.1 should correspond to the executable referenced by /usr/bin/vi . update-alternatives handles this by means of master and slave links; when the master is changed, any associated slaves are changed too. A master link and its associated slaves make up a link group .

À 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 installĂ©s ou dĂ©sinstallĂ©s, le systĂšme des « alternatives » dĂ©cide automatiquement s’il doit mettre Ă  jour les liens et comment le faire. Dans le mode manuel, le systĂšme des « alternatives » ne change pas les liens et laisse l’administrateur systĂšme prendre toutes les dĂ©cisions (sauf si quelque chose est cassĂ©).

Un groupe de liens est en mode automatique quand il est crĂ©Ă© sur un systĂšme pour la premiĂšre fois. Quand l’administrateur systĂšme modifie le paramĂ©trage automatique du systĂšme, update-alternatives le remarquera la prochaine fois qu’il sera lancĂ© pour ce groupe aux liens modifiĂ©s et il fera passer ce groupe en mode manuel.

À chaque alternative est associĂ©e une prioritĂ© . Quand un groupe de liens est en mode automatique, l’alternative visĂ©e par les Ă©lĂ©ments du groupe est celle qui possĂšde la prioritĂ© la plus Ă©levĂ©e.

Quand l’option --config est utilisĂ©e, update-alternatives affiche toutes les possibilitĂ©s du groupe pour lequel nom est le lien principal. Le choix actuel est notĂ© par un « * ». Il sera alors demandĂ© quel choix doit ĂȘtre fait pour ce groupe. Suivant le choix effectuĂ©, le groupe de liens peut ne plus ĂȘtre en mode auto . Il vous faudra utiliser l’option --auto pour revenir au mode automatique (ou rĂ©utiliser --config et choisir l’entrĂ©e marquĂ©e comme automatique).

Si vous voulez configurer de maniùre non interactive, vous pouvez utiliser l’option --set (voir ci-dessous).

Les diffĂ©rents paquets qui fournissent un mĂȘme 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 mĂ©canisme offert par update-alternatives .

TERMINOLOGIE

Comme les opĂ©rations de update-alternatives sont trĂšs compliquĂ©es, voici quelques termes qui faciliteront l’explication.
nom générique (ou lien alternatif)

C’est un nom, par exemple /usr/bin/editor , qui renvoie, Ă  travers le systĂšme des « alternatives », Ă  l’un des fichiers qui remplissent des fonctions similaires.

nom alternatif

Nom d’un lien symbolique dans le rĂ©pertoire des alternatives.

alternative (ou chemin alternatif)

C’est le nom d’un fichier particulier dans l’arborescence ; il peut ĂȘtre accessible avec un nom gĂ©nĂ©rique grĂące au systĂšme d’alternatives.

répertoire des alternatives

C’est le rĂ©pertoire qui contient les liens symboliques ; il s’agit par dĂ©faut de /etc/alternatives .

répertoire administratif

C’est le rĂ©pertoire qui contient des renseignements sur l’état de update-alternatives. Il s’agit par dĂ©faut de /var/lib/dpkg/alternatives .

groupe de liens

C’est un ensemble de liens symboliques corrĂ©lĂ©s, de maniĂšre qu’on puisse les mettre Ă  jour en une seule fois.

lien principal

Dans un groupe de liens, c’est le lien alternatif qui dĂ©termine comment sont configurĂ©s les autres liens du groupe.

lien secondaire (« slave »)

Dans un groupe de liens, c’est un lien alternatif contrĂŽlĂ© par la configuration du lien principal.

mode automatique

Quand un groupe de liens est en mode automatique, le systĂšme des « alternatives » assure que les liens dans le groupe pointent vers l’alternative possĂ©dant la prioritĂ© la plus Ă©levĂ©e dans ce groupe.

mode manuel

Quand un groupe de liens est en mode manuel, le systĂšme des « alternatives » ne modifie pas le paramĂ©trage de l’administrateur systĂšme.

COMMANDES

--install lien nom chemin priorité [ --slave lien nom chemin ]...

Ajoute un groupe d’alternatives au systĂšme. lien est le nom gĂ©nĂ©rique du lien principal, nom est le nom de son lien symbolique, et chemin est l’alternative prĂ©sentĂ©e pour le lien principal. Les paramĂštres qui suivent --slave sont le nom gĂ©nĂ©rique, le lien symbolique dans le rĂ©pertoire des alternatives et l’alternative pour un lien secondaire. On peut indiquer zĂ©ro ou plusieurs options --slave , chacune suivie par trois paramĂštres. L’alternative principale doit exister, sinon la commande Ă©chouera. Cependant, si une alternative secondaire n’existe pas, le lien secondaire ne sera simplement pas installĂ© (mais un avertissement sera affichĂ©). Si un fichier existe Ă  l’emplacement oĂč l’alternative doit ĂȘtre installĂ©e, il est conservĂ© sauf si --force est utilisĂ©.

Quand le lien principal spĂ©cifiĂ© existe dĂ©jĂ  dans les enregistrements du systĂšme des « alternatives », les renseignements fournis sont ajoutĂ©s dans un nouvel ensemble d’alternatives pour le groupe. Sinon, un nouveau groupe contenant ces informations est ajoutĂ© et mis en mode automatique. Quand un groupe est en mode automatique, et que la prioritĂ© des alternatives nouvellement ajoutĂ©es est supĂ©rieure Ă  celle de toutes les alternatives installĂ©es dans ce groupe, les liens symboliques sont mis Ă  jour et pointent vers les alternatives nouvellement ajoutĂ©es.

--set nom chemin

Ajoute le programme chemin comme alternative pour nom . C’est Ă©quivalent Ă  --config mais ce n’est pas interactif et on peut donc Ă©crire un script.

--remove nom chemin

EnlĂšve une alternative et tous les liens secondaires associĂ©s. nom est un nom dans le rĂ©pertoire des « alternatives », et chemin est un nom de fichier auquel nom peut ĂȘtre liĂ©. Quand nom est en effet liĂ© Ă  chemin , nom est mis Ă  jour et pointe vers une autre alternative adĂ©quate ou bien est enlevĂ© s’il n’y en a pas d’autre. De mĂȘme, les liens secondaires associĂ©s sont mis Ă  jour ou enlevĂ©s. Quand le lien ne pointe pas dĂ©jĂ  sur chemin , aucun lien n’est modifiĂ© ; seules les informations sur l’alternative sont supprimĂ©es.

--remove-all nom

Supprime toutes les alternatives et tous les liens secondaires associés. nom est un nom dans le répertoire des alternatives.

--all

Utilise --config sur toutes les alternatives. Cette option peut ĂȘtre combinĂ©e avec --skip-auto pour revoir et configurer toutes les alternatives qui ne sont pas en mode automatique. Les alternatives erronĂ©es sont aussi affichĂ©es. Ainsi, une mĂ©thode simple pour corriger les alternatives cassĂ©es est d’utiliser yes ’’ | update-alternatives --force --all .

--auto nom

Passe le groupe de liens suivant l’alternative de nom en mode automatique. En mĂȘme temps, le lien symbolique principal et ses liens secondaires sont mis Ă  jour et pointent vers les alternatives avec les prioritĂ©s les plus Ă©levĂ©es.

--display nom

Affiche des renseignements sur le groupe de liens. L’information affichĂ©e comprend le mode du groupe (auto ou manuel), les liens principal et secondaires, vers quelle alternative le lien principal pointe actuellement, quelles autres alternatives sont disponibles (et les liens secondaires associĂ©s), et l’alternative actuellement installĂ©e qui possĂšde la prioritĂ© la plus Ă©levĂ©e.

--get-selections

Affiche tous les noms principaux d’alternatives (ceux qui contrĂŽlent un groupe de liens) ainsi que leur Ă©tat (depuis la version 1.15.0). Chaque ligne comporte jusqu’à trois champs (sĂ©parĂ©s par une ou plusieurs espaces). Le premier est le nom de l’alternative, le second est son Ă©tat ( auto ou manual ) et le dernier montre le choix actuel pour l’alternative (il s’agit d’un nom de fichier et donc peut contenir des espaces).

--set-selections

Lit la configuration des alternatives sur l’entrĂ©e standard, dans le format utilisĂ© par --get-selections et les configure en consĂ©quence (depuis la version 1.15.0).

--query nom

Display information about the link group like --display does, but in a machine parseable way (since version 1.15.0, see section "QUERY FORMAT" below).

--list nom

Affiche toutes les cibles du groupe de liens.

--config nom

Affiche les alternatives disponibles pour un groupe de liens et permet de choisir interactivement laquelle doit ĂȘtre utilisĂ©e. Le groupe de liens est mis Ă  jour.

--help

Afficher un message d’aide puis quitter.

--version

Afficher le numéro de version puis quitter.

OPTIONS

--altdir répertoire

Donne le rĂ©pertoire des alternatives, quand il est diffĂ©rent de celui par dĂ©faut. Il s’agit par dĂ©faut de « /etc/alternatives ».

--admindir répertoire

Donne le rĂ©pertoire administratif, quand il est diffĂ©rent de celui par dĂ©faut. C’est par dĂ©faut « /var/lib/dpkg/alternatives » si DPKG_ADMINDIR n’a pas Ă©tĂ© dĂ©fini.

--instdir répertoire

DĂ©finit le rĂ©pertoire d’installation qui dĂ©signe le rĂ©pertoire oĂč les paquets sont installĂ©s (depuis dpkg 1.19.2). Par dĂ©faut, c’est « / » si DPKG_ROOT n’a pas Ă©tĂ© dĂ©fini.

--root répertoire

Indique le rĂ©pertoire racine (depuis la version 1.20.1). Cela dĂ©finit aussi les rĂ©pertoires des alternatives, d’installation et d’administration qui correspondent. Par dĂ©faut, c’est « / » si DPKG_ROOT n’a pas Ă©tĂ© dĂ©fini.

--log fichier

Indique le fichier journal (depuis la version 1.15.0), pour utiliser un fichier différent du fichier par défaut (/var/log/alternatives.log).

--force

Autorise le remplacement ou la suppression de tout fichier installĂ© Ă  la place d’un lien d’alternative qui doit ĂȘtre crĂ©Ă© ou supprimĂ©.

--skip-auto

Passe l’invite de configuration pour les alternatives qui sont correctement configurĂ©es en mode automatique. Cette option n’est pertinente qu’avec --config ou --all .

--quiet

Ne crĂ©e pas de commentaire Ă  moins qu’une erreur ne survienne.

--verbose

Produit plus de commentaires sur ce qui est fait.

--debug

Produit plus de commentaires, utiles pour le débogage, sur ce qui est fait (depuis la version 1.19.3).

CODE DE SORTIE

0

L’action demandĂ©e s’est correctement dĂ©roulĂ©e.

2

Des problĂšmes sont survenus lors de l’analyse de la ligne de commande ou bien pendant l’exĂ©cution de l’action.

ENVIRONNEMENT

DPKG_ROOT

Si cette variable est positionnée et que les options --admindir ou --root ne sont pas précisées, ce répertoire sera utilisé comme répertoire racine du systÚme de fichiers.

DPKG_ADMINDIR

Si cette variable est positionnĂ©e et que l’option --admindir n’est pas prĂ©cisĂ©e, ce rĂ©pertoire sera utilisĂ© comme rĂ©pertoire de base pour l’administration.

FICHIERS

/etc/alternatives/

Le rĂ©pertoire des « alternatives » par dĂ©faut. Peut ĂȘtre remplacĂ© avec l’option --altdir .

/var/lib/dpkg/alternatives/

Le rĂ©pertoire administratif par dĂ©faut. Peut ĂȘtre remplacĂ© avec l’option --admindir

FORMAT DE REQUÊTE

Le format de --query est un format Ă  plat de type RFC822. Il est constituĂ© de n + 1 paragraphes oĂč n est le nombre d’alternatives disponibles dans le groupe de liens interrogĂ©. Le premier paragraphe contient les champs suivants :
Name: nom

Nom de l’alternative dans le rĂ©pertoire des alternatives.

Link: lien

Nom gĂ©nĂ©rique de l’alternative.

Slaves: liste-des-liens-secondaires

Lorsque cet en-tĂȘte est prĂ©sent, les lignes suivantes contiennent tous les liens secondaires associĂ©s au lien principal de cette alternative, Ă  raison d’un lien secondaire par ligne. Chaque ligne comporte une espace, le nom de l’alternative secondaire, une espace et le chemin vers le lien secondaire.

Status: Ă©tat

État de l’alternative ( auto ou manual ).

Best: meilleur-choix

Chemin de la meilleure alternative pour ce groupe de liens. N’est pas prĂ©sent si aucune alternative n’est disponible.

Value: alternative-actuellement-choisie

Chemin de l’alternative actuellement choisie. Peut aussi prendre la valeur spĂ©ciale none , utilisĂ©e si le lien n’existe pas.

Les autres paragraphes décrivent les alternatives disponibles dans le groupe de liens interrogé.
Alternative: chemin-de-cette-alternative

Chemin vers l’alternative de ce paragraphe.

Priority: valeur-de-la-priorité

Valeur de la priorité de cette alternative.

Slaves: liste-des-liens-secondaires

Lorsque ce champ est prĂ©sent, les lignes suivantes contiennent toutes les alternatives secondaires associĂ©es au lien principal de cette alternative, Ă  raison d’une alternative secondaire par ligne. Chaque ligne comporte une espace, le nom de l’alternative secondaire, une espace et le chemin vers l’alternative secondaire.

Exemple

$ update-alternatives --query editor
Name: editor
Link: /usr/bin/editor
Slaves:
editor.1.gz /usr/share/man/man1/editor.1.gz
editor.fr.1.gz /usr/share/man/fr/man1/editor.1.gz
editor.it.1.gz /usr/share/man/it/man1/editor.1.gz
editor.pl.1.gz /usr/share/man/pl/man1/editor.1.gz
editor.ru.1.gz /usr/share/man/ru/man1/editor.1.gz
Status: auto
Best: /usr/bin/vim.basic
Value: /usr/bin/vim.basic
Alternative: /bin/ed
Priority: -100
Slaves:
editor.1.gz /usr/share/man/man1/ed.1.gz
Alternative: /usr/bin/vim.basic
Priority: 50
Slaves:
editor.1.gz /usr/share/man/man1/vim.1.gz
editor.fr.1.gz /usr/share/man/fr/man1/vim.1.gz
editor.it.1.gz /usr/share/man/it/man1/vim.1.gz
editor.pl.1.gz /usr/share/man/pl/man1/vim.1.gz
editor.ru.1.gz /usr/share/man/ru/man1/vim.1.gz

DIAGNOSTICS

Avec l’option --verbose , update-alternatives affiche de trĂšs nombreuses informations sur la sortie standard. Quand un problĂšme survient, update-alternatives envoie des messages d’erreur sur la sortie d’erreur standard et retourne un Ă©tat de sortie Ă©gal Ă  2 . Ces diagnostics devraient ĂȘtre simples Ă  comprendre ; si ce n’est pas le cas, veuillez envoyer un rapport de bogue.

EXEMPLES

There are several packages which provide a text editor compatible with vi , for example nvi and vim . Which one is used is controlled by the link group vi , which includes links for the program itself and the associated manual page.

Pour afficher les paquets disponibles qui fournissent vi et son paramĂ©trage actuel, on peut utiliser l’action --display :

update-alternatives --display vi

Pour choisir une implémentation particuliÚre 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’implĂ©mentation par dĂ©faut de vi , on peut utiliser cette commande en tant que superutilisateur :

update-alternatives --auto vi

VOIR AUSSI

ln (1), FHS (the Filesystem Hierarchy Standard).

TRADUCTION

Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006. Nicolas François, 2006. Veuillez signaler toute erreur à <debian-l10n-french@lists.debian.org>.