Provided by: dpkg_1.22.18ubuntu3_amd64 
NOME
update-alternatives - mantém links simbólicos que determinam os comandos predefinidos
RESUMO
update-alternatives [option...] command
DESCRIÇÃO
update-alternatives cria, remove, mantêm e mostra informação acerca dos links simbólicos que abrangem o
sistema de alternativos.
É possível para vários programas realizarem o mesmo ou funções semelhantes para serem instalados num
único sistema ao mesmo tempo. Por exemplo, muitos sistemas têm vários editores de texto instalados ao
mesmo tempo. Isto dá escolha aos utilizadores do sistema, permitindo que cada um use um editor diferente,
se o desejar, mas torna difícil para um programa fazer uma boa escolha no editor a invocar se o
utilizador não especificou a sua preferência particular.
O sistema de alternativas destina-se a resolver este problema. Um nome genérico no sistema de ficheiros é
partilhado por todos os ficheiros que fornecem funcionalidades intercambiáveis. O sistema de alternativas
e o administrador do sistema juntamente determinam qual ficheiro real é referenciado por este nome
genérico. Por exemplo, se os editores de texto ed(1) e nvi(1) estiverem ambos instalados no sistema, o
sistema de alternativas irá fazer com que o nome genérico /usr/bin/editor se refira a /usr/bin/nvi por
predefinição. O administrador do sistema pode sobrepor isto e fazê-lo referir-se a /usr/bin/ed em vez do
primeiro, e o sistema de alternativas não irá alterar esta definição até que lhe seja requerido
explicitamente fazê-lo.
O nome genérico não é um link simbólico directo para a alternativa selecionada. Em vez disso, é um link
simbólico para um nome no directório alternatives, o qual por sua vez é um link simbólico para o ficheiro
real referenciado. Isto é feito deste modo para que as alterações do administrador do sistema fiquem
confinadas dentro do directório /etc: a FHS (q.v.) explica o porquê isto ser uma Coisa Boa.
Quando cada pacote que fornece um ficheiro com uma determinada funcionalidade é instalado, modificado ou
removido, o update-alternatives é chamado para actualizar a informação sobre esse ficheiro no sistema de
alternativas. O update-alternatives é geralmente chamado a partir dos seguintes scripts de maintainer de
pacote Debian, postinst (configurar) para instalar a alternativa e a partir de prerm e postrm (remover)
para remover a alternativa. Nota: Na maioria dos casos (se não todos) nenhuma outra acção de script de
maintainer deverá chamar update-alternatives, em particular nenhum de upgrade nem disappear, pois outra
acção do tipo pode perder o estado manual da alternativa, ou fazer a alternativa inverter
temporariamente, ou comutar completamente quando várias têm a mesma prioridade.
Isto é muitas vezes útil para se sincronizar várias alternativas, para que sejam mudadas como um grupo;
por exemplo, quando estão instaladas várias versões do editor vi(1), o manual referenciado por
/usr/share/man/man1/vi.1 deve corresponder ao executável referenciado por /usr/bin/vi. update-
alternatives lida com isto por meio de links master e slave; quando o mestre é mudado, quaisquer slaves
associados são também mudados. Um link mestre e os seus slaves associados fazem um group de link.
Cada grupo de links é, a qualquer altura, em um ou dois modos: automático ou manual. Quando um grupo está
em modo automático, o sistema de alternativas irá decidir automaticamente, quando os pacotes são
instalados ou removidos, em como actualizar os links. Em modo manual, o sistema de alternativas irá reter
a escolha do administrador e evitar alterar os links (excepto quando algum quebrar).
Grupos de links ficam em modo automático quando são introduzidos pela primeira vez no sistema. Se o
administrador do sistema fizer alterações nas definições automáticas do sistema, isso será notificado na
próxima vez que o update-alternatives correr no grupo de links alterado, e o grupo será automaticamente
comutado para modo manual.
Cada alternativa tem uma priority associada. Quando um grupo de links está em modo automático, as
alternativas apontadas pelos membros do grupo serão aquelas que têm aprioridade mais alta.
Quando se usa a opção --config, o update-alternatives irá listar todas as opções para o grupo de links do
qual o nome dado é o nome alternativo mestre. A escolha actual é marcada com um ‘*’. Você será depois
questionado sobre a sua escolha em relação a este grupo de links. Dependendo da escolha feita, o grupo de
link pode não mais ficar em modo auto. Você precisa usar a opção --auto de modo a regressar ao modo
automático (ou pode voltar a correr --config e escolher a entrada marcada como automática).
Se desejar configurar não interactivamente, em vez disto pode usar a opção --set (veja em baixo).
Pacotes diferentes que forneçam o mesmo ficheiro precisam de fazê-lo cooperativamente. Por outras
palavras, o uso de update-alternatives é obrigatório para todos os pacotes envolvidos em tal caso. Não é
possível sobrepor qualquer ficheiro de um pacote em que não se empregue o mecanismo update-alternatives.
TERMINOLOGIA
Como as atividades de update-alternatives estão bastante envolvidas, alguns termos específicos irão
ajudar a explicar a sua operação.
nome genérico (ou link alternativo)
Um nome, como /usr/bin/editor, o qual refere, via sistema de alternativos, a um de um número de
ficheiros de função semelhante.
nome alternativo
O nome do links simbólico no directório de alternativos.
alternativo (ou caminho alternativo)
O nome de um ficheiro especifico no sistema de ficheiros, que pode ser tornado acessível via um nome
genérico usando o sistema de alternativos.
directório de alternativos
Um directório, por predefinição /etc/alternatives, que contém os links simbólicos.
directório administrativo
Um directório, por predefinição /var/lib/dpkg/alternatives, que contém informações de estado do
update-alternatives.
grupo de links
Um conjunto de links simbólicos relacionados, destinados a serem actualizados como um grupo.
link mestre
O link alternativo num grupo de links que determina como os outros links no grupo são configurados.
link escravo
Um link alternativo num grupo de links que é controlado pela definição do link mestre.
modo automático
Quando um grupo de links está em modo automático, o sistema de alternativas assegura que os links do
grupo apontam para a alternativa apropriada de prioridade mais alta para o grupo.
modo manual
Quando um grupo de links está em modo manual, o sistema de alternativas não irá fazer nenhumas
alterações às definições do administrador do sistema.
COMANDOS
--install link name path priority [--slave link name path]...
Adiciona um grupo de alternativas ao sistema. link é o nome genérico para o link mestre, name é o
nome do seu link simbólico no directório de alternativas, e path é a alternativa a ser introduzida
para o link mestre. Os argumentos após --slave são o ome genérico, nome do link simbólico no
directório de alternativas e o caminho alternativo para um link slave. Podem ser especificadas zero
ou mais opções --slave, cada uma seguida de três argumentos. Note que a alternativa mestre tem de
existir ou a chamada irá falhar. No entanto se uma alternativa slave não existir, o link de
alternativa slave correspondente simplesmente não irá ser instalado (mesmo assim é mostrado um
aviso). Se estiver instalado um ficheiro real no lugar onde um link simbólico deve ser instalado,
este é mantido a menos que seja usado --force.
Se o nome alternativo especificado já existir nos registos do sistema de alternativas, a informação
fornecida será adicionada como um novo conjunto de alternativas para o grupo. Caso contrário, será
adicionado um novo grupo, definido para modo automático, com esta informação. Se o grupo estiver em
modo automático, e as prioridade das alternativas recentes adicionadas é mais alta que as outras
alternativas instaladas para este grupo, os links simbólicos serão actualizados para apontarem às
novas alternativas adicionadas.
--set name path
Define o programa path como alternativa para name. Isto é equivalente a --config mas não é
interactivo e assim apropriado para usar em scripts.
--remove name path
Remove uma alternativa e todos os seus links slave associados. name é um nome no directório de
alternativas, e path é um nome de ficheiro absoluto para o qual name poderá estar vinculado. Se name
está de facto vinculado a path, name será actualizado para apontar para outra alternativa apropriada
(e o grupo é colocado de novo em modo automático), ou removido se não existir mais nenhuma
alternativa. Os links slave associados serão actualizados ou removidos, correspondentemente. Se o
link não está actualmente a apontar para path, nenhum link é alterado, apenas é removida a informação
sobre a alternativa.
--remove-all name
Remove todos os alternativos e todos os seus links escravos associados. name é um nome no directório
de alternativos.
--all
Chama --config em todas as alternativas. Pode ser útil combinado com --skip-auto para rever e
configurar todas as alternativas que não estão configuradas em modo automático. São também mostradas
as alternativas quebradas. Assim um modo simples de corrigir todas as alternativas quebradas é chamar
yes '' | update-alternatives --force --all.
--auto name
Comuta o grupo de link por detrás da alternativa para name para modo automático. No processo, o link
simbólico mestre e os seus slaves são actualizados par apontar para a alternativa instalada de
prioridade mais alta.
--display name
Mostra informação sobre o grupo de link. A informação ,mostrada inclui o modo do grupo (auto ou
manual), os links mestre e slave, a qual alternativa o link mestre presentemente aponta, que outras
alternativas estão disponíveis (a as suas alternativas slave correspondentes), e a alternativa de
prioridade mais alta presentemente instalada.
--get-selections
Lista todos os nomes de alternativa mestre (aqueles que controlam um grupo link) e os seus estados
(desde versão 1.15.0). Cada linha contém até 3 campos (separados por um ou mais espaços). O primeiro
campo é o nome da alternativa, o segundo é o estado (se auto ou manual), e o último contem a escolha
actual na alternativa (cuidado: é um nome de ficheiro, e pode conter espaços).
--set-selections
Lê a configuração de alternativas na entrada standard no formato gerado por --get-selections e
reconfigura-as adequadamente (desde versão 1.15.0).
--query name
Mostra informação acerca do grupo link como o --display faz mas num modo analisável por máquina
(desde versão 1.15.0, Veja secção "FORMATO DE CONSULTA" abaixo.
--list name
Mostra todas as metas do grupo de links.
--config name
Mostra as alternativas disponíveis para um grupo de links e permite ao utilizador seleccionar
interactivamente qual delas usar. O grupo de links é actualizado.
--help
Mostra a mensagem de utilização e termina.
--version
Mostra a versão e termina.
OPÇÕES
--altdir directory
Especifica o directório alternativo, quando é suposto este ser diferente do predefinido. A
predefinição é «/etc/alternatives».
--admindir directory
Especifica o directório administrativo, quando este deve ser diferente do predefinido. A predefinição
é «/var/lib/dpkg/alternatives» se DPKG_ADMINDIR não estiver definido.
--instdir directory
Especifica o directório de instalação onde os links alternativos serão criados (desde versão 1.20.1).
A predefinição é «/» se DPKG_ROOT não estiver definido.
--root directory
Especifica o directório raiz (desde 1.20.1). Isto também define alternativas, directórios de
instalação e administração para corresponder. A predefinição é «/» se DPKG_ROOT não estiver definido.
--log file
Especifica o ficheiro de relatório (desde a versão 1.15.0), quando este é suposto ser diferente do
predefinido (/var/log/alternatives.log).
--force
Permite substituir ou largar qualquer ficheiro real que está instalado quando um link alternativo tem
de ser instalado ou removido.
--skip-auto
Salta o aviso de configuração para alternativas que as quais já estão correctamente configuradas em
modo automático. Esta opção é apenas relevante com --config ou --all.
--quiet
Não gera nenhuns comentários, a menos que ocorram erros.
--verbose
Gera mais comentários acerca do que está a ser feito.
--debug
Gera ainda mais comentários, úteis para depuração, acerca do que está a ser feito (desde versão
1.19.3).
ESTADO À SAÍDA
0 A acção requisitada foi executada com sucesso.
2 Foram encontrados problemas ao analisar a linha de comandos ou ao executar a acção.
AMBIENTE
DPKG_ROOT
Se definido e as opções --instdir ou --root não foram especificadas, será usado como o directório
raiz do sistema de ficheiros.
DPKG_ADMINDIR
Se definido e se a opção --admindir não foi especificada, será usado como o directório administrativo
base.
FICHEIROS
/etc/alternatives/
O directório de alternativas predefinido. Pode ser sobreposto pela opção --altdir.
/var/lib/dpkg/alternatives/
O directório de administração predefinido. Pode ser sobreposto pela opção --admindir.
FORMATO DE CONSULTA
O formato --query está a usar um formato liso tipo RFC822. É composto de n estrofes + 1 onde n é o número
e alternativas disponíveis no grupo de link questionado. A primeira estrofe contem os seguintes campos:
Name: name
O nome alternativo no directório alternativo.
Link: link
O nome genérico da alternativa.
Slaves: list-of-slaves
Quando este campo está presente, as próximas linhas contêm todas os links escravos associados ao link
mestre da alternativa. Há um escravo por linha. Cada linha contem um espaço, o nome genérico da
alternativa escravo, outro espaço, e o caminho para o link escravo.
Status: status
O estado da alternativa (auto ou manual).
Best: best-choice
O caminho da melhor alternativa para este grupo de links. Não presente se não existirem alternativas
disponíveis.
Value: currently-selected-alternative
O caminho da alternativa seleciona actualmente. Também pode tirar o valor mágico none. É usado quando
o link não existe.
As outras estrofes descrevem as alternativas disponíveis no grupo de links questionado.
Alternative: path-of-this-alternative
Caminho para a alternativa desta estrofe.
Priority: priority-value
Valor da prioridade desta alternativa.
Slaves: list-of-slaves
Quando este campo está presente, as próximas linhas contêm todas as alternativas escravas associadas
ao link mestre da alternativa. Há um escrava por linha. Cada linha contem um espaço, o nome genérico
da alternativa escravo, outro espaço, e o caminho para a alternativa escravo.
Exemplo
$ 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
DIAGNÓSTICO
Com --verbose o update-alternatives fala incessantemente acerca das suas atividades no seu canal de saída
standard. Se ocorrerem problemas, o update-alternatives envia mensagens de erro no seu canal de erros
standard e retorna um estado de saída de 2. Estes diagnósticos deverão ser suficientemente explicativos,
se você acha que não o são, por favor reporte isso como um bug.
EXEMPLOS
Existem vários pacotes que fornecem um editor de texto compatível com o vi, por exemplo e nvi e o vim.
Qual deles é o usado é controlado pelo grupo de links vi, que inclui links para o próprio programa e o
manual associado.
Para mostrar os pacotes disponíveis que fornecem o vi e a configuração actual para ele, use a acção
--display.
update-alternatives --display vi
Para escolher uma implementação particular do vi, use este comando como root e depois selecione um número
da lista.
update-alternatives --config vi
Para voltar atrás e ter a implementação vi escolhida automaticamente, faça isto como root:
update-alternatives --auto vi
VEJA TAMBÉM
ln(1), FHS (o Standard de Hierarquia de Sistema de Ficheiros).
TRADUÇÃO
Américo Monteiro
Se encontrar algum erro na tradução deste documento, por favor comunique para Américo Monteiro
<a_monteiro@gmx.com>.
1.22.18 2025-04-28 update-alternatives(1)