path: root/man/pt/update-alternatives.pod

        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOME

update-alternatives - mantém links simbólicos que determinam os comandos
predefinidos

=head1 SINOPSE

B<update-alternatives> [I<option>...] I<command>

=head1 DESCRIÇÃO

B<update-alternatives> cria, remove, mantêm e mostra informação acerca dos
links simbólicos que abrangem o sistema de alternativos de Debian.

É 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 de Debian 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
B<ed>(1)  e B<nvi>(1)  estiverem ambos instalados no sistema, o sistema de
alternativas irá fazer com que o nome genérico I</usr/bin/editor> se refira
a I</usr/bin/nvi> por predefinição. O administrador do sistema pode sobrepor
isto e fazê-lo referir-se a I</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 I<directório>
I<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
I<%CONFDIR%>: 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 B<update-alternatives>
é chamado para actualizar a informação sobre esse ficheiro no sistema de
alternativas. O B<update-alternatives> é geralmente chamado a partir dos
seguintes scripts de maintainer de pacote Debian, B<postinst> (configurar)
para instalar a alternativa e a partir de B<prerm> e B<postrm> (remover)
para remover a alternativa.  B<Nota:> na maioria dos casos (se não todos)
nenhuma outra acção de script de maintainer deverá chamar
B<update-alternatives>, em particular nenhum de B<upgrade> nem B<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 B<vi>(1), o manual referenciado por
I</usr/share/man/man1/vi.1> deve corresponder ao executável referenciado por
I</usr/bin/vi>. B<update-alternatives> lida com isto por meio de  links
I<master> e I<slave>; quando o mestre é mudado, quaisquer slaves associados
são também mudados. Um link mestre e os seus slaves associados fazem um
I<group> de I<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
B<update-alternatives> correr no grupo de links alterado, e o grupo será
automaticamente comutado para modo manual.

Cada alternativa tem uma I<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 B<--config>, o B<update-alternatives> irá listar todas
as opções para o grupo de links do qual o I<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 I<auto>. Você precisa
usar a opção B<--auto> de modo a regressar ao modo automático (ou pode
voltar a correr B<--config> e escolher a entrada marcada como automática).

Se desejar configurar não interactivamente, em vez disto pode usar a opção
B<--set> (veja em baixo).

Pacotes diferentes que forneçam o mesmo ficheiro precisam de fazê-lo
B<cooperativamente>. Por outras palavras, o uso de B<update-alternatives> é
B<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
B<update-alternatives>.

=head1 TERMINOLOGIA

Como as actividades de B<update-alternatives> estão bastante envolvidas,
alguns termos específicos irão ajudar a explicar a sua operação.

=over 

=item nome genérico (ou link alternativo)

Um nome, como I</usr/bin/editor>, o qual refere, via sistema de
alternativos, a um de um número de ficheiros de função semelhante.

=item nome alternativo

O nome do links simbólico no directório de alternativos.

=item 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.

=item directório de alternativos

Um directório, por predefinição I<%CONFDIR%/alternatives>, que contém os
links simbólicos.

=item directório administrativo

Um directório, por predefinição I<%ADMINDIR%/alternatives>, que contém
informações de estado do B<update-alternatives>.

=item grupo de links

Um conjunto de links simbólicos relacionados, destinados a serem
actualizados como um grupo.

=item link mestre

O link alternativo num grupo de links que determina como os outros links no
grupo são configurados.

=item link escravo

Um link alternativo num grupo de links que é controlado pela definição do
link mestre.

=item 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.

=item 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.

=back

=head1 COMANDOS

=over 

=item B<--install> I<link name path priority> [B<--slave> I<link name path>]...

Adiciona um grupo de alternativas ao sistema. I<link> é o nome genérico para
o link mestre, I<name> é o nome do seu link simbólico no directório de
alternativas, e I<path> é a alternativa a ser introduzida para o link
mestre. Os argumentos após B<--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 B<--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 B<--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.

=item B<--set> I<name path>

Define o programa I<path> como alternativa para I<name>. Isto é equivalente
a B<--config> mas não é interactivo e assim apropriado para usar em scripts.

=item B<--remove> I<name path>

Remove uma alternativa e todos os seus links slave associados. I<name> é um
nome no directório de alternativas, e I<path> é um nome de ficheiro absoluto
para o qual I<name> poderá estar vinculado. Se I<name> está de facto
vinculado a I<path>, I<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 I<path>, nenhum link é alterado, apenas é
removida a informação sobre a alternativa.

=item B<--remove-all> I<name>

Remove todos os alternativos e todos os seus links escravos
associados. I<name> é um nome no directório de alternativos.

=item B<--all>

Chama  B<--config> em todas as alternativas. Pode ser útil combinado com
B<--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 B<yes '' | update-alternatives --force --all>.

=item B<--auto> I<name>

Comuta o grupo de link por detrás da alternativa para I<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.

=item B<--display> I<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.

=item B<--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 B<auto> ou B<manual>), e o último
contem a escolha actual na alternativa (cuidado: é um nome de ficheiro, e
pode conter espaços).

=item B<--set-selections>

Lê a configuração de alternativas na entrada standard no formato gerado por
B<--get-selections> e reconfigura-as adequadamente (desde versão 1.15.0).

=item B<--query> I<name>

Mostra informação acerca do grupo link como o B<--display> faz mas num modo
analisável por máquina (desde versão 1.15.0, Veja secção B<FORMATO DE
CONSULTA> abaixo.

=item B<--list> I<name>

Mostra todas as metas do grupo de links.

=item B<--config> I<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.

=item B<--help>

Mostra a mensagem de utilização e termina.

=item B<--version>

Mostra a versão e termina.

=back

=head1 OPÇÕES

=over 

=item B<--altdir> I<directory>

Especifica o directório alternativo, quando é suposto este ser diferente do
predefinido. A predefinição é «I<%CONFDIR%/alternatives>».

=item B<--admindir> I<directory>

Especifica o directório administrativo, quando este deve ser diferente do
predefinido. A predefinição é «I<%ADMINDIR%/alternatives>»

=item B<--instdir> I<directory>

Especifica o directório de instalação onde os links alternativos serão
criados (desde versão 1.20.1). A predefinição é «».

=item B<--root> I<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 é «».

=item B<--log> I<file>

Especifica o ficheiro de relatório (desde a versão 1.15.0), quando este é
suposto ser diferente do predefinido (%LOGDIR%/alternatives.log).

=item B<--force>

Permite substituir ou largar qualquer ficheiro real que está instalado
quando um link alternativo tem de ser instalado ou removido.

=item B<--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 B<--config> ou B<--all>.

=item B<--quiet>

Não gera nenhuns comentários, a menos que ocorram erros.

=item B<--verbose>

Gera mais comentários acerca do que está a ser feito.

=item B<--debug>

Gera ainda mais comentários, úteis para depuração, acerca do que está a ser
feito (desde versão 1.19.3).

=back

=head1 ESTADO À SAÍDA

=over 

=item B<0>

A acção requisitada foi executada com sucesso.

=item B<2>

Foram encontrados problemas ao analisar a linha de comandos ou ao executar a
acção.

=back

=head1 AMBIENTE

=over 

=item B<DPKG_ADMINDIR>

Se definido e se a opção B<--admindir> não foi especificada, será usado como
o directório administrativo base.

=back

=head1 FICHEIROS

=over 

=item I<%CONFDIR%/alternatives/>

O directório de alternativas predefinido. Pode ser sobreposto pela opção
B<--altdir>.

=item I<%ADMINDIR%/alternatives/>

O directório de administração predefinido. Pode ser sobreposto pela opção
B<--admindir>.

=back

=head1 FORMATO DE CONSULTA

O formato B<--query> está a usar um formato liso tipo RFC822. É composto de
I<n> blocos + 1 onde I<n> é o número e alternativas disponíveis no grupo de
link questionado. O primeiro bloco contem os seguintes campos:

=over 

=item B<Name:> I<name>

O nome alternativo no directório alternativo.

=item B<Link:> I<link>

O nome genérico da alternativa.

=item B<Slaves:> I<list-of-slaves>

Quando este campo está presente, as B<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.

=item B<Status:> I<status>

O estado da alternativa (B<auto> ou B<manual>).

=item B<Best:> I<best-choice>

O caminho da melhor alternativa para este grupo de links. Não presente se
não existirem alternativas disponíveis.

=item B<Value:> I<currently-selected-alternative>

O caminho da alternativa selecciona actualmente. Também pode tirar o valor
mágico B<none>. É usado quando o link não existe.

=back

Os outros blocos descrevem as alternativas disponíveis no grupo de links
questionado.

=over 

=item B<Alternative:> I<path-of-this-alternative>

Caminho para a alternativa deste bloco.

=item B<Priority:> I<priority-value>

Valor da prioridade desta alternativa.

=item B<Slaves:> I<list-of-slaves>

Quando este campo está presente, as B<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.

=back

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

=head1 DIAGNÓSTICO

Com B<--verbose> o B<update-alternatives> fala incessantemente acerca das
sua actividades no seu canal de saída standard. Se ocorrerem problemas, o
B<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.

=head1 EXEMPLOS

Existem vários pacotes que fornecem um editor de texto compatível com o
B<vi>, por exemplo e B<nvi> e o B<vim>. Qual deles é o usado é controlado
pelo grupo de links B<vi>, que inclui links para o próprio programa e o
manual associado.

Para mostrar os pacotes disponíveis que fornecem o B<vi> e a configuração
actual para ele, use a acção B<--display>.

=over 

 update-alternatives --display vi

=back

Para escolher uma implementação particular do B<vi>, use este comando como
root e depois seleccione um número da lista.

=over 

 update-alternatives --config vi

=back

Para voltar atrás e ter a implementação B<vi> escolhida automaticamente,
faça isto como root:

=over 

 update-alternatives --auto vi

=back

=head1 VEJA TAMBÉM

B<ln>(1), FHS (o Standard de Hierarquia de Sistema de Ficheiros).


=head1 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>.