Provided by: dpkg_1.16.1.2ubuntu7_i386 bug

NOMBRE

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

SINOPSIS

       update-alternatives [option...] command

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.

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

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

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