1
.\" This manpage has been automatically generated by docbook2man
2
.\" from a DocBook document. This tool can be found at:
3
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
4
.\" Please send any bug reports, improvements, comments, patches,
5
.\" etc. to Steve Cheng <steve@ggi-project.org>.
6
.TH "APT_PREFERENCES" "5" "26 March 2005" "" ""
9
apt_preferences \- Arquivo de controle de prefer�ncias para o APT
12
O arquivo de prefer�ncias do APT \fI/etc/apt/preferences\fR
13
pode ser usado para controlar quais vers�es de pacotes ser�o
14
selecionadas para instala��o.
16
Diversas vers�es de um pacote podem estar dispon�veis para
17
instala��o quando o arquivo \fB\fIsources.list\fB\fR(5) cont�m refer�ncias para
18
mais de uma distribui��o (por exemplo, stable e
19
testing). O APT atribui uma prioridade para cada
20
vers�o que esteja dispon�vel. Sujeito a obst�culos de depend�ncias, o
21
\fBapt-get\fR seleciona para instala��o a vers�o com a
23
O arquivo de prefer�ncias do APT sobrepoe as prioridades que o APT
24
atribui a cada vers�o de pacote por padr�o, dando assim ao usu�rio
25
controle sobre qual vers�o do pacote � selecionada para instala��o.
27
Diversas inst�ncias da mesma vers�o de um pacote pode estar dispon�veis
28
quando o arquivo \fB\fIsources.list\fB\fR(5) cont�m refer�ncias a mais de uma fonte.
29
Nesse caso, o \fBapt-get\fR faz o download da inst�ncia
30
listada antes no arquivo \fB\fIsources.list\fB\fR(5) .
31
O arquivo de prefer�ncias do APT n�o afeta a escolha da inst�ncia.
32
.SS "ATRIBUI��ES DE PRIORIDADE PADR�O DO APT"
34
Caso n�o exista um arquivo de prefer�ncias ou caso n�o exista uma
35
entrada no arquivo que se aplique a uma inst�ncia em particular, a
36
prioridade atribu�da a essa inst�ncia � a prioridade da distribui��o
37
para a qual a inst�ncia pertence. � poss�vel selecionar uma distribui��o,
38
conhecida como "a vers�o alvo" (the target release), que recebe uma
39
prioridade maior do que as outras distribui��es.
40
A vers�o alvo pode ser definida na linha de comando do
41
\fBapt-get\fR ou no arquivo de configura��o do APT
42
\fI/etc/apt/apt.conf\fR\&.
46
\fBapt-get install -t testing \fIalgum-pacote\fB\fR
50
APT::Default-Release "stable";
53
Caso uma vers�o alvo tenha sido especificada o APT usar� o seguinte
54
algoritmo para definir as prioridades das inst�ncias de um pacote.
58
para a inst�ncia que j� esteja instalada (caso exista).
61
para as inst�ncias que n�o est� instaladas e que n�o pertencem a vers�o alvo.
64
para as inst�ncias que n�o estejam instaladas e perten�am a vers�o alvo.
66
Caso nenhuma vers�o alvo tenha sido especificada, o APT simplesmente
67
ir� atribuir a prioridade 100 para todas as inst�ncias de pacotes instaladas
68
e a prioridade 500 para todas as inst�ncias de pacotes n�o instaladas.
70
O APT aplica as regras a seguir, listadas em ordem de preced�ncia, para
71
determinar qual inst�ncia de um pacote instalar.
74
Nunca faz um downgrade a menos que a prioridade de
75
uma inst�ncia dispon�vel exceda 1000. (Fazer um "downgrade" � instalar uma
76
vers�o menos recente de um pacote no lugar de uma vers�o mais recente. Note
77
que nenhuma das prioridades padr�o do APT excede 1000; prioridades altas
78
como essa podem ser definidas somente no arquivo de prefer�ncias. Note
79
tamb�m que fazer um "downgrade" pode ser arriscado.)
82
Instala a inst�ncia de prioridade mais alta.
85
Caso duas ou mais inst�ncias possuam a mesma prioridade,
86
instala a inst�ncia mais recente (ou seja, aquela com o maior n�mero de
90
Caso duas ou mais inst�ncias possuam a mesma prioridade
91
e n�mero de vers�o mas os pacotes sejam diferentes em alguns de seus
92
metadados ou a op��o --reinstall seja fornecida, instala aquela
95
Em uma situa��o t�pica, a inst�ncia instalada de um pacote
96
(prioridade 100) n�o � t�o recente quanto uma das vers�es dispon�veis
97
nas fontes listadas no arquivo \fB\fIsources.list\fB\fR(5) (prioridade 500 ou 990).
98
Ent�o o pacote ser� atualizado quando os comandos
99
\fBapt-get install \fIalgum-pacote\fB\fR
100
ou \fBapt-get dist-upgrade\fR forem executados.
102
Mais raramente, a vers�o instalada de um pacote � \fBmais\fR
103
recente do que qualquer uma das outras vers�es dispon�veis. O dowgrade
104
do pacote n�o ser� feito quando os comandos
105
\fBapt-get install \fIalgum-pacote\fB\fR
106
ou \fBapt-get upgrade\fR forem executados.
108
Algumas vezes a vers�o instalada de um pacote � mais recente que a vers�o
109
que pertence a vers�o alvo, mas n�o t�o recente quanto a vers�o que
110
pertence a alguma outra distribui��o. Um pacote como esse ser� na verdade
111
atualizado quando os comandos
112
\fBapt-get install \fIalgum-pacote\fB\fR
113
ou \fBapt-get upgrade\fR forem executados, devido a pelo
114
menos \fBuma\fR das vers�es dispon�veis possuir uma prioridade maior
115
do que a vers�o instalada.
116
.SS "O EFEITO DAS PREFER�NCIAS DO APT"
118
O arquivo de prefer�ncias do APT permite ao administrador do
119
sistema personalizar prioridades. O arquivo consiste de um ou mais
120
registros de m�ltiplas linhas separados por linhas em branco. Registros
121
podem possuir uma das duas formas, uma forma espec�fica e uma forma geral.
124
A forma espec�fica atribui uma uma prioridade (uma "Pin-Priority")
125
para um pacote e vers�o ou faixa de vers�o especificados. Por exemplo,
126
o registro a seguir atribui uma prioridade alta para todas as vers�es do
127
pacote \fIperl\fR os quais tenham seus n�meros de vers�o iniciando
137
O forma geral atribui uma prioridade para todas as vers�es de pacotes em
138
uma dada distribui��o (isto �, para toda as vers�es de pacotes que estejam
139
em um certo arquivo \fIRelease\fR) ou para todas as vers�es de
140
pacotes que provenientes de um site Internet em particular, como
141
identificado pelo nome de dom�nio totalmente qualificado do site Internet.
143
Essa entrada de forma geral no arquivo de prefer�ncias do APT
144
aplica-se somente a grupos de pacotes. Por exemplo, o registro a seguir
145
faz com que o APT atribua uma prioridade alta para todas as vers�es
146
de pacotes dispon�veis no site local.
154
Uma nota de aviso : a palavra-chave usada aqui � "origin".
155
Esta palavra n�o deve ser confundida com a origem ("Origin:") de uma
156
distribui��o como especificado em um arquivo \fIRelease\fR\&. O que
157
segue a tag "Origin:" em um arquivo \fIRelease\fR n�o � um endere�o
158
de site Internet mas sim nome de autor ou distribuidor (vendor), como
159
"Debian" ou "Ximian".
161
O registro a seguir atribui uma prioridade baixa para todas as vers�es
162
de pacote que perten�am a qualquer distribui��o cujo nome do Reposit�rio
167
Pin: release a=unstable
171
O registro a seguir atribui uma prioridade alta para todas as vers�es de
172
pacotes que perten�am a qualquer vers�o cujo nome do Reposit�rio seja
173
"stable" e cujo n�mero de vers�o seja "3.0".
177
Pin: release a=unstable, v=3.0
180
.SS "COMO O APT INTERPRETA PRIORIDADES"
182
Prioridades (P) atribu�das no arquivo de prefer�ncias do APT devem ser
183
n�meros inteiros positivos ou negativos. Eles s�o interpretados como a
184
seguir (a grosso modo):
187
faz com que uma inst�ncia seja instalada
188
mesmo caso isso constitua um dowgrade do pacote
191
faz com que uma vers�o seja instalada
192
mesmo caso a mesma n�o venha de uma vers�o alvo,
193
a menos que a vers�o instalada seja mais recente
196
faz com que uma vers�o seja instalada
197
a menos que exista uma vers�o dispon�vel pertencente a vers�o
198
alvo ou a vers�o instalada seja mais recente
201
faz com que uma vers�o seja instalada
202
a menos que exista uma vers�o dispon�vel pertencente a alguma
203
outra distribui��o ou a vers�o instalada seja mais recente
206
faz com que uma vers�o seja instalada
207
somente caso n�o exista uma vers�o instalada do pacote
210
impede a vers�o de ser instalada
212
Caso um dos registro de forma espec�fica descritos acima case (match) com
213
uma vers�o dispon�vel do pacote ent�o o primeiro desses registros
214
encontrados determinar� a prioridade da vers�o do pacote. Na falha desse
215
cen�rio, caso quaisquer registros de forma gen�rica casem (match) com uma
216
vers�o do pacote dispon�vel ent�o o primeiro desses registros encontrado
217
determinar� a prioridade da vers�o do pacote.
219
Por exemplo, suponha que o arquivo de prefer�ncias do APT contenha
220
os tr�s registros apresentados anteriormente :
232
Pin: release unstable
238
A vers�o mais recente dispon�vel do pacote
239
perl ser� instalado, contanto que esse n�mero de vers�o da
240
vers�o inicie com "5.8". Caso \fBqualquer\fR vers�o 5.8*
241
de perl esteja dispon�vel e a vers�o instalada seja 5.9*, ser�
242
feito um downgrade do perl\&.
245
Uma vers�o de qualquer pacote diferente de
246
perl que esteja dispon�vel no sistema local possui prioridade
247
sobre outras vers�es, mesmo vers�es pertencentes a vers�o alvo.
250
Uma vers�o de um pacote cuja origem n�o seja o sistema
251
local mas sim algum outro site listado no arquivo \fB\fIsources.list\fB\fR(5) e que
252
perten�a a uma distribui��o unstable � instalada somente
253
caso a mesma seja selecionada para instala��o e nenhuma vers�o do
254
pacote j� esteja instalada.
255
.SS "DETERMINA��O DA VERS�O DO PACOTE E PROPRIEDADES DA DISTRIBUI��O"
257
As localidades listadas em um arquivo \fB\fIsources.list\fB\fR(5) devem fornecer
258
arquivos \fIPackages\fR e \fIRelease\fR para
259
descrever os pacotes dispon�veis nessas localidades.
261
O arquivo \fIPackages\fR � normalmente encontrado no
262
diret�rio \fI\&.../dists/nome-distribui��o/componente/arquitetura\fR :
263
por exemplo, \fI\&.../dists/stable/main/binary-i386/Packages\fR\&.
264
O arquivo consiste de uma s�rie de registros de m�ltiplas linhas, uma para
265
cada pacote dispon�vel no diret�rio. Somente duas linhas em cada registro
266
s�o relevantes para definir prioridades do APT :
268
\fBa linha Package:\fR
269
informa o nome do pacote
271
\fBa linha Version:\fR
272
informa o n�mero de vers�o do pacote
274
O arquivo \fIRelease\fR � normalmente encontrado no
276
\fI\&.../dists/nome-distribui��o\fR :
277
por exemplo, \fI\&.../dists/stable/Release\fR,
278
ou \fI\&.../dists/woody/Release\fR\&.
279
O arquivo consiste de um registro de m�ltiplas linhas o qual se aplica a
280
\fBtodos\fR os pacotes na �rvore de diret�rios abaixo de seu
281
diret�rio pai. Diferente do arquivo \fIPackages\fR, quase todas as
282
linhas em um arquivo \fIRelease\fR s�o relevantes para a defini��o de
285
\fBa linha Archive:\fR
286
d� nome ao reposit�rio para o qual todos os pacotes
287
na �rvore de diret�rio pertencem. Por exemplo, a linha
289
especifica que todos os pacotes na �rvore de diret�rio
290
abaixo do diret�rio pai do arquivo \fIRelease\fR est�o no
291
resposit�rio stable\&. Especificar esse valor no arquivo de
292
prefer�ncias do APT iria requerer a linha :
295
Pin: release a=stable
298
\fBa linha Version:\fR
299
d� nome a vers�o da distribui��o. Por exemplo, os
300
pacote na �rvore podem pertencer a distribui��o Debian GNU/Linux vers�o
301
3.0. Note que normalmente n�o existe n�mero de vers�o para as
302
distribui��es testing e unstable devido as mesmas
303
n�o terem sido lan�adas ainda. Especificar isso no arquivo de prefer�ncias
304
do APT iria requerer uma das linhas a seguir.
308
Pin: release a=stable v=3.0
312
\fBa linha Component:\fR
313
d� nome ao componente de licenciamento associado com
314
os pacotes na �rvore de diret�rio do arquivo \fIRelease\fR\&. Por
315
exemplo, a linha "Component: main" especifica que todos os pacotes na
316
�rvore de diret�rio s�o do componente main, o que significa que
317
as mesmas est�o licenciadas sob os termos da Linhas Guias Debian para o
318
Software Livre (a DFSG). Especificar esse componente no arquivo de
319
prefer�ncias do APT iria requerer a linha :
325
\fBa linha Origin:\fR
326
d� nome ao produtor dos pacotes na �rvore de diret�rio
327
do arquivo \fIRelease\fR\&. O mais comum � esse valor ser
328
Debian\&. Especificar essa origem no arquivo de prefer�ncias do
329
APT iria requerer a linha :
332
Pin: release o=Debian
336
d� nome ao r�tulo (label) dos pacotes na �rvore de
337
diret�rio. O mais comum � esse valor ser Debian\&. Especificar
338
esse r�tulo (label) no arquivo de prefer�ncias do APT iria requerer a
342
Pin: release l=Debian
345
Todos os arquivos \fIPackages\fR e
346
\fIRelease\fR obtidos das localidades listadas no arquivo
347
\fB\fIsources.list\fB\fR(5) s�o mantidos no diret�rio
348
\fI/var/lib/apt/lists\fR ou no arquivo indicado pela vari�vel
349
Dir::State::Lists no arquivo \fIapt.conf\fR\&.
350
Por exemplo, o arquivo
351
\fIdebian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release\fR
352
cont�m o arquivo \fIRelease\fR obtido do site
353
debian.lcs.mit.edu para a arquitetura binary-i386,
354
arquivos do componente contrib da distribui��o unstable\&.
355
.SS "LINHAS OPCIONAIS EM UM REGISTRO DE PREFER�NCIAS DO APT"
357
Cada registro em um arquivo de prefer�ncias do APT pode opcionalmente
358
iniciar com uma ou mais linhas iniciadas com a palavra
359
Explanation:\&. Isto oferece um local para inserir coment�rios.
361
A linha Pin-Priority: em cada registro de prefer�ncias do
362
APT � opcional. Caso omitida, o APT atribuir� uma prioridade de 1 menos o
363
�ltimo valor especificado em uma linha iniciando com
364
Pin-Priority: release ...\&.
366
.SS "ACOMPANHANDO A STABLE"
368
O arquivo de prefer�ncias do APT a seguir far� com que o APT atribua uma
369
prioridade maior do que a prioridade padr�o (500) para todas as vers�es
370
de pacotes pertencentes a distribui��o stable e uma prioridade
371
proibitivamente baixa para vers�es de pacotes pertencentes a outras
372
distribui��es Debian\&.
375
Explanation: Desinstala ou n�o instala nenhuma vers�o de pacote originada
376
Explanation: do Debian a n�o ser aquelas na distribui��o stable
378
Pin: release a=stable
382
Pin: release o=Debian
386
Com um arquivo \fB\fIsources.list\fB\fR(5) apropriado e o arquivo de prefer�ncias
387
acima, quaisquer um dos comandos a seguir far�o com que o APT atualize
388
para a(s) ul�tma(s) vers�o(�es) stable\&.
391
apt-get install \fInome-pacote\fR
396
O comando a seguir far� com que o APT atualize o pacote
397
especificado para a �ltima vers�o da distribui��o testing;
398
o pacote n�o serpa atualizado novamente a menos que esse comando seja
402
apt-get install \fIpacote\fR/testing
404
.SS "ACOMPANHANDO A TESTING"
406
O arquivo de prefer�ncias do APT a seguir far� com que o APT atribua uma
407
prioridade maior para vers�es de pacote da distribui��o testing,
408
uma prioridade menor para vers�es de pacotes da distribui��o
409
unstable e uma prioridade proibitivamente baixa para vers�es de
410
pacotes de outras distribui��es Debian\&.
414
Pin: release a=testing
418
Pin: release a=unstable
422
Pin: release o=Debian
426
Com um arquivo \fB\fIsources.list\fB\fR(5) adequado e o arquivo de prefer�ncias do APT
427
acima, quaisquer dos comandos a seguir far�o com que o APT atualize para
428
a(s) �ltima(s) vers�o(�es) testing\&.
431
apt-get install \fInome-pacote\fR
436
O comando a seguir far� com que o APT atualize o pacote especificado para
437
a �ltima vers�o da distribui��o unstable\&. Assim, o comando
438
\fBapt-get upgrade\fR ir� atualizar o pacote para a vers�o
439
testing mais recente caso essa vers�o seja mais recente que a
440
vers�o instalada, caso n�o seja, o pacote ser� atualizado para a vers�o
441
unstable mais recente caso a mesma seja mais recente que a
445
apt-get install \fIpacote\fR/unstable
447
.SH "CONSULTE TAMB�M"
449
\fBapt-get\fR(8) \fBapt-cache\fR(8) \fB\fIapt.conf\fB\fR(5) \fB\fIsources.list\fB\fR(5)
452
Consulte a p�gina de bugs do APT <URL:http://bugs.debian.org/apt>\&.
453
Caso voc� queira relatar um bug no APT, por favor consulte o arquivo
454
\fI/usr/share/doc/debian/bug-reporting.txt\fR ou o comando \fBreportbug\fR(1)\&.
457
O APT foi escrito pela equipe APT <apt@packages.debian.org>\&.
460
Esta p�gina de manual foi traduzida para o Portugu�s do Brasil por
461
Andr� Lu�s Lopes <andrelop@ig.com.br>\&.