Provided by: dpkg_1.17.5ubuntu5_amd64 bug

NOMBRE

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

SINOPSIS

       update-alternatives [opción...] orden

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  utilizar  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  ejecuta  update-alternatives para actualizar la información del sistema de
       alternativas acerca de ese fichero. Habitualmente, update-alternatives  se  ejecuta  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.

       El  uso  de  la  opción --config hace que update-alternatives muestre todas las elecciones
       dentro del grupo de enlaces que tienen como maestro a  nombre.  La  elección  presente  se
       marca  con  «*».  A  continuación  se le preguntará por su elección dentro de las opciones
       posibles en el grupo de enlaces. Una vez que se haga realizado algún cambio  el  grupo  de
       enlaces  dejará  de  estar en modo automático. Es necesario utilizar la opción --auto para
       devolver el grupo de enlaces al estado automático, o puede ejecutar otra  vez  --config  y
       seleccionar la entrada marcada como automática.

       Si  quiere  realizar  la  configuración de un modo no interactivo puede utilizar la opción
       --set en su lugar (véase más abajo).

       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 ejecució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
              Define  la ruta del programa como alternativa para nombre. Equivale a --config pero
              no es interactivo, de modo que permite su inclusión en scripts.

       --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  Ejecuta  --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  ejecutar  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
              Permite que update-alternatives reemplace u omita cualquier fichero real  instalado
              en la misma ubicación donde se va a instalar o eliminar un enlace alternativo.

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

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.

ENTORNO

       DPKG_ADMINDIR
              Si  se  define,  y no se define la opción --admindir, se utiliza como el directorio
              base de gestión.

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.

FORMATO DE CONSULTA

       El  formato  de  consulta de update-alternatives --query utiliza un formato simple de tipo
       RFC822. Se compone de n + 1 bloques, donde n es el número de alternativas  disponibles  en
       el grupo de enlaces consultado. El primer bloque contiene los siguientes campos:

       Name: nombre
              El nombre de la alternativa en el directorio de alternativas.

       Link: enlace
              El nombre genérico de la alternativa.

       Slaves: lista de esclavos
              Cuando este campo está presente, las líneas siguientes contienen todos los enlances
              esclavos asociados 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 al enlace esclavo.

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

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

       Value: alternativa-seleccionada-actualmente
              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: ruta-a-esta-alternativa
              Ruta a la alternativa de este bloque.

       Priority: valor-de-prioridad
              Valor de la prioridad de esta alternativa.

       Slaves: lista de esclavos
              When  this  field is present, the next lines hold all slave alternatives associated
              to the master link of the alternative. There is  one  slave  per  line.  Each  line
              contains  one  space, the generic name of the slave alternative, another space, and
              the path to the slave alternative.

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

DIAGNÓSTICOS

       Con  la  opción  --verbose,  update-alternatives  informa  detalladamente  acerca  de  sus
       actividades  por  la  salida estándar. Si ocurre algún problema, update-alternatives envía
       los mensajes de error por la salida de errores estándar y cierra  con  el  estado  2.  Los
       diagnósticos  deberían  ser  auto-explicativos;  si  a  usted no se lo parecen, le rogamos
       informe de esto como un fallo.

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.

       Utilice la opción --display para mostrar los paquetes disponibles que proporcionan vi y su
       configuración actual:

              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

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.