Provided by: dpkg_1.16.1.2ubuntu7_i386 bug

NOM

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

SYNOPSIS

       update-alternatives [option...] command

DESCRIPTION

       update-alternatives crée, enlève, conserve et affiche des  informations
       concernant  les  liens  symboliques  qui  forment le système Debian des
       « alternatives ».

       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.

       Le système Debian des « alternatives » essaie de résoudre ce  problème.
       Tous  les  fichiers  qui  proposent  des  fonctions interchangeables se
       servent d'un nom  générique  qui  se  trouve  dans  l'arborescence.  Le
       système des « alternatives » et l'administrateur système font connaître
       ensemble le fichier qui est réellement visé par ce nom  générique.  Par
       exemple,  si  les  éditeurs de texte ed(1) et nvi(1) sont tous les deux
       installés, le système des « alternatives » fait que  le  nom  générique
       /usr/bin/editor  renvoie  par  défaut  à /usr/bin/nvi. L'administrateur
       système peut remplacer cette assignation par /usr/bin/ed et le  système
       des  « alternatives »  ne  la  changera  pas tant qu'on ne lui aura pas
       demandé explicitement de le faire.

       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
       rpertoire 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.

       Chaque  fois  qu'un  paquet  proposant  un  fichier  pour  une fonction
       déterminée, est installé, modifié ou  désinstallé,  update-alternatives
       est  appelé  pour  mettre à jour les informations concernant ce fichier
       dans le système des « alternatives ». En  général,  update-alternatives
       est appelé dans les scripts postinst (configure) et prerm (install) des
       paquets Debian.

       Il est souvent utile de synchroniser certaines alternatives, de manière
       à  pouvoir  les  manipuler  globalement ;  par exemple, quand plusieurs
       versions de vi(1)  sont installées, la page de manuel qui est visée par
       /usr/share/man/man1/vi.1    devrait    correspondre    à   /usr/bin/vi.
       update-alternatives  gère  ce  problème  avec  les   liens   principaux
       ( master )  et  les  liens  secondaires  ( slave ).  Quand  le lien
       principal est changé, tous les liens secondaires associés sont changés.
       Un lien principal et ses liens secondaires associés composent un groupe
       de liens.

       À 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ée  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.

       When using the --config option, update-alternatives will  list  all  of
       the  choices  for  the  link  group  of  which given name is the master
       alternative name. The current choice is marked with  a  '*'.  You  will
       then  be  prompted for your choice regarding this link group. Depending
       on the choice made, the link group might no longer be in auto mode. You
       will  need to use the --auto option in order to return to the automatic
       mode (or you  can  rerun  --config  and  select  the  entry  marked  as
       automatic).

       If you want to configure non-interactively you can use the --set option
       instead (see below).

       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ériques  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, le lient alternatif est le lien qui
              détermine comment sont configurés les autres liens du groupe.

       lien secondaire (« slave »)
              Un lien alternatif est un  groupe  de  liens  contrôlés  par  le
              réglage 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
              Set the program path as alternative for name. This is equivalent
              to --config but is non-interactive and thus scriptable.

       --remove nom chemin
              Enlève une alternative et tous ses 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  --call  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 lien symbolique principal 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),  vers
              quelle  alternative  le  lien  symbolique  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. Chaque ligne
              comporte jusqu'à trois  champs  (séparés  par  un  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, qui
              peut contenir des espaces).

       --set-selections
              Lit la configuration des  alternatives  sur  l'entrée  standard,
              dans  le format utilisé par update-alternatives --get-selections
              et les configure en conséquence.

       --query nom
              Affiche des informations sur  le  groupe  de  liens  de  manière
              analogue à --display, mais sous une forme qui peut être analysée
              automatiquement (voir la section FORMAT DE REQUÊTE 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 être utilisée. Le
              groupe de liens est mis à jour.

       --help Affiche un message d'aide puis quitte.

       --version
              Affiche le numéro de version puis quitte.

OPTIONS

       --altdir rpertoire
              Donne le répertoire des alternatives, quand il est différent  de
              celui par défaut.

       --admindir rpertoire
              Donne  le  répertoire  administratif,  quand il est différent de
              celui par défaut.

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

       --force
              Let  update-alternatives  replace  or drop any real file that is
              installed where an alternative  link  has  to  be  installed  or
              removed.

       --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.

       --verbose
              produit    plus    de    commentaires    sur    ce    que   fait
              update-alternatives.

       --quiet
              Ne crée pas de commentaire à 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   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

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.

FORMAT DE REQUÊTE

       The update-alternatives --query format is  using  an  RFC822-like  flat
       format. It's made of n + 1 blocks where n is the number of alternatives
       available in the queried link  group.  The  first  block  contains  the
       following fields:

       Link: link
              Nom générique de l'alternative.

       Status: status
              État de l'alternative (auto ou manual).

       Best: best-choice
              Chemin  de  la  meilleure  alternative  pour ce groupe de liens.
              N'est pas présent si aucun alternative n'est disponible.

       Value: currently-selected-alternative
              Chemin de l'alternative actuellement choisie. Peut aussi prendre
              la valeur spéciale none, utilisée si le lien n'existe pas.

       Les  autres blocs décrivent les alternatives disponibles dans le
       groupe de liens interrogé.

       Alternative: path-of-this-alternative
              Chemin vers l'alternative de ce bloc

       Priority: priority-value
              Valeur de la priorité alternative.

       Slaves: list-of-slaves
              Lorsque  cet  en-tête  est  présent,  la  ligne  suivante
              contient toutes les alternatives secondaires associées au
              lien principal  de  cette  alternative,  à  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

       With  --verbose  update-alternatives  chatters incessantly about
       its activities on  its  standard  output  channel.  If  problems
       occur,   update-alternatives   outputs  error  messages  on  its
       standard error channel and returns an exit status  of  2.  These
       diagnostics  should be self-explanatory; if you do not find them
       so, please report this as a bug.

EXEMPLES

       Plusieurs paquets fournissent un  éditeur  de  texte  compatible
       avec  vi,  par  exemple  nvi  et vim. Celui qui sera utilisé est
       déterminé par le groupe de liens vi, qui comprend des liens pour
       le programme lui-même et sa page de manuel.

       To  display  the  available  packages  which  provide vi and the
       current setting for it, use the --display action:

              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 super-utilisateur :

              update-alternatives --auto vi

BOGUES

       Si  vous  trouvez  un  bogue, veuillez le signaler au système 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'implémentation soit dans  la  documentation ;
       faites un rapport.

AUTEURS

       Copyright © 1995 Ian Jackson
       Copyright © 2009 Raphaël Hertzog

       Ce  programme  est  un  logiciel  libre ; voyez la « GNU General
       Public Licence » version 2 ou supérieure 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 supérieure pour le copyright. Il n'y a
       PAS de garantie.

VOIR AUSSI

       ln(1), FHS,  le  standard  pour  l'organisation  du  système  de
       fichiers.

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>.