Provided by: dpkg_1.14.24ubuntu1_i386 bug

NOM

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

SYNOPSIS

       update-alternatives [options] commande

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

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

       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.

       Quand  on utilise l’option --config, update-alternatives affiche toutes
       les possibilités du groupe pour lequel nom est le  lien  principal.  Le
       choix  actuel  est  noté  par  un  « * » et le choix avec la plus haute
       priorité, par un « + ». On vous demandera alors quelle possibilité vous
       choisissez pour ce groupe. Dès qu’une modification est faite, le groupe
       de liens n’est plus en mode auto.  Il  vous  faudra  utiliser  l’option
       --auto pour revenir au mode automatique.

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

       Les différents paquets qui fournissent un même fichier doivent le faire
       en  collaborant.  C’est-à-dire que 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
              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.

       lien symbolique
              Sans  autre  information, c’est un lien symbolique qui se trouve
              dans  le  répertoire  alternatives,  lien  que  l’administrateur
              système est supposé établir.

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

       lien secondaire (« slave »)
              Dans un  groupe  de  liens,  c’est  un  lien  déterminé  par  le
              paramétrage 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 genname lien altern priority [--slave genname lien altern]...
              Ajoute un groupe d’alternatives au système. genname est  le  nom
              générique  du  lien  principal,  lien  est  le  nom  de son lien
              symbolique, et altern est l’alternative présentée pour  le  lien
              principal. Les arguments après --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 arguments.

              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 quand
              la priorité des  alternatives  nouvellement  ajoutées  est  plus
              élevée  que  toutes  celles  des 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 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  Appelle --config sur toutes les alternatives.

       --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 pour lequel
              nom est le lien principal. 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.

       --list link
              Affiche toutes les cibles du groupe de liens.

       --config lien
              Affiche  les alternatives disponibles pour un groupe de liens et
              autorise l’utilisateur à faire un choix de manière  interactive.
              Le  groupe  de  liens est mis à jour et le mode automatique auto
              est désactivé.

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

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

OPTIONS

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

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

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

       --quiet
              Ne  produit  pas de commentaire à moins qu’une erreur survienne.
              Cette option n’est pas encore implémentée.

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.

DIAGNOSTICS

       update-alternatives  bavarde sans arrêt sur ses opérations sur le canal
       de sortie  standard.  Quand  un  problème  arrive,  update-alternatives
       envoie  des  messages  d’erreur  sur  la  sortie  d’erreur  standard et
       retourne un  état  de  sortie  égal  à  2.  Ces  diagnostics  devraient
       s’expliquer  d’eux-mêmes ;  si  ce  n’est pas le cas, veuillez faire un
       rapport de bogue.

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.

       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 super-utilisateur 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, ou  bien,  si  ce  n’est  pas  possible,  envoyez  un
       courriel directement à l’auteur.

       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.

AUTEUR

       Copyright (C) 1995 Ian Jackson

       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.

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