Provided by:
dpkg_1.15.8.4ubuntu3_i386 
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.