Provided by: dpkg_1.16.1.2ubuntu7_amd64 bug

NOMBRE

       update-alternatives - Gestión de enlaces simbólicos que determinan órdenes predefinidas

SINOPSIS

       update-alternatives [option...] command

DESCRIPCIÓN

       update-alternatives  crea,  elimina,  gestiona  y  muestra  información  sobre los enlaces
       simbólicos que conforman el sistema de alternativas de Debian.

       Es posible que tenga en el sistema varios programas instalados a la vez  que  realizan  la
       misma  función. Por ejemplo, muchos sistemas tienen varios editores de texto instalados al
       mismo tiempo, lo que deja la elección de qué editor de texto usar en manos del usuario, si
       éste lo desea, pero hace difícil que un programa elija la opción correcta si el usuario no
       ha definido ninguna preferencia.

       El objetivo del sistema de alternativas de Debian es resolver  este  problema.  Un  nombre
       genérico  en  el  sistema  de ficheros se comparte entre todos los ficheros que tienen una
       funcionalidad intercambiable. El sistema de alternativas junto con  el  administrador  del
       sistema determinan a qué fichero hace referencia este nombre genérico. Por ejemplo, si los
       editores de texto ed(1) y nvi(1) están instalados conjuntamente en el sistema, el  sistema
       de  alternativas hará que el nombre genérico /usr/bin/editor se refiera a /usr/bin/nvi por
       omisión. El administrador del sistema puede modificar  esto  y  hacer  que  se  refiera  a
       /usr/bin/ed,  y  el sistema de alternativas no modificará esto posteriormente hasta que se
       solicite explícitamente.

       El nombre genérico no es un enlace simbólico directo a la alternativa seleccionada. En vez
       de   esto,  es  un  enlace  simbólico  a  un  nombre  en  el  directorio  de  alternativas/etc/alternatives»), que a su vez es un enlace simbólico  al  fichero  al  que  se  hace
       referencia  en  realidad.  El  objetivo  es que los cambios del administrador se mantengan
       dentro del directorio /etc: el FHS (q.v.) da razones de por qué esto es bueno.

       Cuando se instala o desinstala un paquete que provee un fichero con una  funcionalidad  en
       particular  se  invoca  update-alternatives  para actualizar la información del sistema de
       alternativas acerca de ese fichero. Habitualmente, update-alternatives se invoca desde los
       scripts  postinst  (post-instalación  o  configuración)  o  prerm (pre-eliminación) de los
       paquetes de Debian.

       Habitualmente, es útil que un número de alternativas se sincronicen de  tal  modo  que  se
       puedan  cambiar como un grupo. Por ejemplo, cuando varias versiones del editor vi(1) están
       instaladas la página del manual preferida por /usr/share/man/man1/vi.1  debe  corresponder
       con el ejecutable al que hace referencia /usr/bin/vi. update-alternatives manipula esto en
       términos de enlaces maestro y esclavo; cuando se cambia el  maestro,  todos  los  esclavos
       relacionados  con él también cambian. Un enlace maestro y sus esclavos relacionados forman
       un grupo de enlaces.

       Cada grupo de enlaces está en todo momento en uno de los dos modos posibles: automático  o
       manual.  Cuando  un  grupo  está  en  modo  automático  el  sistema de alternativas decide
       automáticamente el  momento  de  actualizar  los  enlaces  a  medida  que  se  instalan  o
       desinstalan  paquetes.  En  modo  manual  el  sistema  de  alternativas  deja  todas estas
       decisiones en manos del administrador del sistema.

       Los grupos de enlaces se establecen en modo automático la primera vez que aparecen  en  el
       sistema.  Si  el administrador del sistema hace cambios en la configuración automática del
       sistema, update-alternatives se dará cuenta la próxima vez que se ejecute sobre  el  grupo
       de enlaces cambiados y el grupo pasará automáticamente a modo manual.

       Cada  alternativa tiene una prioridad asociada. Cuando un grupo de enlaces se encuentra en
       modo automático, los miembros del grupo apuntarán a la alternativa con  la  prioridad  más
       alta.

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

       Los  diferentes  paquetes  que  proveen  el  mismo  fichero  tienen  que  hacerlo de forma
       cooperativa. En otras palabras, el uso de update-alternatives es obligatorio con todos los
       paquetes  relacionados  con  esa  situación.  No es posible sobreescribir el fichero de un
       paquete que no usa el mecanismo de update-alternatives.

TERMINOLOGÍA

       Debido  a  que  las  actividades  que  realiza   update-alternatives   están   fuertemente
       relacionadas entre sí, la definición de algunos términos específicos ayudará a entender su
       funcionamiento.

       nombre genérico (o enlace alternativo)
              Un nombre, como /usr/bin/editor, que  mediante  el  sistema  de  alternativas  hace
              referencia a uno de los posibles ficheros con una función similar.

       nombre de la alternativa
              El nombre de un enlace simbólico en el directorio de alternativas.

       alternativa (o ruta alternativa)
              El  nombre  de  un  fichero  específico  en  el sistema de ficheros al que se puede
              acceder a través de un nombre genérico usando el sistema de alternativas.

       directorio de alternativas
              El directorio que contiene los enlaces, por omisión es /etc/alternatives.

       directorio administrativo
              El directorio que contiene la información de  estado  de  update-alternatives,  por
              omisión es /var/lib/dpkg/alternatives.

       grupo de enlaces
              Un  conjunto  de  enlaces  relacionados  con  el objetivo de que se actualicen como
              grupo.

       enlace maestro
              El enlace alternativo en un grupo de enlaces que determina cómo  se  configuran  el
              resto de los enlaces del grupo.

       enlace esclavo
              Un enlace alternativo en un grupo de enlaces definido por el enlace maestro.

       modo automático
              Cuando  un  grupo  de  enlaces  se  encuentra  en  modo  automático  el  sistema de
              alternativas asegura que los enlaces del grupo apuntan  a  la  alternativa  con  la
              mayor prioridad en ese grupo.

       modo manual
              Cuando  un  grupo de enlaces se encuentra en modo manual el sistema de alternativas
              no hará ningún cambio en la configuración del administrador.

ÓRDENES

       --install enlace nombre ruta prioridad [--slave enlace nombre ruta] ...
              Añade un grupo de alternativas al sistema. enlace es el nombre genérico del  enlace
              maestro, nombre es el nombre del enlace simbólico en el directorio de alternativas,
              y ruta es la alternativa que se  va  a  introducir  para  el  enlace  maestro.  Los
              argumentos  a  continuación de --slave son el nombre genérico, el nombre del enlace
              simbólico en el directorio de alternativas, y la ruta alternativa  para  el  enlace
              esclavo.  Puede  definir  cero  o más opciones de --slave, cada uno seguido de tres
              argumentos. Tenga en cuenta que la alternativa maestra debe existir  previamente  o
              la  invocación  fallará.  Por  otra  parte, si la alternativa esclava no existe, el
              enlace esclavo alternativo correspondiente no se instalará, mostrando un aviso.  Un
              fichero  real instalado en la ubicación de un enlace alternativo nunca se eliminará
              a menos que se use --force.

              Si el nombre de la alternativa definida ya existe en los registros del  sistema  de
              alternativas  la  información  suministrada  se  añadirá  como un nuevo conjunto de
              alternativas para el grupo. De  otra  forma  se  creará  un  grupo  nuevo  en  modo
              automático,  al  que se le añadirá la información suministrada. Si el grupo está en
              modo automático,  y  la  prioridad  nueva  añadida  es  mayor  que  cualquier  otra
              alternativa  instalada  para  ese grupo, los enlaces se actualizarán para apuntar a
              las nuevas alternativas.

       --set nombre ruta
              Set the program path as alternative for name. This is equivalent to --config but is
              non-interactive and thus scriptable.

       --remove nombre ruta
              Elimina una alternativa y todos sus enlaces esclavos asociados. nombre es el nombre
              en el directorio de alternativas y ruta es el nombre absoluto del  fichero  al  que
              nombre  se  podría  enlazar.  Si nombre está en realidad enlazado a ruta, nombre se
              actualizará para que apunte a otra alternativa apropiada o se eliminará si no queda
              ninguna  alternativa  restante.  Los  enlaces  esclavos asociados se actualizarán o
              eliminarán correspondientemente. Si el enlace no apunta a ruta, no se cambia ningún
              enlace, sólo se elimina la información acerca de la alternativa.

       --remove-all nombre
              Elimina todas las alternativas y todos sus enlaces esclavos asociados. nombre es un
              nombre en el directorio de alternativas.

       --all  Invoca --config sobre todas las alternativas. Puede ser  útil  en  combinación  con
              --skip-auto  para  revisar  y  configurar  todas  las  alternativas  que  no  están
              configuradas en modo automático. También se muestran las  alternativas  rotas.  Una
              manera  sencilla  de  arreglar  todas  las  alternativas  rotas es invocar yes '' |
              update-alternatives --force --all.

       --auto nombre
              Cambia el grupo de enlaces dependientes de la alternativa nombre a modo automático.
              En el proceso, el enlace simbólico y sus esclavos se actualizarán para apuntar a la
              alternativa instalada con una prioridad mayor.

       --display nombre
              Muestra información acerca del grupo de enlaces. La información incluye el modo del
              grupo  (manual o automático), a qué alternativa apunta el enlace maestro, qué otras
              alternativas  existen  (y  sus  alternativas  esclavas  correspondientes),   y   la
              alternativa de mayor prioridad instalada en el sistema.

       --get-selections
              Crea  un  listado  de  todas  los  nombres  de  alternativas maestras (aquellas que
              controlan un grupo de enlaces) y su estado. Cada línea  contiene  hasta  3  campos,
              separados  por  uno o más espacios. El primer campo es el nombre de la alternativa,
              el segundo es el estado (bien «auto» o «manual»), y el último contiene la  elección
              presente  para  la  alternativa  (puede  contener  espacios  ya que es un nombre de
              fichero).

       --set-selections
              Lee la configuración de alternativas por la entrada estándar en el formato generado
              por update-alternatives --get-selections y los reconfigura apropiadamente.

       --query nombre
              Muestra  información acerca del grupo de enlaces, al igual que «--display», pero de
              una manera que el sistema puede analizar (consulte la sección FORMATO  DE  CONSULTA
              más abajo).

       --list name
              Muestra todos los objetivos del grupo de enlaces.

       --config nombre
              Muestra  las alternativas disponibles para un grupo de enlaces y permite al usuario
              seleccionar interactivamente cual usar. El grupo de enlaces se actualizará.

       --help Muestra el modo de uso y termina.

       --version
              Muestra la versión y termina.

OPCIONES

       --altdir directorio
              Define el directorio de  alternativas,  cuando  es  diferente  del  directorio  por
              omisión.

       --admindir directorio
              Define  el  directorio  administrativo,  cuando  es  diferente  del  directorio por
              omisión.

       --log=fichero
              Define el fichero de registro de alternativas cuando es  diferente  del  valor  por
              omisión («/var/log/alternativas.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
              Omite el dialogo  de  configuración  de  alternativas  para  aquellas  configuradas
              adecuadamente  en  modo  automático.  Esta opción solo tiene sentido con --config o
              --all.

       --verbose
              Genera una salida con más información acerca de  lo  que  update-alternatives  está
              haciendo.

       --quiet
              No genera ningún comentario a menos que ocurra algún error.

ENTORNO

       DPKG_ADMINDIR
              If  set  and  the  --admindir option has not been specified, it will be used as the
              base administrative directory.

FICHEROS

       /etc/alternatives/
              El directorio de alternativas por omisión. Se puede cambiar con la opción --altdir.

       /var/lib/dpkg/alternatives/
              El directorio de administración por omisión.  Se  puede  modificar  con  la  opción
              --admindir.

ESTADOS DE SALIDA

       0      La acción requerida finalizó con éxito.

       2      Se  encontraron  problemas  analizando  la  línea de órdenes o realizando la acción
              requerida.

FORMATO DE CONSULTA

       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
              El nombre genérico de la alternativa.

       Status: status
              El estado de la alternativa (auto o manual).

       Best: best-choice
              La ruta de la mejor alternativa para este  grupo  de  enlaces.  No  aparece  si  no
              existen alternativas disponibles.

       Value: currently-selected-alternative
              La ruta de la alternativa seleccionada en ese momento. También puede tomar el valor
              mágico none (ninguno). Se usa si el enlace no existe.

       Los siguientes bloques describen las alternativas  disponibles  en  el  grupo  de  enlaces
       consultado:

       Alternative: path-of-this-alternative
              Ruta a la alternativa de este bloque.

       Priority: priority-value
              Valor de la prioridad de esta alternativa.

       Slaves: list-of-slaves
              Cuando   esta   cabecera  está  presente,  las  líneas  next  contienen  todas  las
              alternativas esclavas asociadas al enlace maestro de la alternativa. Hay un esclavo
              por  línea.  Cada  línea  contiene un espacio, el nombre genérico de la alternativa
              esclava, otro espacio, y la ruta a la alternativa esclava.

       Ejemplo
              $ 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

DIAGNÓSTICOS

       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.

EJEMPLOS

       Hay  varios  paquetes  que  proporcionan un editor de texto compatible con vi, por ejemplo
       nviy vim. El grupo de enlaces vi selecciona  cual  se  usa,  incluyendo  enlaces  para  el
       programa y la página del manual asociada.

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

              update-alternatives --display vi

       Para elegir una implementación de vi en particular use la siguiente orden como el  usuario
       «root» y seleccione un número de la lista:

              update-alternatives --config vi

       Para  que  la  implementación  de  vi  se  vuelva  a elegir de forma automática, haga como
       administrador:

              update-alternatives --auto vi

FALLOS

       Si encuentra algún fallo informe de ello usando el sistema de  seguimiento  de  fallos  de
       Debian.

       Si  encuentra  alguna  discrepancia  entre el modo de operar de update-alternatives y esta
       página del manual, es un fallo, bien en la implementación o bien en la  documentación.  Le
       rogamos que informe de ello.

AUTORES

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

       Esto  es  software  libre; vea la versión 2 o posterior de la Licencia Pública General GNU
       para condiciones de copia. NO hay ninguna garantía.

       Los derechos de autor de esta página de manual pertenecen a Charles Briscoe-Smith y otros,
       1997,1998.

       Esto  es  software  libre; vea la versión 2 o posterior de la Licencia Pública General GNU
       para condiciones de copia. NO hay ninguna garantía.

VÉASE TAMBIÉN

       ln(1), FHS, el estándar de la jerarquía del sistema de ficheros.

TRADUCTOR

       Rudy Godoy <rudy@kernel-panik.org>,  Rubén  Porras  <nahoo@inicia.es>,  Bruno  Barrera  C.
       <bruno.barrera@igloo.cl>,  Carlos  Izquierdo  <gheesh@ertis.net>,  Esteban Manchado y NOK.
       Debian L10n Spanish <debian-l10n-spanish@lists.debian.org>.
       Revisiones por Santiago Vila <sanvila@unex.es>, Javier Fernández-Sanguino,  Rubén  Porras,
       Luis Uribe y Omar Campagne.