Provided by: dpkg_1.14.20ubuntu6_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
       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 ».  On  appelle   habituellement
       update-alternatives  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, via un nom générique, avec le système des
              « 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  symlink  altern  priority  [--slave genname symlink
       altern]...
              Ajoute  un  groupe  d’alternatives  au  système.  gen 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 les  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  fournies  sont  ajoutées 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 ne peut
              faire 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 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.

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

       This manual page is copyright 1997,1998 Charles Briscoe-Smith.

       This is free documentation; see the GNU General Public Licence  version
       2 or later for copying conditions. There is NO WARRANTY.

VOIR AUSSI

       ln(1), FHS, le standard pour l’organisation des systèmes 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>.