.\" dpkg manual page - update-alternatives(8) .\" .\" Copyright © 1997-1998 Charles Briscoe-Smith .\" Copyright © 1999 Ben Collins .\" Copyright © 2000 Wichert Akkerman .\" Copyright © 2003 Adam Heath .\" Copyright © 2005 Scott James Remnant .\" Copyright © 2006-2012 Guillem Jover .\" Copyright © 2008 Pierre Habouzit .\" Copyright © 2009-2011 Raphaël Hertzog .\" .\" This is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . . .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH update\-alternatives 8 "31 de julio del 2012" "Proyecto Debian" "Herramientas de dpkg" .SH NOMBRE update\-alternatives \- Gestión de enlaces simbólicos que determinan órdenes predefinidas . .SH SINOPSIS \fBupdate\-alternatives\fP [\fIopción\fP...] \fIorden\fP . .SH DESCRIPCIÓN \fBupdate\-alternatives\fP crea, elimina, gestiona y muestra información sobre los enlaces simbólicos que conforman el sistema de alternativas de Debian. .PP 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. .PP 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 \fBed\fP(1) y \fBnvi\fP(1) están instalados conjuntamente en el sistema, el sistema de alternativas hará que el nombre genérico \fI/usr/bin/editor\fP se refiera a \fI/usr/bin/nvi\fP por omisión. El administrador del sistema puede modificar esto y hacer que se refiera a \fI/usr/bin/ed\fP, y el sistema de alternativas no modificará esto posteriormente hasta que se solicite explícitamente. .PP 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 \fIdirectorio\fP de \fIalternativas\fP («/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 \fI/etc\fP: el FHS (q.v.) da razones de por qué esto es bueno. .PP When each package providing a file with a particular functionality is installed, changed or removed, \fBupdate\-alternatives\fP is called to update information about that file in the alternatives system. \fBupdate\-alternatives\fP is usually called from the \fBpostinst\fP (configure) or \fBprerm\fP (remove and deconfigure) scripts in Debian packages. .PP 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 \fBvi\fP(1) están instaladas la página del manual preferida por \fI/usr/share/man/man1/vi.1\fP debe corresponder con el ejecutable al que hace referencia \fI/usr/bin/vi\fP. \fBupdate\-alternatives\fP manipula esto en términos de enlaces \fImaestro\fP y \fIesclavo\fP; cuando se cambia el maestro, todos los esclavos relacionados con él también cambian. Un enlace maestro y sus esclavos relacionados forman un \fIgrupo\fP de \fIenlaces\fP. .PP 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. .PP 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, \fBupdate\-alternatives\fP 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. .PP Cada alternativa tiene una \fIprioridad\fP 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. .PP El uso de la opción \fB\-\-config\fP hace que \fBupdate\-alternatives\fP muestre todas las elecciones dentro del grupo de enlaces que tienen como maestro a \fInombre\fP. 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 \fIautomático\fP. Es necesario utilizar la opción \fB\-\-auto\fP para devolver el grupo de enlaces al estado automático, o puede ejecutar otra vez \fB\-\-config\fP y seleccionar la entrada marcada como automática. .PP Si quiere realizar la configuración de un modo no interactivo puede utilizar la opción \fB\-\-set\fP en su lugar (véase más abajo). .PP Los diferentes paquetes que proveen el mismo fichero tienen que hacerlo de forma \fBcooperativa\fP. En otras palabras, el uso de \fBupdate\-alternatives\fP es \fBobligatorio\fP con todos los paquetes relacionados con esa situación. No es posible sobreescribir el fichero de un paquete que no usa el mecanismo de \fBupdate\-alternatives\fP. . .SH TERMINOLOGÍA Debido a que las actividades que realiza \fBupdate\-alternatives\fP están fuertemente relacionadas entre sí, la definición de algunos términos específicos ayudará a entender su funcionamiento. .TP nombre genérico (o enlace alternativo) Un nombre, como \fI/usr/bin/editor\fP, que mediante el sistema de alternativas hace referencia a uno de los posibles ficheros con una función similar. .TP nombre de la alternativa El nombre de un enlace simbólico en el directorio de alternativas. .TP 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. .TP directorio de alternativas El directorio que contiene los enlaces, por omisión es \fI/etc/alternatives\fP. .TP directorio administrativo El directorio que contiene la información de estado de \fBupdate\-alternatives\fP, por omisión es \fI/var/lib/dpkg/alternatives\fP. .TP grupo de enlaces Un conjunto de enlaces relacionados con el objetivo de que se actualicen como grupo. .TP enlace maestro El enlace alternativo en un grupo de enlaces que determina cómo se configuran el resto de los enlaces del grupo. .TP enlace esclavo Un enlace alternativo en un grupo de enlaces definido por el enlace maestro. .TP 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. .TP 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. . .SH ÓRDENES .TP \fB\-\-install\fP \fIenlace nombre ruta prioridad\fP [\fB\-\-slave\fP \fIenlace nombre ruta\fP] ... Añade un grupo de alternativas al sistema. \fIenlace\fP es el nombre genérico del enlace maestro, \fInombre\fP es el nombre del enlace simbólico en el directorio de alternativas, y \fIruta\fP es la alternativa que se va a introducir para el enlace maestro. Los argumentos a continuación de \fB\-\-slave\fP 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 \fB\-\-slave\fP, 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 \fB\-\-force\fP. .IP 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. .TP \fB\-\-set\fP \fInombre ruta\fP Define la \fIruta\fP del programa como alternativa para \fInombre\fP. Equivale a \fB\-\-config\fP pero no es interactivo, de modo que permite su inclusión en scripts. .TP \fB\-\-remove\fP \fInombre ruta\fP Elimina una alternativa y todos sus enlaces esclavos asociados. \fInombre\fP es el nombre en el directorio de alternativas y \fIruta\fP es el nombre absoluto del fichero al que \fInombre\fP se podría enlazar. Si \fInombre\fP está en realidad enlazado a \fIruta\fP, \fInombre\fP 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 \fIruta\fP, no se cambia ningún enlace, sólo se elimina la información acerca de la alternativa. .TP \fB\-\-remove\-all\fP \fInombre\fP Elimina todas las alternativas y todos sus enlaces esclavos asociados. \fInombre\fP es un nombre en el directorio de alternativas. .TP \fB\-\-all\fP Ejecuta \fB\-\-config\fP sobre todas las alternativas. Puede ser útil en combinación con \fB\-\-skip\-auto\fP 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 \fByes \[aq]\[aq] | update\-alternatives \-\-force \-\-all\fP. .TP \fB\-\-auto\fP \fInombre\fP Cambia el grupo de enlaces dependientes de la alternativa \fInombre\fP 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. .TP \fB\-\-display\fP \fInombre\fP 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. .TP \fB\-\-get\-selections\fP 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). .TP \fB\-\-set\-selections\fP Lee la configuración de alternativas por la entrada estándar en el formato generado por \fBupdate\-alternatives \-\-get\-selections\fP y los reconfigura apropiadamente. .TP \fB\-\-query\fP \fInombre\fP 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 \fBFORMATO DE CONSULTA\fP más abajo). .TP \fB\-\-list\fP \fIname\fP Muestra todos los objetivos del grupo de enlaces. .TP \fB\-\-config\fP \fInombre\fP Muestra las alternativas disponibles para un grupo de enlaces y permite al usuario seleccionar interactivamente cual usar. El grupo de enlaces se actualizará. .TP \fB\-\-help\fP Muestra el modo de uso y termina. .TP \fB\-\-version\fP Muestra la versión y termina. . .SH OPCIONES .TP \fB\-\-altdir\fP \fIdirectorio\fP Define el directorio de alternativas, cuando es diferente del directorio por omisión. .TP \fB\-\-admindir\fP\fI directorio\fP Define el directorio administrativo, cuando es diferente del directorio por omisión. .TP \fB\-\-log=\fP\fIfichero\fP Define el fichero de registro de alternativas cuando es diferente del valor por omisión («/var/log/alternativas.log»). .TP \fB\-\-force\fP Permite que \fBupdate\-alternatives\fP reemplace u omita cualquier fichero real instalado en la misma ubicación donde se va a instalar o eliminar un enlace alternativo. .TP \fB\-\-skip\-auto\fP Omite el dialogo de configuración de alternativas para aquellas configuradas adecuadamente en modo automático. Esta opción solo tiene sentido con \fB\-\-config\fP o \fB\-\-all\fP. .TP \fB\-\-verbose\fP Genera una salida con más información acerca de lo que \fBupdate\-alternatives\fP está haciendo. .TP \fB\-\-quiet\fP No genera ningún comentario a menos que ocurra algún error. . .SH "ESTADOS DE SALIDA" .TP \fB0\fP La acción requerida finalizó con éxito. .TP \fB2\fP Se encontraron problemas analizando la línea de órdenes o realizando la acción requerida. . .SH ENTORNO .TP \fBDPKG_ADMINDIR\fP Si se define, y no se define la opción \fB\-\-admindir\fP, se utiliza como el directorio base de gestión. . .SH FICHEROS .TP \fI/etc/alternatives/\fP El directorio de alternativas por omisión. Se puede cambiar con la opción \fB\-\-altdir\fP. .TP \fI/var/lib/dpkg/alternatives/\fP El directorio de administración por omisión. Se puede modificar con la opción \fB\-\-admindir\fP. . .SH "FORMATO DE CONSULTA" El formato de consulta de \fBupdate\-alternatives \-\-query\fP utiliza un formato simple de tipo RFC822. Se compone de \fIn\fP + 1 bloques, donde \fIn\fP es el número de alternativas disponibles en el grupo de enlaces consultado. El primer bloque contiene los siguientes campos: .TP \fBName:\fP\fI nombre\fP El nombre de la alternativa en el directorio de alternativas. .TP \fBLink:\fP\fI enlace\fP El nombre genérico de la alternativa. .TP \fBSlaves:\fP\fI lista de esclavos\fP Cuando este campo está presente, las líneas \fBsiguientes\fP 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. .TP \fBStatus:\fP\fI estado\fP El estado de la alternativa (\fBauto\fP o \fBmanual\fP). .TP \fBBest:\fP\fI mejor\-opción\fP La ruta de la mejor alternativa para este grupo de enlaces. No aparece si no existen alternativas disponibles. .TP \fBValue:\fP\fI alternativa\-seleccionada\-actualmente\fP La ruta de la alternativa seleccionada en ese momento. También puede tomar el valor mágico \fBnone\fP (ninguno). Se usa si el enlace no existe. .TP .TP Los siguientes bloques describen las alternativas disponibles en el grupo de enlaces consultado: .TP \fBAlternative:\fP\fI ruta\-a\-esta\-alternativa\fP Ruta a la alternativa de este bloque. .TP \fBPriority:\fP\fI valor\-de\-prioridad\fP Valor de la prioridad de esta alternativa. .TP \fBSlaves:\fP\fI lista de esclavos\fP When this field is present, the \fBnext\fP 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. . .TP \fBEjemplo\fP .nf $ 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 .fi . .SH DIAGNÓSTICOS Con la opción \fB\-\-verbose\fP, \fBupdate\-alternatives\fP informa detalladamente acerca de sus actividades por la salida estándar. Si ocurre algún problema, \fBupdate\-alternatives\fP 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. . .SH EJEMPLOS Hay varios paquetes que proporcionan un editor de texto compatible con \fBvi\fP, por ejemplo \fBnvi\fPy \fBvim\fP. El grupo de enlaces \fBvi\fP selecciona cual se usa, incluyendo enlaces para el programa y la página del manual asociada. .PP Utilice la opción \fB\-\-display\fP para mostrar los paquetes disponibles que proporcionan \fBvi\fP y su configuración actual: .RS .PP \fBupdate\-alternatives \-\-display vi\fP .RE .PP Para elegir una implementación de \fBvi\fP en particular use la siguiente orden como el usuario «root» y seleccione un número de la lista: .RS .PP \fBupdate\-alternatives \-\-config vi\fP .RE .PP Para que la implementación de \fBvi\fP se vuelva a elegir de forma automática, haga como administrador: .RS .PP \fBupdate\-alternatives \-\-auto vi\fP .RE . .SH "VÉASE TAMBIÉN" \fBln\fP(1), FHS, el estándar de la jerarquía del sistema de ficheros. .SH TRADUCTOR Rudy Godoy , Rubén Porras , Bruno Barrera C. , Carlos Izquierdo , Esteban Manchado y NOK. Debian L10n Spanish . .br Revisiones por Santiago Vila , Javier Fernández\-Sanguino, Rubén Porras, Luis Uribe y Omar Campagne.