DESCRIO
O arquivo de preferncias do APT /etc/apt/preferences pode ser usado
para controlar quais verses de pacotes sero selecionadas para instalao.
Diversas verses de um pacote podem estar disponveis para instalao
quando o arquivo sources.list(5) contm referncias para mais de uma dis-
tribuio (por exemplo, stable e testing). O APT atribui uma prioridade
para cada verso que esteja disponvel. Sujeito a obstculos de depend-
ncias, o apt-get seleciona para instalao a verso com a maior priori-
dade. O arquivo de preferncias do APT sobrepoe as prioridades que o
APT atribui a cada verso de pacote por padro, dando assim ao usurio
controle sobre qual verso do pacote selecionada para instalao.
Diversas instncias da mesma verso de um pacote pode estar disponveis
quando o arquivo sources.list(5) contm referncias a mais de uma fonte.
Nesse caso, o apt-get faz o download da instncia listada antes no
arquivo sources.list(5) . O arquivo de preferncias do APT no afeta a
escolha da instncia.
ATRIBUIES DE PRIORIDADE PADRO DO APT
Caso no exista um arquivo de preferncias ou caso no exista uma entrada
no arquivo que se aplique a uma instncia em particular, a prioridade
atribuda a essa instncia a prioridade da distribuio para a qual a
instncia pertence. possvel selecionar uma distribuio, conhecida como
"a verso alvo" (the target release), que recebe uma prioridade maior do
que as outras distribuies. A verso alvo pode ser definida na linha de
comando do apt-get ou no arquivo de configurao do APT
/etc/apt/apt.conf. Por exemplo,
apt-get install -t testing algum-pacote
APT::Default-Release "stable";
Caso uma verso alvo tenha sido especificada o APT usar o seguinte algo-
ritmo para definir as prioridades das instncias de um pacote. Atribuir
:
prioridade 100
para a instncia que j esteja instalada (caso exista).
prioridade 500
para as instncias que no est instaladas e que no pertencem a
verso alvo.
prioridade 990
para as instncias que no estejam instaladas e pertenam a verso
alvo.
Caso nenhuma verso alvo tenha sido especificada, o APT simplesmente ir
atribuir a prioridade 100 para todas as instncias de pacotes instaladas
e a prioridade 500 para todas as instncias de pacotes no instaladas.
o Caso duas ou mais instncias possuam a mesma prioridade e nmero de
verso mas os pacotes sejam diferentes em alguns de seus metadados ou
a opo --reinstall seja fornecida, instala aquela desinstalada.
Em uma situao tpica, a instncia instalada de um pacote (prioridade 100)
no to recente quanto uma das verses disponveis nas fontes listadas no
arquivo sources.list(5) (prioridade 500 ou 990). Ento o pacote ser
atualizado quando os comandos apt-get install algum-pacote ou apt-get
dist-upgrade forem executados.
Mais raramente, a verso instalada de um pacote mais recente do que
qualquer uma das outras verses disponveis. O dowgrade do pacote no ser
feito quando os comandos apt-get install algum-pacote ou apt-get
upgrade forem executados.
Algumas vezes a verso instalada de um pacote mais recente que a verso
que pertence a verso alvo, mas no to recente quanto a verso que per-
tence a alguma outra distribuio. Um pacote como esse ser na verdade
atualizado quando os comandos apt-get install algum-pacote ou apt-get
upgrade forem executados, devido a pelo menos uma das verses disponveis
possuir uma prioridade maior do que a verso instalada.
O EFEITO DAS PREFERNCIAS DO APT
O arquivo de preferncias do APT permite ao administrador do sistema
personalizar prioridades. O arquivo consiste de um ou mais registros de
mltiplas linhas separados por linhas em branco. Registros podem possuir
uma das duas formas, uma forma especfica e uma forma geral.
o A forma especfica atribui uma uma prioridade (uma "Pin-Priority")
para um pacote e verso ou faixa de verso especificados. Por exemplo,
o registro a seguir atribui uma prioridade alta para todas as verses
do pacote perl os quais tenham seus nmeros de verso iniciando com
"5.8".
Package: perl
Pin: version 5.8*
Pin-Priority: 1001
o O forma geral atribui uma prioridade para todas as verses de pacotes
em uma dada distribuio (isto , para toda as verses de pacotes que
estejam em um certo arquivo Release) ou para todas as verses de
pacotes que provenientes de um site Internet em particular, como
identificado pelo nome de domnio totalmente qualificado do site
Internet.
Essa entrada de forma geral no arquivo de preferncias do APT aplica-
se somente a grupos de pacotes. Por exemplo, o registro a seguir faz
com que o APT atribua uma prioridade alta para todas as verses de
pacotes disponveis no site local.
Package: *
Package: *
Pin: release a=unstable
Pin-Priority: 50
O registro a seguir atribui uma prioridade alta para todas as verses
de pacotes que pertenam a qualquer verso cujo nome do Repositrio seja
"stable" e cujo nmero de verso seja "3.0".
Package: *
Pin: release a=unstable, v=3.0
Pin-Priority: 50
COMO O APT INTERPRETA PRIORIDADES
Prioridades (P) atribudas no arquivo de preferncias do APT devem ser
nmeros inteiros positivos ou negativos. Eles so interpretados como a
seguir (a grosso modo):
P > 1000
faz com que uma instncia seja instalada mesmo caso isso consti-
tua um dowgrade do pacote
990 < P <=1000
faz com que uma verso seja instalada mesmo caso a mesma no venha
de uma verso alvo, a menos que a verso instalada seja mais
recente
500 < P <=990
faz com que uma verso seja instalada a menos que exista uma
verso disponvel pertencente a verso alvo ou a verso instalada
seja mais recente
100 < P <=500
faz com que uma verso seja instalada a menos que exista uma
verso disponvel pertencente a alguma outra distribuio ou a verso
instalada seja mais recente
0 <= P <=100
faz com que uma verso seja instalada somente caso no exista uma
verso instalada do pacote
P < 0 impede a verso de ser instalada
Caso um dos registro de forma especfica descritos acima case (match)
com uma verso disponvel do pacote ento o primeiro desses registros
encontrados determinar a prioridade da verso do pacote. Na falha desse
cenrio, caso quaisquer registros de forma genrica casem (match) com uma
verso do pacote disponvel ento o primeiro desses registros encontrado
determinar a prioridade da verso do pacote.
Por exemplo, suponha que o arquivo de preferncias do APT contenha os
trs registros apresentados anteriormente :
que esse nmero de verso da verso inicie com "5.8". Caso qualquer
verso 5.8* de perl esteja disponvel e a verso instalada seja 5.9*,
ser feito um downgrade do perl.
o Uma verso de qualquer pacote diferente de perl que esteja disponvel
no sistema local possui prioridade sobre outras verses, mesmo verses
pertencentes a verso alvo.
o Uma verso de um pacote cuja origem no seja o sistema local mas sim
algum outro site listado no arquivo sources.list(5) e que pertena a
uma distribuio unstable instalada somente caso a mesma seja sele-
cionada para instalao e nenhuma verso do pacote j esteja instalada.
DETERMINAO DA VERSO DO PACOTE E PROPRIEDADES DA DISTRIBUIO
As localidades listadas em um arquivo sources.list(5) devem fornecer
arquivos Packages e Release para descrever os pacotes disponveis nessas
localidades.
O arquivo Packages normalmente encontrado no diretrio .../dists/nome-
distribuio/componente/arquitetura : por exemplo, .../dists/sta-
ble/main/binary-i386/Packages. O arquivo consiste de uma srie de reg-
istros de mltiplas linhas, uma para cada pacote disponvel no diretrio.
Somente duas linhas em cada registro so relevantes para definir priori-
dades do APT :
a linha Package:
informa o nome do pacote
a linha Version:
informa o nmero de verso do pacote
O arquivo Release normalmente encontrado no diretrio .../dists/nome-
distribuio : por exemplo, .../dists/stable/Release, ou
.../dists/woody/Release. O arquivo consiste de um registro de mltiplas
linhas o qual se aplica a todos os pacotes na rvore de diretrios abaixo
de seu diretrio pai. Diferente do arquivo Packages, quase todas as lin-
has em um arquivo Release so relevantes para a definio de prioridades
do APT :
a linha Archive:
d nome ao repositrio para o qual todos os pacotes na rvore de
diretrio pertencem. Por exemplo, a linha "Archive: stable"
especifica que todos os pacotes na rvore de diretrio abaixo do
diretrio pai do arquivo Release esto no respositrio stable.
Especificar esse valor no arquivo de preferncias do APT iria
requerer a linha :
Pin: release a=stable
a linha Version:
d nome a verso da distribuio. Por exemplo, os pacote na rvore
podem pertencer a distribuio Debian GNU/Linux verso 3.0. Note
esto licenciadas sob os termos da Linhas Guias Debian para o
Software Livre (a DFSG). Especificar esse componente no arquivo
de preferncias do APT iria requerer a linha :
Pin: release c=main
a linha Origin:
d nome ao produtor dos pacotes na rvore de diretrio do arquivo
Release. O mais comum esse valor ser Debian. Especificar essa
origem no arquivo de preferncias do APT iria requerer a linha :
Pin: release o=Debian
a linha Label:
d nome ao rtulo (label) dos pacotes na rvore de diretrio. O mais
comum esse valor ser Debian. Especificar esse rtulo (label) no
arquivo de preferncias do APT iria requerer a linha :
Pin: release l=Debian
Todos os arquivos Packages e Release obtidos das localidades listadas
no arquivo sources.list(5) so mantidos no diretrio /var/lib/apt/lists
ou no arquivo indicado pela varivel Dir::State::Lists no arquivo
apt.conf. Por exemplo, o arquivo
debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release
contm o arquivo Release obtido do site debian.lcs.mit.edu para a
arquitetura binary-i386, arquivos do componente contrib da distribuio
unstable.
LINHAS OPCIONAIS EM UM REGISTRO DE PREFERNCIAS DO APT
Cada registro em um arquivo de preferncias do APT pode opcionalmente
iniciar com uma ou mais linhas iniciadas com a palavra Explanation:.
Isto oferece um local para inserir comentrios.
A linha Pin-Priority: em cada registro de preferncias do APT opcional.
Caso omitida, o APT atribuir uma prioridade de 1 menos o ltimo valor
especificado em uma linha iniciando com Pin-Priority: release ....
EXEMPLOS
ACOMPANHANDO A STABLE
O arquivo de preferncias do APT a seguir far com que o APT atribua uma
prioridade maior do que a prioridade padro (500) para todas as verses
de pacotes pertencentes a distribuio stable e uma prioridade proibiti-
vamente baixa para verses de pacotes pertencentes a outras distribuies
Debian.
Explanation: Desinstala ou no instala nenhuma verso de pacote originada
Explanation: do Debian a no ser aquelas na distribuio stable
Package: *
Pin: release a=stable
Pin-Priority: 900
novamente a menos que esse comando seja executado novamente.
apt-get install pacote/testing
ACOMPANHANDO A TESTING
O arquivo de preferncias do APT a seguir far com que o APT atribua uma
prioridade maior para verses de pacote da distribuio testing, uma pri-
oridade menor para verses de pacotes da distribuio unstable e uma pri-
oridade proibitivamente baixa para verses de pacotes de outras dis-
tribuies Debian.
Package: *
Pin: release a=testing
Pin-Priority: 900
Package: *
Pin: release a=unstable
Pin-Priority: 800
Package: *
Pin: release o=Debian
Pin-Priority: -10
Com um arquivo sources.list(5) adequado e o arquivo de preferncias do
APT acima, quaisquer dos comandos a seguir faro com que o APT atualize
para a(s) ltima(s) verso(es) testing.
apt-get install nome-pacote
apt-get upgrade
apt-get dist-upgrade
O comando a seguir far com que o APT atualize o pacote especificado
para a ltima verso da distribuio unstable. Assim, o comando apt-get
upgrade ir atualizar o pacote para a verso testing mais recente caso
essa verso seja mais recente que a verso instalada, caso no seja, o
pacote ser atualizado para a verso unstable mais recente caso a mesma
seja mais recente que a verso instalada.
apt-get install pacote/unstable
CONSULTE TAMBM
apt-get(8) apt-cache(8) apt.conf(5) sources.list(5)
BUGS
Consulte a pgina de bugs do APT <URL:http://bugs.debian.org/apt>. Caso
voc queira relatar um bug no APT, por favor consulte o arquivo
/usr/share/doc/debian/bug-reporting.txt ou o comando reportbug(1).
AUTHOR
O APT foi escrito pela equipe APT <apt@packages.debian.org>.
TRADUO
Man(1) output converted with
man2html