- initial import of revision 374 from cnc
[apt.git] / doc / pt_BR / apt_preferences.pt_BR.5.sgml
1 <!-- -*- mode: sgml; mode: fold -*- -->
2 <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
3
4 <!ENTITY % aptent SYSTEM "apt.ent.pt_BR">
5 %aptent;
6
7 ]>
8
9 <refentry lang="pt_BR">
10  &apt-docinfo;
11
12  <refmeta>
13    <refentrytitle>apt_preferences</>
14    <manvolnum>5</>
15  </refmeta>
16
17  <!-- Man page title -->
18  <refnamediv>
19     <refname>apt_preferences</>
20     <refpurpose>Arquivo de controle de preferências para o APT</>
21  </refnamediv>
22
23 <RefSect1>
24 <Title>Descrição</Title>
25 <para>
26 O arquivo de preferências do APT <filename>/etc/apt/preferences</>
27 pode ser usado para controlar quais versões de pacotes serão
28 selecionadas para instalação.
29 </para>
30
31 <para>
32 Diversas versões de um pacote podem estar disponíveis para
33 instalação quando o arquivo &sources-list; contém referências para
34 mais de uma distribuição (por exemplo, <literal>stable</literal> e
35 <literal>testing</literal>). O APT atribui uma prioridade para cada
36 versão que esteja disponível. Sujeito a obstáculos de dependências, o
37 <command>apt-get</command> seleciona para instalação a versão com a
38 maior prioridade.
39 O arquivo de preferências do APT sobrepoe as prioridades que o APT
40 atribui a cada versão de pacote por padrão, dando assim ao usuário
41 controle sobre qual versão do pacote é selecionada para instalação.
42 </para>
43 <para>
44 Diversas instâncias da mesma versão de um pacote pode estar disponíveis
45 quando o arquivo &sources-list; contém referências a mais de uma fonte.
46 Nesse caso, o <command>apt-get</command> faz o download da instância
47 listada antes no arquivo &sources-list; .
48 O arquivo de preferências do APT não afeta a escolha da instância.
49 </para>
50
51 <RefSect2><Title>Atribuições de Prioridade Padrão do APT</>
52
53 <para>
54 Caso não exista um arquivo de preferências ou caso não exista uma
55 entrada no arquivo que se aplique a uma instância em particular, a
56 prioridade atribuída a essa instância é a prioridade da distribuição
57 para a qual a instância pertence. É possível selecionar uma distribuição,
58 conhecida como "a versão alvo" (the target release), que recebe uma
59 prioridade maior do que as outras distribuições. 
60 A versão alvo pode ser definida na linha de comando do
61 <command>apt-get</command> ou no arquivo de configuração do APT
62 <filename>/etc/apt/apt.conf</filename>.
63 Por exemplo, 
64 <programlisting>
65 <command>apt-get install -t testing <replaceable>algum-pacote</replaceable></command>
66 </programlisting>
67 <programlisting>
68 APT::Default-Release "stable";
69 </programlisting>
70 </para>
71
72 <para>
73 Caso uma versão alvo tenha sido especificada o APT usará o seguinte
74 algoritmo para definir as prioridades das instâncias de um pacote.
75 Atribuirá :
76 <variablelist>
77 <varlistentry>
78 <term>prioridade 100</term>
79 <listitem><simpara>para a instância que já esteja instalada (caso exista).</simpara></listitem>
80 </varlistentry>
81 <varlistentry>
82 <term>prioridade 500</term>
83 <listitem><simpara>para as instâncias que não estã instaladas e que não pertencem a versão alvo.</simpara></listitem>
84 </varlistentry>
85 <varlistentry>
86 <term>prioridade 990</term>
87 <listitem><simpara>para as instâncias que não estejam instaladas e pertençam a versão alvo.</simpara></listitem>
88 </varlistentry>
89 </variablelist>
90 </para>
91
92 <para>
93 Caso nenhuma versão alvo tenha sido especificada, o APT simplesmente
94 irá atribuir a prioridade 100 para todas as instâncias de pacotes instaladas
95 e a prioridade 500 para todas as instâncias de pacotes não instaladas.
96 </para>
97
98 <para>
99 O APT aplica as regras a seguir, listadas em ordem de precedência, para
100 determinar qual instância de um pacote instalar.
101 <itemizedlist>
102 <listitem><simpara>Nunca faz um downgrade a menos que a prioridade de
103 uma instância disponível exceda 1000. (Fazer um "downgrade" é instalar uma
104 versão menos recente de um pacote no lugar de uma versão mais recente. Note
105 que nenhuma das prioridades padrão do APT excede 1000; prioridades altas
106 como essa podem ser definidas somente no arquivo de preferências. Note
107 também que fazer um "downgrade" pode ser arriscado.)</simpara></listitem>
108 <listitem><simpara>Instala a instância de prioridade mais alta.</simpara></listitem>
109 <listitem><simpara>Caso duas ou mais instâncias possuam a mesma prioridade,
110 instala a instância mais recente (ou seja, aquela com o maior número de
111 versão).</simpara></listitem>
112 <listitem><simpara>Caso duas ou mais instâncias possuam a mesma prioridade
113 e número de versão mas os pacotes sejam diferentes em alguns de seus
114 metadados ou a opção <literal/--reinstall/ seja fornecida, instala aquela
115 desinstalada.</simpara></listitem>
116 </itemizedlist>
117 </para>
118
119 <para>
120 Em uma situação típica, a instância instalada de um pacote
121 (prioridade 100) não é tão recente quanto uma das versões disponíveis
122 nas fontes listadas no arquivo &sources-list; (prioridade 500 ou 990).
123 Então o pacote será atualizado quando os comandos
124 <command>apt-get install <replaceable>algum-pacote</replaceable></command>
125 ou <command>apt-get dist-upgrade</command> forem executados.
126 </para>
127
128 <para>
129 Mais raramente, a versão instalada de um pacote é <emphasis/mais/
130 recente do que qualquer uma das outras versões disponíveis. O dowgrade
131 do pacote não será feito quando os comandos
132 <command>apt-get install <replaceable>algum-pacote</replaceable></command>
133 ou <command>apt-get upgrade</command> forem executados.
134 </para>
135
136 <para>
137 Algumas vezes a versão instalada de um pacote é mais recente que a versão
138 que pertence a versão alvo, mas não tão recente quanto a versão que
139 pertence a alguma outra distribuição. Um pacote como esse será na verdade
140 atualizado quando os comandos
141 <command>apt-get install <replaceable>algum-pacote</replaceable></command>
142 ou <command>apt-get upgrade</command> forem executados, devido a pelo
143 menos <emphasis/uma/ das versões disponíveis possuir uma prioridade maior
144 do que a versão instalada.
145 </para>
146
147 </RefSect2>
148
149 <RefSect2><Title>O Efeito das Preferências do APT</>
150
151 <para>
152 O arquivo de preferências do APT permite ao administrador do
153 sistema personalizar prioridades. O arquivo consiste de um ou mais
154 registros de múltiplas linhas separados por linhas em branco. Registros
155 podem possuir uma das duas formas, uma forma específica e uma forma geral.
156 <itemizedlist>
157 <listitem>
158 <simpara>
159 A forma específica atribui uma uma prioridade (uma "Pin-Priority")
160 para um pacote e versão ou faixa de versão especificados. Por exemplo,
161 o registro a seguir atribui uma prioridade alta para todas as versões do
162 pacote <filename/perl/ os quais tenham seus números de versão iniciando
163 com "<literal/5.8/".
164 </simpara>
165
166 <programlisting>
167 Package: perl
168 Pin: version 5.8*
169 Pin-Priority: 1001
170 </programlisting>
171 </listitem>
172
173 <listitem><simpara>
174 O forma geral atribui uma prioridade para todas as versões de pacotes em
175 uma dada distribuição (isto é, para toda as versões de pacotes que estejam
176 em um certo arquivo <filename/Release/) ou para todas as versões de
177 pacotes que provenientes de um site Internet em particular, como
178 identificado pelo nome de domínio totalmente qualificado do site Internet.
179 </simpara>
180
181 <simpara>
182 Essa entrada de forma geral no arquivo de preferências do APT
183 aplica-se somente a grupos de pacotes. Por exemplo, o registro a seguir
184 faz com que o APT atribua uma prioridade alta para todas as versões
185 de pacotes disponíveis no site local.
186 </simpara>
187
188 <programlisting>
189 Package: *
190 Pin: origin ""
191 Pin-Priority: 999
192 </programlisting>
193
194 <simpara>
195 Uma nota de aviso : a palavra-chave usada aqui é "<literal/origin/".
196 Esta palavra não deve ser confundida com a origem ("Origin:") de uma
197 distribuição como especificado em um arquivo <filename/Release/. O que
198 segue a tag "Origin:" em um arquivo <filename/Release/ não é um endereço
199 de site Internet mas sim nome de autor ou distribuidor (vendor), como
200 "Debian" ou "Ximian".
201 </simpara>
202
203 <simpara>
204 O registro a seguir atribui uma prioridade baixa para todas as versões
205 de pacote que pertençam a qualquer distribuição cujo nome do Repositório
206 seja "<literal/unstable/".
207 </simpara>
208
209 <programlisting>
210 Package: *
211 Pin: release a=unstable
212 Pin-Priority: 50
213 </programlisting>
214
215 <simpara>
216 O registro a seguir atribui uma prioridade alta para todas as versões de
217 pacotes que pertençam a qualquer versão cujo nome do Repositório seja
218 "<literal/stable/" e cujo número de versão seja "<literal/3.0/".
219 </simpara>
220
221 <programlisting>
222 Package: *
223 Pin: release a=unstable, v=3.0
224 Pin-Priority: 50
225 </programlisting>
226 </listitem>
227 </itemizedlist>
228 </para>
229
230 </RefSect2>
231
232 <RefSect2>
233 <Title>Como o APT Interpreta Prioridades</Title>
234
235 <para>
236 Prioridades (P) atribuídas no arquivo de preferências do APT devem ser
237 números inteiros positivos ou negativos. Eles são interpretados como a
238 seguir (a grosso modo):
239
240 <variablelist>
241 <varlistentry>
242 <term>P &gt; 1000</term>
243 <listitem><simpara>faz com que uma instância seja instalada
244 mesmo caso isso constitua um dowgrade do pacote</simpara></listitem>
245 </varlistentry>
246 <varlistentry>
247 <term>990 &lt; P &lt;=1000</term>
248 <listitem><simpara>faz com que uma versão seja instalada
249 mesmo caso a mesma não venha de uma versão alvo,
250 a menos que a versão instalada seja mais recente</simpara></listitem>
251 </varlistentry>
252 <varlistentry>
253 <term>500 &lt; P &lt;=990</term>
254 <listitem><simpara>faz com que uma versão seja instalada
255 a menos que exista uma versão disponível pertencente a versão
256 alvo ou a versão instalada seja mais recente</simpara></listitem>
257 </varlistentry>
258 <varlistentry>
259 <term>100 &lt; P &lt;=500</term>
260 <listitem><simpara>faz com que uma versão seja instalada
261 a menos que exista uma versão disponível pertencente a alguma
262 outra distribuição ou a versão instalada seja mais recente</simpara></listitem>
263 <varlistentry>
264 <term>0 &lt;= P &lt;=100</term>
265 <listitem><simpara>faz com que uma versão seja instalada
266 somente caso não exista uma versão instalada do pacote</simpara></listitem>
267 </varlistentry>
268 <varlistentry>
269 <term>P &lt; 0</term>
270 <listitem><simpara>impede a versão de ser instalada</simpara></listitem>
271 </varlistentry>
272 </variablelist>
273 </para>
274
275 <para>
276 Caso um dos registro de forma específica descritos acima case (match) com
277 uma versão disponível do pacote então o primeiro desses registros
278 encontrados determinará a prioridade da versão do pacote. Na falha desse
279 cenário, caso quaisquer registros de forma genérica casem (match) com uma
280 versão do pacote disponível então o primeiro desses registros encontrado
281 determinará a prioridade da versão do pacote.
282 </para>
283
284 <para>
285 Por exemplo, suponha que o arquivo de preferências do APT contenha
286 os três registros apresentados anteriormente :
287
288 <programlisting>
289 Package: perl
290 Pin: version 5.8*
291 Pin-Priority: 1001
292
293 Package: *
294 Pin: origin ""
295 Pin-Priority: 999
296
297 Package: *
298 Pin: release unstable
299 Pin-Priority: 50
300 </programlisting>
301
302 Então :
303
304 <itemizedlist>
305 <listitem><simpara>A versão mais recente disponível do pacote
306 <literal/perl/ será instalado, contanto que esse número de versão da
307 versão inicie com "<literal/5.8/".  Caso <emphasis/qualquer/ versão 5.8*
308 de <literal/perl/ esteja disponível e a versão instalada seja 5.9*, será
309 feito um downgrade do <literal/perl/.
310 </simpara></listitem>
311 <listitem><simpara>Uma versão de qualquer pacote diferente de
312 <literal/perl/ que esteja disponível no sistema local possui prioridade
313 sobre outras versões, mesmo versões pertencentes a versão alvo.
314 </simpara></listitem>
315 <listitem><simpara>Uma versão de um pacote cuja origem não seja o sistema
316 local mas sim algum outro site listado no arquivo &sources-list; e que
317 pertença a uma distribuição <literal/unstable/ é instalada somente
318 caso a mesma seja selecionada para instalação e nenhuma versão do
319 pacote já esteja instalada.
320 </simpara></listitem>
321 </itemizedlist>
322 </para>
323 </RefSect2>
324
325 <RefSect2>
326 <Title>Determinação da Versão do Pacote e Propriedades da Distribuição</Title>
327
328 <para>
329 As localidades listadas em um arquivo &sources-list; devem fornecer
330 arquivos <filename>Packages</filename> e <filename>Release</filename> para
331 descrever os pacotes disponíveis nessas localidades.
332 </para>
333
334 <para>
335 O arquivo <filename>Packages</filename> é normalmente encontrado no
336 diretório <filename>.../dists/<replaceable>nome-distribuição</replaceable>/<replaceable>componente</replaceable>/<replaceable>arquitetura</replaceable></filename> :
337 por exemplo, <filename>.../dists/stable/main/binary-i386/Packages</filename>.
338 O arquivo consiste de uma série de registros de múltiplas linhas, uma para
339 cada pacote disponível no diretório. Somente duas linhas em cada registro
340 são relevantes para definir prioridades do APT :
341 <variablelist>
342 <varlistentry>
343 <term>a linha <literal/Package:/</term>
344 <listitem><simpara>informa o nome do pacote</simpara></listitem>
345 </varlistentry>
346 <varlistentry>
347 <term>a linha <literal/Version:/</term>
348 <listitem><simpara>informa o número de versão do pacote</simpara></listitem>
349 </varlistentry>
350 </variablelist>
351 </para>
352
353 <para>
354 O arquivo <filename>Release</filename> é normalmente encontrado no
355 diretório
356 <filename>.../dists/<replaceable>nome-distribuição</replaceable></filename> :
357 por exemplo, <filename>.../dists/stable/Release</filename>,
358 ou <filename>.../dists/woody/Release</filename>.
359 O arquivo consiste de um registro de múltiplas linhas o qual se aplica a
360 <emphasis/todos/ os pacotes na àrvore de diretórios abaixo de seu
361 diretório pai. Diferente do arquivo <filename/Packages/, quase todas as
362 linhas em um arquivo <filename/Release/ são relevantes para a definição de
363 prioridades do APT :
364
365 <variablelist>
366 <varlistentry>
367 <term>a linha <literal/Archive:/</term>
368 <listitem><simpara>dá nome ao repositório para o qual todos os pacotes
369 na àrvore de diretório pertencem. Por exemplo, a linha
370 "Archive: stable"
371 especifica que todos os pacotes na àrvore de diretório
372 abaixo do diretório pai do arquivo <filename/Release/ estão no
373 respositório <literal/stable/.  Especificar esse valor no arquivo de
374 preferências do APT iria requerer a linha :
375 </simpara>
376 <programlisting>
377 Pin: release a=stable
378 </programlisting>
379 </listitem>
380 </varlistentry>
381
382 <varlistentry>
383 <term>a linha <literal/Version:/</term>
384 <listitem><simpara>dá nome a versão da distribuição. Por exemplo, os
385 pacote na àrvore podem pertencer a distribuição Debian GNU/Linux versão
386 3.0. Note que normalmente não existe número de versão para as
387 distribuições <literal/testing/ e <literal/unstable/ devido as mesmas
388 não terem sido lançadas ainda. Especificar isso no arquivo de preferências
389 do APT iria requerer uma das linhas a seguir.
390 </simpara>
391
392 <programlisting>
393 Pin: release v=3.0
394 Pin: release a=stable v=3.0
395 Pin: release 3.0
396 </programlisting>
397
398 </listitem>
399 </varlistentry>
400
401 <varlistentry>
402 <term>a linha <literal/Component:/</term>
403 <listitem><simpara>dá nome ao componente de licenciamento associado com
404 os pacotes na àrvore de diretório do arquivo <filename/Release/. Por
405 exemplo, a linha "Component: main" especifica que todos os pacotes na
406 àrvore de diretório são do componente <literal/main/, o que significa que
407 as mesmas estão licenciadas sob os termos da Linhas Guias Debian para o
408 Software Livre (a DFSG). Especificar esse componente no arquivo de
409 preferências do APT iria requerer a linha :
410 </simpara>
411 <programlisting>
412 Pin: release c=main
413 </programlisting>
414 </listitem>
415 </varlistentry>
416
417 <varlistentry>
418 <term>a linha <literal/Origin:/</term>
419 <listitem><simpara>dá nome ao produtor dos pacotes na àrvore de diretório
420 do arquivo <filename/Release/. O mais comum é esse valor ser
421 <literal/Debian/.  Especificar essa origem no arquivo de preferências do
422 APT iria requerer a linha :
423 </simpara>
424 <programlisting>
425 Pin: release o=Debian
426 </programlisting>
427 </listitem>
428 </varlistentry>
429
430 <varlistentry>
431 <term>a linha <literal/Label:/</term>
432 <listitem><simpara>dá nome ao rótulo (label) dos pacotes na árvore de
433 diretório. O mais comum é esse valor ser <literal/Debian/. Especificar
434 esse rótulo (label) no arquivo de preferências do APT iria requerer a
435 linha :
436 </simpara>
437 <programlisting>
438 Pin: release l=Debian
439 </programlisting>
440 </listitem>
441 </varlistentry>
442 </variablelist>
443 </para>
444
445 <para>
446 Todos os arquivos <filename>Packages</filename> e
447 <filename>Release</filename> obtidos das localidades listadas no arquivo
448 &sources-list; são mantidos no diretório
449 <filename>/var/lib/apt/lists</filename> ou no arquivo indicado pela variável
450 <literal/Dir::State::Lists/ no arquivo <filename/apt.conf/.
451 Por exemplo, o arquivo
452 <filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename>
453 contém o arquivo <filename>Release</filename> obtido do site
454 <literal/debian.lcs.mit.edu/ para a arquitetura <literal/binary-i386/,
455 arquivos do componente <literal/contrib/ da distribuição <literal/unstable/.
456 </para>
457
458 </RefSect2>
459
460 <RefSect2>
461 <Title>Linhas Opcionais em um Registro de Preferências do APT</Title>
462
463 <para>
464 Cada registro em um arquivo de preferências do APT pode opcionalmente
465 iniciar com uma ou mais linhas iniciadas com a palavra
466 <literal/Explanation:/. Isto oferece um local para inserir comentários.
467 </para>
468
469 <para>
470 A linha <literal/Pin-Priority:/ em cada registro de preferências do
471 APT é opcional. Caso omitida, o APT atribuirá uma prioridade de 1 menos o
472 último valor especificado em uma linha iniciando com
473 <literal/Pin-Priority: release .../.
474 </para>
475 </RefSect2>
476 </RefSect1>
477
478 <RefSect1>
479 <Title>Exemplos</Title>
480 <RefSect2>
481 <Title>Acompanhando a Stable</Title>
482
483 <para>
484 O arquivo de preferências do APT a seguir fará com que o APT atribua uma
485 prioridade maior do que a prioridade padrão (500) para todas as versões
486 de pacotes pertencentes a distribuição <literal/stable/ e uma prioridade
487 proibitivamente baixa para versões de pacotes pertencentes a outras
488 distribuições <literal/Debian/.
489
490 <programlisting>
491 Explanation: Desinstala ou não instala nenhuma versão de pacote originada
492 Explanation: do Debian a não ser aquelas na distribuição stable
493 Package: *
494 Pin: release a=stable
495 Pin-Priority: 900
496
497 Package: *
498 Pin: release o=Debian
499 Pin-Priority: -10
500 </programlisting>
501 </para>
502
503 <para>
504 Com um arquivo &sources-list; apropriado e o arquivo de preferências
505 acima, quaisquer um dos comandos a seguir farão com que o APT atualize
506 para a(s) ulítma(s) versão(ôes) <literal/stable/.
507
508 <programlisting>
509 apt-get install <replaceable>nome-pacote</replaceable>
510 apt-get upgrade
511 apt-get dist-upgrade
512 </programlisting>
513 </para>
514
515 <para>
516 O comando a seguir fará com que o APT atualize o pacote
517 especificado para a última versão da distribuição <literal/testing/;
518 o pacote não serpa atualizado novamente a menos que esse comando seja
519 executado novamente.
520
521 <programlisting>
522 apt-get install <replaceable>pacote</replaceable>/testing
523 </programlisting>
524 </RefSect2>
525
526 <RefSect2>
527 <Title>Acompanhando a Testing</Title>
528
529 <para>
530 O arquivo de preferências do APT a seguir fará com que o APT atribua uma
531 prioridade maior para versões de pacote da distribuição <literal/testing/,
532 uma prioridade menor para versões de pacotes da distribuição
533 <literal/unstable/ e uma prioridade proibitivamente baixa para versões de
534 pacotes de outras distribuições <literal/Debian/.
535
536 <programlisting>
537 Package: *
538 Pin: release a=testing
539 Pin-Priority: 900
540
541 Package: *
542 Pin: release a=unstable
543 Pin-Priority: 800
544
545 Package: *
546 Pin: release o=Debian
547 Pin-Priority: -10
548 </programlisting>
549 </para>
550
551 <para>
552 Com um arquivo &sources-list; adequado e o arquivo de preferências do APT
553 acima, quaisquer dos comandos a seguir farão com que o APT atualize para
554 a(s) última(s) versão(ões) <literal/testing/.
555
556 <programlisting>
557 apt-get install <replaceable>nome-pacote</replaceable>
558 apt-get upgrade
559 apt-get dist-upgrade
560 </programlisting>
561 </para>
562
563 <para>
564 O comando a seguir fará com que o APT atualize o pacote especificado para
565 a última versão da distribuição <literal/unstable/. Assim, o comando
566 <command>apt-get upgrade</command> irá atualizar o pacote para a versão
567 <literal/testing/ mais recente caso essa versão seja mais recente que a
568 versão instalada, caso não seja, o pacote será atualizado para a versão
569 <literal/unstable/ mais recente caso a mesma seja mais recente que a
570 versão instalada.
571
572 <programlisting>
573 apt-get install <replaceable>pacote</replaceable>/unstable
574 </programlisting>
575 </para>
576
577 </RefSect2>
578 </RefSect1>
579
580 <RefSect1>
581 <Title>Consulte também</Title>
582 <para>
583 &apt-get; &apt-cache; &apt-conf; &sources-list;
584 </para>
585 </RefSect1>
586
587  &manbugs;
588  &manauthor;
589  &ptbr-mantranslator;