Provided by: dpkg_1.16.0.3ubuntu5_i386 bug

NOMBRE

       update-alternatives  -  Gestion  de  enlaces  simbolicos que determinan
       ordenes predefinidas

SINOPSIS

       update-alternatives [opciones] orden

DESCRIPCI'ON

       update-alternatives crea, elimina, gestiona y muestra informacion sobre
       los  enlaces  simbolicos  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  funcion.  Por ejemplo, muchos sistemas tienen
       varios editores de texto instalados al mismo tiempo,  lo  que  deja  la
       eleccion  de  que editor de texto usar en manos del usuario, si este lo
       desea, pero hace dificil que un programa elija la opcion correcta si el
       usuario no ha definido ninguna preferencia.

       El  objetivo  del  sistema  de  alternativas de Debian es resolver este
       problema. Un nombre generico 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  que  fichero  hace  referencia este nombre generico. Por
       ejemplo, si los editores de  texto  ed(1)  y  nvi(1)  estan  instalados
       conjuntamente  en  el  sistema,  el sistema de alternativas hara que el
       nombre generico /usr/bin/editor se refiera a /usr/bin/nvi por  omision.
       El  administrador  del  sistema  puede  modificar  esto  y hacer que se
       refiera a /usr/bin/ed, y el sistema de alternativas no modificara  esto
       posteriormente hasta que se solicite explicitamente.

       El  nombre  generico no es un enlace simbolico directo a la alternativa
       seleccionada. En vez de esto, es un enlace simbolico a un nombre en  el
       directorio  de alternativas (<</etc/alternatives>>), que a su vez es un
       enlace simbolico 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 que 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 informacion del sistema de  alternativas  acerca  de  ese
       fichero. Habitualmente, update-alternatives se invoca desde los scripts
       postinst (post-instalacion o configuracion) o  prerm  (pre-eliminacion)
       de los paquetes de Debian.

       Habitualmente,  es util que un numero de alternativas se sincronicen de
       tal modo que se puedan cambiar  como  un  grupo.  Por  ejemplo,  cuando
       varias versiones del editor vi(1) estan instaladas la pagina 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 terminos de  enlaces  maestro  y  esclavo;  cuando  se
       cambia  el  maestro,  todos  los  esclavos  relacionados con el tambien
       cambian. Un enlace maestro y sus esclavos relacionados forman un  grupo
       de enlaces.

       Cada  grupo  de  enlaces  esta  en todo momento en uno de los dos modos
       posibles: automatico o manual. Cuando un grupo esta en modo  automatico
       el  sistema  de  alternativas  decide  automaticamente  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 automatico la  primera  vez
       que  aparecen  en  el  sistema.  Si  el  administrador del sistema hace
       cambios en la configuracion automatica del sistema, update-alternatives
       se  dara cuenta la proxima vez que se ejecute sobre el grupo de enlaces
       cambiados y el grupo pasara automaticamente a modo manual.

       Cada alternativa tiene una  prioridad  asociada.  Cuando  un  grupo  de
       enlaces  se  encuentra  en  modo  automatico,  los  miembros  del grupo
       apuntaran a la alternativa con la prioridad mas alta.

       El uso de la opcion --config hace que update-alternatives muestre todas
       las  elecciones  dentro  del grupo de enlaces que tienen como maestro a
       nombre. La eleccion presente se marca con <<*>>. A continuacion  se  le
       preguntara  por su eleccion dentro de las opciones posibles en el grupo
       de enlaces. Una vez que se haga realizado  algun  cambio  el  grupo  de
       enlaces dejara de estar en modo autom'atico. Es necesario usar la opcion
       --auto para devolver el grupo de enlaces al estado automatico.

       Si quiere realizar la configuracion de un  modo  no  interactivo  puede
       usar la opcion --set en su lugar (vease mas 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 situacion.
       No es posible sobreescribir el fichero de un  paquete  que  no  usa  el
       mecanismo de update-alternatives.

TERMINOLOG'IA

       Debido  a  que  las  actividades  que realiza update-alternatives estan
       fuertemente relacionadas entre si, la definicion  de  algunos  terminos
       especificos ayudara a entender su funcionamiento.

       nombre generico (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 funcion similar.

       nombre de la alternativa
              El   nombre   de   un  enlace  simbolico  en  el  directorio  de
              alternativas.

       alternativa (o ruta alternativa)
              El nombre de un fichero especifico en el sistema de ficheros  al
              que  se  puede  acceder a traves de un nombre generico usando el
              sistema de alternativas.

       directorio de alternativas
              El  directorio  que  contiene  los  enlaces,  por   omision   es
              /etc/alternatives.

       directorio administrativo
              El   directorio   que  contiene  la  informacion  de  estado  de
              update-alternatives, por omision 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 como
              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 automatico
              Cuando  un  grupo  de enlaces se encuentra en modo automatico 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   hara   ningun   cambio   en   la
              configuracion del administrador.

'ORDENES

       --install enlace nombre ruta prioridad [--slave enlace nombre ruta] ...
              Anade  un  grupo de alternativas al sistema. enlace es el nombre
              generico del enlace maestro, nombre  es  el  nombre  del  enlace
              simbolico  en  el  directorio  de  alternativas,  y  ruta  es la
              alternativa que se va a introducir para el enlace  maestro.  Los
              argumentos  a continuacion de --slave son el nombre generico, el
              nombre del enlace simbolico en el directorio de alternativas,  y
              la ruta alternativa para el enlace esclavo. Puede definir cero o
              mas opciones de --slave, cada uno seguido  de  tres  argumentos.
              Tenga   en  cuenta  que  la  alternativa  maestra  debe  existir
              previamente o la invocacion  fallara.  Por  otra  parte,  si  la
              alternativa  esclava  no  existe,  el enlace esclavo alternativo
              correspondiente no se instalara, mostrando un aviso. Un  fichero
              real instalado en la ubicacion de un enlace alternativo nunca se
              eliminara a menos que se use --force.

              Si el nombre  de  la  alternativa  definida  ya  existe  en  los
              registros   del   sistema   de   alternativas   la   informacion
              suministrada se anadira como un nuevo conjunto  de  alternativas
              para  el  grupo.  De otra forma se creara un grupo nuevo en modo
              automatico, al que se le anadira la informacion suministrada. Si
              el  grupo  esta en modo automatico, y la prioridad nueva anadida
              es mayor que  cualquier  otra  alternativa  instalada  para  ese
              grupo,  los  enlaces  se  actualizaran 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 inclusion 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 podria  enlazar.
              Si   nombre   esta  en  realidad  enlazado  a  ruta,  nombre  se
              actualizara para que apunte a otra alternativa  apropiada  o  se
              eliminara  si no queda ninguna alternativa restante. Los enlaces
              esclavos    asociados    se    actualizaran     o     eliminaran
              correspondientemente.  Si  el  enlace  no  apunta  a ruta, no se
              cambia ningun enlace, solo se elimina la informacion  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 util  en
              combinacion  con --skip-auto para revisar y configurar todas las
              alternativas que  no  estan  configuradas  en  modo  automatico.
              Tambien  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 automatico. En el proceso,  el  enlace  simbolico  y  sus
              esclavos se actualizaran para apuntar a la alternativa instalada
              con una prioridad mayor.

       --display nombre
              Muestra informacion acerca del grupo de enlaces. La  informacion
              incluye   el  modo  del  grupo  (manual  o  automatico),  a  que
              alternativa apunta el enlace  maestro,  que  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
              linea contiene hasta 3 campos, separados por uno o mas espacios.
              El primer campo es el nombre de la alternativa, el segundo es el
              estado (bien <<auto>> o <<manual>>), y  el  ultimo  contiene  la
              eleccion  presente  para la alternativa (puede contener espacios
              ya que es un nombre de fichero).

       --set-selections
              Lee la configuracion de alternativas por la entrada estandar  en
              el  formato  generado por update-alternatives --get-selections y
              los reconfigura apropiadamente.

       --query nombre
              Muestra informacion acerca del grupo de enlaces,  al  igual  que
              <<--display>>,  pero de una manera que el sistema puede analizar
              (consulte la seccion FORMATO DE CONSULTA mas 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 actualizara.

       --help Muestra el modo de uso y termina.

       --version
              Muestra la version y termina.

OPCIONES

       --altdir directorio
              Define el directorio de alternativas, cuando  es  diferente  del
              directorio por omision.

       --admindir directorio
              Define  el  directorio  administrativo,  cuando es diferente del
              directorio por omision.

       --log=fichero
              Define  el  fichero  de  registro  de  alternativas  cuando   es
              diferente del valor por omision (<</var/log/alternativas.log>>).

       --force
              Deja  que  update-alternatives  reemplace cualquier fichero real
              instalado en la misma ubicacion que la de un enlace alternativo.

       --skip-auto
              Omite el dialogo de configuracion de alternativas para  aquellas
              configuradas  adecuadamente en modo automatico. Esta opcion solo
              tiene sentido con --config o --all.

       --verbose
              Genera  una  salida  con  mas  informacion  acerca  de  lo   que
              update-alternatives esta haciendo.

       --quiet
              No genera ningun comentario a menos que ocurra algun 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 omision. Se puede cambiar  con
              la opcion --altdir.

       /var/lib/dpkg/alternatives/
              El  directorio de administracion por omision. Se puede modificar
              con la opcion --admindir.

ESTADOS DE SALIDA

       0      La accion requerida finalizo con exito.

       2      Se encontraron  problemas  analizando  la  linea  de  ordenes  o
              realizando la accion requerida.

FORMATO DE CONSULTA

       El  formato de consulta (--query) de update-alternatives usa un formato
       simple de tipo RFC822. Se compone de n + 1 bloques, en el que n  es  el
       numero  de  alternativas disponibles en el grupo de enlaces consultado.
       El primer bloque contiene los siguientes campos:

       Link: <enlace>
              El nombre generico de la alternativa.

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

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

       Value: <alternativa seleccionada>
              La  ruta  de la alternativa seleccionada en ese momento. Tambien
              puede tomar el valor magico 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: <prioridad>
              Valor de la prioridad de esta alternativa.

       Slaves: <lista de esclavos>
              Cuando esta  cabecera  esta  presente,  las  lineas  next
              contienen  todas  las  alternativas esclavas asociadas al
              enlace maestro de la  alternativa.  Hay  un  esclavo  por
              linea. Cada linea contiene un espacio, el nombre generico
              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'OSTICOS

       Con    la    opcion   --verbose,   update-alternatives   informa
       extensamente acerca de sus actividades por la  salida  estandar.
       Si ocurre algun problema, update-alternatives envia los mensajes
       de error por la salida de  errores  estandar  y  cierra  con  el
       estado  2. Los diagnosticos deberian 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
       pagina del manual asociada.

       Para mostrar los paquetes disponibles que proporcionan vi  y  su
       configuracion actual, use la opcion --display:

              update-alternatives --display vi

       Para  elegir  una  implementacion  de  vi  en  particular use la
       siguiente orden como el usuario <<root>> y seleccione un  numero
       de la lista:

              update-alternatives --config vi

       Para  que  la  implementacion  de vi se vuelva a elegir de forma
       automatica, haga como administrador:

              update-alternatives --auto vi

FALLOS

       Si encuentra algun 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 pagina del manual, es un fallo,  bien
       en  la implementacion o bien en la documentacion. Le rogamos que
       informe de ello.

AUTORES

       Copyright (C) 1995 Ian Jackson
       Copyright (C) 2009 Raphael Hertzog

       Esto es software libre; vea la  version  2  o  posterior  de  la
       Licencia  Publica  General GNU para condiciones de copia. NO hay
       ninguna garantia.

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

       Esto  es  software  libre;  vea  la  version 2 o posterior de la
       Licencia Publica General GNU para condiciones de copia.  NO  hay
       ninguna garantia.

V'EASE TAMBI'EN

       ln(1), FHS, el estandar de la jerarquia del sistema de ficheros.

TRADUCTOR

       Rudy     Godoy     <rudy@kernel-panik.org>,     Ruben     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
       Fernandez-Sanguino, Ruben Porras, Luis Uribe y Omar Campagne.