Provided by: dpkg_1.22.6ubuntu6.1_amd64 bug

NOME

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

RESUMO

       dpkg-divert [option...] command

DESCRIÇÃO

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

       diversions de ficheiros são um modo de forçar o dpkg(1) a não instalar um ficheiro na sua
       localização, mas numa localização desviada. Estes desvios podem ser usados através dos
       scripts de maintainer de pacote 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 dpkg, quando instala uma versão mais recente do pacote
       que contém esses ficheiros.

COMANDOS

       [--add] file
           Adiciona um desvio para file. Este ficheiro é actualmente não renomeado, veja
           --rename.

       --remove file
           Remove um desvio para file. Este ficheiro é actualmente não renomeado, veja --rename.

       --list [glob-pattern]
           Lista todos os desvios, ou os que correspondem a glob-pattern.

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

       --truename file
           Escreve o nome real para um ficheiro desviado.

OPÇÕES

       --admindir directory
           Define o directório administrativo para directory. A predefinição é «/var/lib/dpkg» se
           DPKG_ADMINDIR não estiver definido.

       --instdir directory
           Define o directório de instalação, o que se refere ao directório onde os pacotes são
           instalados (desde dpkg 1.19.2). A predefinição é «/» se DPKG_ROOT não estiver
           definido.

       --root directory
           Define o directório raiz para directory, o que define o directório de instalação para
           «directory» e o directório administrativo para «directory/var/lib/dpkg» (desde dpkg
           1.19.2) se DPKG_ROOT não estiver definido.

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

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

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

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

       --rename
           Actualmente mete o ficheiro de lado (ou para trás). 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-Essential (veja --no-rename para
           mais detalhes).

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

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

       -?, --help
           Mostra a mensagem de utilização e termina.

       --version
           Mostra a versão e termina.

ESTADO À SAÍDA

       0   A acção requisitada foi executada com sucesso.

       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.

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 (desde dpkg 1.19.2).

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

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

       DPKG_DEBUG
           Define a máscara de depuração (desde dpkg 1.21.10) a partir dum valor octal. As
           bandeiras presentemente aceites estão descritas na opção dpkg --debug, mas nem todas
           estas bandeiras podem ter um efeito neste programa.

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

FICHEIROS

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

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

NOTAS

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

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

       Deve tomar-se cuidado ao desviar bibliotecas partilhadas, ldconfig(8) cria um link
       simbólico baseado no campo DT_SONAME embebido na biblioteca. Devido a ldconfig não honrar
       desvios (apenas 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.

EXEMPLOS

       Para desviar todas as cópias de um /usr/bin/example para /usr/bin/example.foo, isto é,
       direciona todos os pacotes que fornecem /usr/bin/example para o instalar como
       /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 /usr/bin/example para
       /usr/bin/example.foo, excepto o seu próprio pacote 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

VEJA TAMBÉM

       dpkg(1).

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