Provided by: dpkg_1.15.8.4ubuntu3_i386 bug

NOMBRE

       update-alternatives - Gestin de enlaces simblicos que determinan rdenes
       predefinidas

SINOPSIS

       update-alternatives [opciones] orden

DESCRIPCIN

       update-alternatives crea, elimina, gestiona y muestra informacin  sobre
       los  enlaces  simblicos  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  funcin.  Por  ejemplo, muchos sistemas tienen
       varios editores de texto instalados al mismo tiempo,  lo  que  deja  la
       eleccin  de  qu  editor  de  texto usar en manos del usuario, si ste lo
       desea, pero hace difcil que un programa elija la opcin correcta  si  el
       usuario no ha definido ninguna preferencia.

       El  objetivo  del  sistema  de  alternativas de Debian es resolver este
       problema. Un nombre genrico 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 genrico. Por
       ejemplo, si los editores  de  texto  ed(1)  y  nvi(1)  estn  instalados
       conjuntamente  en  el  sistema,  el  sistema de alternativas har que el
       nombre genrico /usr/bin/editor se refiera a /usr/bin/nvi por omisin. 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 explcitamente.

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

       Habitualmente,  es  til  que un nmero de alternativas se sincronicen de
       tal modo que se puedan cambiar  como  un  grupo.  Por  ejemplo,  cuando
       varias  versiones  del editor vi(1) estn instaladas la pgina 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 trminos de enlaces maestro y esclavo; cuando se cambia
       el  maestro,  todos  los esclavos relacionados con l tambin 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: automtico o manual. Cuando un grupo est en modo automtico  el
       sistema  de alternativas decide automticamente 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 automtico  la  primera  vez
       que  aparecen  en  el  sistema.  Si  el  administrador del sistema hace
       cambios en la configuracin automtica del  sistema,  update-alternatives
       se  dar  cuenta  la prxima vez que se ejecute sobre el grupo de enlaces
       cambiados y el grupo pasar automticamente a modo manual.

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

       El uso de la opcin --config hace que update-alternatives muestre  todas
       las  elecciones  dentro  del grupo de enlaces que tienen como maestro a
       nombre. La eleccin presente  se  marca  con  *.  A  continuacin  se  le
       preguntar por su eleccin dentro de las opciones posibles en el grupo de
       enlaces. Una vez que se haga realizado algn cambio el grupo de  enlaces
       dejar  de  estar  en  modo automtico. Es necesario usar la opcin --auto
       para devolver el grupo de enlaces al estado automtico.

       Si quiere realizar la configuracin de un modo no interactivo puede usar
       la opcin --set en su lugar (vase ms 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 situacin. No
       es posible sobreescribir el  fichero  de  un  paquete  que  no  usa  el
       mecanismo de update-alternatives.

TERMINOLOGA

       Debido  a  que  las  actividades  que  realiza update-alternatives estn
       fuertemente relacionadas entre  s,  la  definicin  de  algunos  trminos
       especficos ayudar a entender su funcionamiento.

       nombre genrico (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 funcin similar.

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

       alternativa (o ruta alternativa)
              El nombre de un fichero especfico en el sistema de  ficheros  al
              que  se  puede  acceder  a  travs de un nombre genrico usando el
              sistema de alternativas.

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

       directorio administrativo
              El   directorio   que   contiene  la  informacin  de  estado  de
              update-alternatives, por omisin 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 cmo
              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 automtico
              Cuando  un  grupo  de  enlaces se encuentra en modo automtico 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 ningn cambio en  la  configuracin
              del administrador.

RDENES

       --install enlace nombre ruta prioridad [--slave enlace nombre ruta] ...
              Aade  un  grupo  de alternativas al sistema. enlace es el nombre
              genrico del enlace maestro,  nombre  es  el  nombre  del  enlace
              simblico  en  el  directorio  de  alternativas,  y  ruta  es  la
              alternativa que se va a introducir para el enlace  maestro.  Los
              argumentos  a  continuacin  de --slave son el nombre genrico, el
              nombre del enlace simblico en el directorio de  alternativas,  y
              la ruta alternativa para el enlace esclavo. Puede definir cero o
              ms opciones de --slave, cada uno  seguido  de  tres  argumentos.
              Tenga   en  cuenta  que  la  alternativa  maestra  debe  existir
              previamente o  la  invocacin  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 ubicacin 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 informacin suministrada
              se aadir como un nuevo conjunto de alternativas para  el  grupo.
              De  otra forma se crear un grupo nuevo en modo automtico, al que
              se le aadir la informacin suministrada. Si el grupo est en  modo
              automtico,  y  la  prioridad nueva aadida es mayor que cualquier
              otra alternativa  instalada  para  ese  grupo,  los  enlaces  se
              actualizarn 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 inclusin 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 podra 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 actualizarn o eliminarn correspondientemente. Si el
              enlace no apunta a ruta, no  se  cambia  ningn  enlace,  slo  se
              elimina la informacin 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
              combinacin con --skip-auto para revisar y configurar  todas  las
              alternativas  que no estn configuradas en modo automtico. Tambin
              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  automtico.  En  el  proceso,  el  enlace simblico y sus
              esclavos se actualizarn para apuntar a la alternativa  instalada
              con una prioridad mayor.

       --display nombre
              Muestra  informacin  acerca  del grupo de enlaces. La informacin
              incluye el modo del grupo (manual o automtico), 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
              lnea  contiene  hasta 3 campos, separados por uno o ms espacios.
              El primer campo es el nombre de la alternativa, el segundo es el
              estado  (bien  auto  o  manual),  y el ltimo contiene la eleccin
              presente para la alternativa (puede contener espacios ya que  es
              un nombre de fichero).

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

       --query nombre
              Muestra  informacin  acerca  del  grupo de enlaces, al igual que
              --display, pero de una manera  que  el  sistema  puede  analizar
              (consulte la seccin FORMATO DE CONSULTA ms 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 versin y termina.

OPCIONES

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

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

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

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

       --skip-auto
              Omite el dialogo de configuracin de alternativas  para  aquellas
              configuradas  adecuadamente  en  modo automtico. Esta opcin solo
              tiene sentido con --config o --all.

       --verbose
              Genera  una  salida  con  ms  informacin  acerca   de   lo   que
              update-alternatives est haciendo.

       --quiet
              No genera ningn comentario a menos que ocurra algn error.

FICHEROS

       /etc/alternatives/
              El  directorio  de alternativas por omisin. Se puede cambiar con
              la opcin --altdir.

       /var/lib/dpkg/alternatives/
              El directorio de administracin por omisin.  Se  puede  modificar
              con la opcin --admindir.

ESTADOS DE SALIDA

       0      La accin requerida finaliz con xito.

       2      Se   encontraron  problemas  analizando  la  lnea  de  rdenes  o
              realizando la accin 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
       nmero de alternativas disponibles en el grupo de enlaces consultado. El
       primer bloque contiene los siguientes campos:

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

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

       Best: <mejor-opcin>
              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.  Tambin
              puede  tomar  el valor mgico 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  est  presente,  las  lneas   next
              contienen  todas  las  alternativas esclavas asociadas al
              enlace maestro de la  alternativa.  Hay  un  esclavo  por
              lnea. Cada lnea contiene un espacio, el nombre genrico 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

DIAGNSTICOS

       Con la opcin --verbose, update-alternatives informa extensamente
       acerca de sus actividades por la salida estndar. Si ocurre  algn
       problema,  update-alternatives enva los mensajes de error por la
       salida de  errores  estndar  y  cierra  con  el  estado  2.  Los
       diagnsticos  deberan  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
       pgina del manual asociada.

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

              update-alternatives --display vi

       Para elegir  una  implementacin  de  vi  en  particular  use  la
       siguiente orden como el usuario root y seleccione un nmero de la
       lista:

              update-alternatives --config vi

       Para que la implementacin de vi se  vuelva  a  elegir  de  forma
       automtica, haga como administrador:

              update-alternatives --auto vi

FALLOS

       Si  encuentra  algn  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 pgina del manual, es un fallo, bien
       en la implementacin o bien en la documentacin.  Le  rogamos  que
       informe de ello.

AUTORES

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

       Esto  es  software  libre;  vea  la  versin  2 o posterior de la
       Licencia Pblica General GNU para condiciones de  copia.  NO  hay
       ninguna garanta.

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

       Esto es software libre; vea  la  versin  2  o  posterior  de  la
       Licencia  Pblica  General  GNU para condiciones de copia. NO hay
       ninguna garanta.

VASE TAMBIN

       ln(1), FHS, el estndar de la jerarqua del sistema de ficheros.

TRADUCTOR

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