
        *****************************************************
        *           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

dpkg-divert - sobrepõe a versão de pacote de um ficheiro

=head1 SINOPSE

B<dpkg-divert> [I<option>...] I<command>

=head1 DESCRIÇÃO

B<dpkg-divert> é o utilitário usado para definir e actualizar a lista de
desvios.

I<diversions> de ficheiros são um modo de forçar o B<dpkg>(1)  a não
instalar um ficheiro na sua localização, mas numa localização
I<desviada>. Estes desvios podem ser usados através dos scripts de pacote
Debian para afastar um ficheiro quando este causa um conflito. Os
administradores de sistemas também o podem usar para sobrepor ficheiros de
configuração de alguns pacotes, ou sempre que alguns ficheiros (que não
sejam marcados como “conffiles”) precisam de ser conservados pelo B<dpkg>,
quando instala uma versão mais recente do pacote que contém esses ficheiros.

=head1 COMANDOS

=over 

=item [B<--add>] I<file>

Adiciona um desvio para I<file>. Este ficheiro é actualmente não renomeado,
veja B<--rename>.

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

Remove um desvio para I<file>. Este ficheiro é actualmente não renomeado,
veja B<--rename>.

=item B<--list> I<glob-pattern>

Lista desvios que correspondem a I<glob-pattern>.

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

Escreve o nome do pacote que desvia I<file> (desde dpkg 1.15.0).  Escreve
LOCAL se I<file> é desviado localmente e nada se I<file> não é desviado.

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

Escreve o nome real para um ficheiro desviado.

=back

=head1 OPÇÕES

=over 

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

Define o directório administrativo para I<directory>. A predefinição é
«I<%ADMINDIR%>».

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

Define o directório de instalação, o qual se refere ao directório onde os
pacotes são instalados (desde dpkg 1.19.2). A predefinição é «I</>».

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

Define o directório raiz para B<directory>, o que define o directório de
instalação para «I<directory>» e o directório administrativo apara
«I<directory>B<%ADMINDIR%>» (desde dpkg 1.19.2).

=item B<--divert> I<divert-to>

I<divert-to> é a localização para onde as versões de I<file>, como fornecido
por outros pacotes, serão desviadas.

=item B<--local>

Especifica que todas as versões de pacotes deste ficheiro são
desviadas. Isto significa, que não há excepções, e seja em que pacote esteja
instalado, o ficheiro é desviado. Isto pode ser usado pro uma administrador
para instalar uma versão modificada localmente.

=item B<--package> I<package>

I<package> é o nome do pacote cuja cópia de I<file> não será desviada. Isto
é, I<file> será desviado para todos os pacotes excepto I<package>.

=item B<--quiet>

Modo silencioso, isto é, não há resultados detalhados.

=item B<--rename>

Actualmente mete o ficheiro de lado (ou para trás). B<dpkg-divert> irá
abortar a operação no caso do ficheiro de destino já existir. Este é o
comportamento comum usado para desvios de ficheiros de um conjunto de
pacotes não-B<Essential> (veja B<--no-rename> para mais detalhes).

=item B<--no-rename>

Especifica que o ficheiro não deve ser renomeado enquanto se adiciona ou
remove o desvio na base de dados (desde dpkg 1.19.1). Isto destina-se a
desvios de ficheiros do conjunto de pacotes B<Essential>, onde o
desaparecimento temporário do ficheiro original não é aceitável, pois pode
tornar o sistema não-funcional. Este é o comportamento predefinido, mas isso
irá mudar no ciclo dpkg 1.20.x.

=item B<--test>

Modo de teste, isto é, não faz realmente nenhumas alterações, apenas uma
demonstração.

=item B<-?>, B<--help>

Mostra a mensagem de utilização e termina.

=item B<--version>

Mostra a versão e termina.

=back

=head1 ESTADO À SAÍDA

=over 

=item B<0>

A acção requisitada foi executada com sucesso.

=item B<2>

Erro fatal ou irrecuperável devido a utilização de linha de comandos
inválida, ou interações com o sistema, tais como acesso à base de dados,
alocações de memória, etc.

=back

=head1 AMBIENTE

=over 

=item B<DPKG_ROOT>

Se definido e as opções B<--instdir> ou B<--root> não foram especificadas,
será usado como o directório raiz do sistema de ficheiros (desde dpkg
1.19.2).

=item B<DPKG_ADMINDIR>

Se definido e as opções B<--admindir> ou B<--root> não foram especificadas,
será usado como o directório de dados do B<dpkg>.

=item B<DPKG_MAINTSCRIPT_PACKAGE>

Se definido e as opções B<--local> e B<--package> não foram especificadas,
B<dpkg-divert> irá usá-lo como o nome do pacote.

=item B<DPKG_COLORS>

Define o modo de cor (desde dpkg 1.18.5). Os valores actualmente aceites
são: B<auto> (predefinido), B<always> e B<never>.

=back

=head1 FICHEIROS

=over 

=item I<%ADMINDIR%/diversions>

Ficheiro que contém a lista actual das divergências do sistema. Está
localizado no directório de administração do B<dpkg>, juntamente com outros
ficheiros importantes para o B<dpkg>, tais como <estado> ou I<disponível>.

B<Nota:> O B<dpkg-divert> preserva uma cópia antiga deste ficheiro, com a
extensão I<-old>, antes do o substituir pelo novo.

=back

=head1 NOTAS

Quando adiciona, a predefinição é B<--local> e B<--divert>
I<original>B<.distrib>. Quando remove, B<--package> ou B<--local> e
B<--divert> tem de corresponder se for especificado.

Os directórios não podem ser desviados com B<dpkg-divert>.

Deve tomar-se cuidado ao desviar bibliotecas partilhadas, B<ldconfig>(8)
cria um link simbólico baseado no campo DT_SONAME embebido na
biblioteca. Devido a B<ldconfig> não honrar desvios (apenas B<dpkg> o faz),
o link simbólico pode acabar a apontar para a biblioteca desviada, se uma
biblioteca desviada tiver o mesmo SONAME que a não desviada.

=head1 EXEMPLOS

Para desviar todas as cópias de um I</usr/bin/example> para
I</usr/bin/example.foo>, isto é, direcciona todos os pacotes que fornecem
I</usr/bin/example> para o instalar como I</usr/bin/example.foo>, executando
a mudança de nome caso necessário:

 dpkg-divert --divert /usr/bin/example.foo --rename /usr/bin/example

Para remover esse desvio:

 dpkg-divert --rename --remove /usr/bin/example

Para desviar qualquer pacote que tente instalar I</usr/bin/example> para
I</usr/bin/example.foo>, excepto o seu próprio pacote I<wibble>:

 dpkg-divert --package wibble --divert /usr/bin/example.foo \
    --rename /usr/bin/example

Para remover esse desvio:

 dpkg-divert --package wibble --rename --remove /usr/bin/example

=head1 VEJA TAMBÉM

B<dpkg>(1).


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