Manpages

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.

File diversions are a way of forcing dpkg(1) not to install a file into its location, but to a diverted location. Diversions can be used through the package maintainer scripts to move a file away when it causes a conflict. System administrators can also use it to override some package’s configuration file, or whenever some files (which aren’t marked as “conffiles”) need to be preserved by dpkg, when installing a newer version of a package which contains those files.

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

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.

Care should be taken when diverting shared libraries, ldconfig(8) creates a symbolic link based on the DT_SONAME field embedded in the library. Because ldconfig does not honor diverts (only dpkg does), the symlink may end up pointing at the diverted library, if a diverted library has the same SONAME as the undiverted one.

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 [AT] gmx.com>.