path: root/doc/pt_BR/apt_preferences.pt_BR.5.sgml

<!-- -*- mode: sgml; mode: fold -*- -->
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [

<!ENTITY % aptent SYSTEM "apt.ent.pt_BR">
%aptent;

]>

<refentry lang="pt_BR">
 &apt-docinfo;

 <refmeta>
   <refentrytitle>apt_preferences</>
   <manvolnum>5</>
 </refmeta>

 <!-- Man page title -->
 <refnamediv>
    <refname>apt_preferences</>
    <refpurpose>Arquivo de controle de preferências para o APT</>
 </refnamediv>

<RefSect1><Title>Descrição</>
<para>
O arquivo de preferências do APT <filename>/etc/apt/preferences</>
pode ser usado para controlar qual versão de um pacote será
selecionada para instalação.
</para>

<para>Diversas versões de um pacote podem estar disponíveis para
instalação quando o arquivo &sources-list; contém referências para
mais de uma distribuição (por exemplo, <literal>stable</literal> e
<literal>testing</literal>); além disso, diversas instâncias da mesma
versão de um pacote podem estar disponíveis quando o arquivo contém
referências para mais de um site para download para uma distribuição
específica. O APT atribui uma "prioridade" para cada instância que
esteja disponível. (No que se segue, uma "instância" será uma instância
de um pacote que esteja disponível de acordo com o arquivo
&sources-list;.)
Sujeito a obstáculos de dependências, o <command>apt-get</command>
instala a instância com a prioridade mais alta. Caso duas instâncias
possuam a mesma prioridade o APT irá instalar a instância mais recente,
ou seja, aquela com o maior número de versão.
</para>

<para>O arquivo de preferências do APT sobrepõe as prioridades que o
APT atribui por padrão a instâncias de pacote, dando portanto ao usuário
controle sobre qual pacote é eslecionado para instalação.
</para>

<RefSect2><Title>Atribuições de Prioridade Padrão do APT</>

<para>Caso não exista um arquivo de preferências ou caso não exista uma
entrada no arquivo que se aplique a uma instância em particular, a
prioridade atribuída a essa instância é a prioridade da distribuição
para a qual a instância pertence. É possível selecionar uma distribuição,
conhecida como a "versão alvo" (target release), a qual recebe uma
prioridade maior do que as outras distribuições. A versão alvo pode ser
definida na linha de comando do <command>apt-get</command> ou no arquivo
de configuração do APT <filename>/etc/apt/apt.conf</filename>. Por
exemplo,

<programlisting>
# Comando para instalar a versão <literal/testing/ do pacote <replaceable>algum-pacote</replaceable>
<command>apt-get install -t testing <replaceable>algum-pacote</replaceable></command>
</programlisting>

<programlisting>
# Configuração que torna <literal/stable/ a versão alvo
APT::Default-Release "stable";
</programlisting>
</para>

<para>Caso um aversão alvo tenha sido especificada o APT usará o
seguinte algoritmo para definir as prioridades das instâncias de um
pacote. Atribuirá :

<variablelist>
<varlistentry>
<term>prioridade 100</term>
<listitem><simpara>para a instância que já esteja instalada (caso exista).
</simpara></listitem>
</varlistentry>
<varlistentry>
<term>prioridade 500</term>
<listitem><simpara>para as instâncias que não estã instaladas e que não
pertencem a versão alvo.
</simpara></listitem>
</varlistentry>
<varlistentry>
<term>prioridade 990</term>
<listitem><simpara>para as instâncias que não estejam instaladas e pertençãm
a versão alvo.
</simpara></listitem>
</varlistentry>
</variablelist>
</para>

<para>Caso nenhuma versão alvo tenha sido especificada o APT simplesmente
irá atribuir a prioridade 100 para todos as instâncias de pacotes instalados
e a prioridade 500 para todas as instâncias de pacotes não instalados.
</para>

<para>O APT aplica as regras a seguir, listadas em ordem de precedência,
para determinar qual instância de um pacote instalar.

<itemizedlist>
<listitem><simpara>Nunca faz um downgrade a menos que a prioridade de
uma instância disponível exceda 1000. (Fazer um "dowgrade" é instalar uma
versão menos recente de um pacote no lugar de uma versão mais recente. Note
que nenhuma das prioridades padrão do APT excede 1000; prioridades altas
como essa podem ser definidas somente no arquivo de preferências.)
</simpara></listitem>
<listitem><simpara>Instala a instância de prioridade mais alta.
</simpara></listitem>
<listitem><simpara>Caso duas ou mais instâncias possuam a mesma prioridade,
instalar a instância mais recente.
</simpara></listitem>
<listitem><simpara>Caso duas ou mais instâncias possuam o mesmo número de
versão, instalar a instância a qual a fonte esteja listada no &sources-list;.
(A instância instalada, caso exista, é sempre a preferida em uma comparação
como essa a menos que o comando <command>apt-get --reinstall</command> seja
usado.)
</simpara></listitem>
</itemizedlist>
</para>

<para>Em uma situação típica, a instância instalada de um pacote
(prioridade 100) não é tão recente quanto uma das instâncias disponíveis
nas fontes listadas no arquivo &sources-list; (prioridade 500 ou 990).
Então o pacote será atualizado com o comando :
<command>apt-get install</command> ou <command>apt-get dist-upgrade</command>.
</para>

<para>Raramente, a instância instalada de um pacote é <emphasis/mais/
recente do que qualquer uma das outras instâncias disponíveis. O dowgrade
do pacote não será feito.
</para>

<para>Algumas vezes a instância instalada de um pacote é mais recente
que a versão que pertence a versçao alvo, mas não tão recente quanto a
versão que pertence a alguma outra distribuição. Um pacote como esse
será realmente atualizado, devido a pelo menos <emphasis/uma/ das
instâncias disponíveis possuir uma prioridade maior do que a instância
instalada.
</para>

</RefSect2>

<RefSect2><Title>O Efeito das Preferências do APT</>

<para>O arquivo de preferências do APT permite ao administrador do
sistema personalizar as prioridades. O arquivo consiste de um ou mais
registro de múltiplas linhas separados por linhas em branco. Registros
podem possuir uma ou duas formas, uma forma específica e uma forma
geral.
<itemizedlist>
<listitem>
<simpara>A forma "específica" pina uma prioridade (um "Pin-Priority")
para um pacote e versão ou faixa de versão especificados. Por exemplo,
o registro a seguir pina uma prioridade alta para todas as versões do
pacote <filename/perl/ as quais o número de versão inicia com <literal/5.8/".
</simpara>

<programlisting>
Package: perl
Pin: version 5.8*
Pin-Priority: 1001
</programlisting>
</listitem>

<listitem><simpara>
O forma "geral" pina uma prioridade para todas as versões de pacotes em
uma dada distribuição (isto é, para toda as versões de pacotes que estão
em um certo arquivo <filename/Release/) ou para todas as instâncias de
pacotes que vêm de um site Internet em particular, como identificado
por seu nome de domínio totalmente qualificado.
</simpara>

<simpara>Essa entrada de forma geral no arquivo de preferências 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 instâncias
de pacotes disponíveis no site local.
</simpara>

<programlisting>
Package: *
Pin: origin ""
Pin-Priority: 999
</programlisting>

<simpara>Uma nota de aviso : a palavra-chave usada aqui é
"<literal/origin/". Esta não deve ser confundida com com a origem
("Origin:") de uma distribuição como especificado em um arquivo
<filename/Release/. O que segue a tag "Origin:" em um arquivo
<filename/Release/ normalmente não é um endereço de site Internet
mas sim nome de autor ou distribuidor (vendor), como "Debian" ou
"Ximian".
</simpara>

<simpara>O registro a seguir faz com que o APT atribua uma prioridade
baixa para todas as versões de pacote que pertençam a qualquer
distribuição a qual o nome do "Archive" (<literal/a/) seja
"<literal/unstable/".
</simpara>

<programlisting>
Package: *
Pin: release a=unstable
Pin-Priority: 50
</programlisting>

<simpara>O registro a seguir faz com que o APT atribua uma prioridade
alta para todas as versões de pacotes que pertencem a qualquer versão
a qual o nome do repositório ("Archive") (<literal/a/) seja
"<literal/stable/" e a qual o número de versão ("Version")
(<literal/v/) seja "<literal/3.0/".
</simpara>

<programlisting>
Package: *
Pin: release a=unstable, v=3.0
Pin-Priority: 50
</programlisting>
</listitem>
</itemizedlist>
</para>

</RefSect2>

<RefSect2><Title>Como o APT Interpreta Prioridades</Title>

<para>Prioridades (P) atribuídas no arquivo de preferências do APT
devem ser inteiros positivos ou negativos. Eles são interpretados como
a seguir (a grosso modo):

<variablelist>
<varlistentry><term>P &gt; 1000</term>
<listitem><simpara>faz com que uma instância seja instalada
mesmo caso isso constitua um dowgrade do pacote
</simpara></listitem>
</varlistentry>
<varlistentry><term>990 &lt; P &lt;=1000</term>
<listitem><simpara>faz com que uma instância seja instalada
mesmo caso a mesma não venha de uma versão alvo,
a menos que a instância instalada seja mais recente
</simpara></listitem>
</varlistentry>
<varlistentry><term>500 &lt; P &lt;=990</term>
<listitem><simpara>faz com que uma instância seja instalada
a menos que exista uma instância disponível pertencente a versão
alvo ou a versão instalada seja mais recente
</simpara></listitem>
</varlistentry>
<varlistentry><term>100 &lt; P &lt;=500</term>
<listitem><simpara>faz com que uma instância seja instalada
a menos que exista uma instância disponível pertencente a alguma
outra distribuição ou a versão instalada seja mais recente
</simpara></listitem>
<varlistentry><term>0 &lt;= P &lt;=100</term>
<listitem><simpara>faz com que uma instância seja instalada
somente caso não exista uma instância instalada do pacote
</simpara></listitem>
</varlistentry>
<varlistentry><term>P &lt; 0</term>
<listitem><simpara>impede a instância de ser instalada
</simpara></listitem>
</varlistentry>
</variablelist>
</para>

<para>Caso um dos registro de forma específica descritos acima caso com
uma instância disponível de pacote, tal registro determina a prioridade
da instância. Caso dois registros de forma específica casem com uma
instância disponível, o primeiro registro encontrado determina a
prioridade. Caso dois registros de forma geral casem com uma instância
disponível, o primeiro registro encontrado determina a prioridade.
</para>

<para>Por exemplo, suponha que o arquivo de preferências do APT contenha
os três registrsos apresentados anteriormente :

<programlisting>
Package: perl
Pin: version 5.8*
Pin-Priority: 1001

Package: *
Pin: origin ""
Pin-Priority: 999

Package: *
Pin: release unstable
Pin-Priority: 50
</programlisting>

Então :

<itemizedlist>
<listitem><simpara>A versão mais recente disponível do pacote
<literal/perl/ será instalado, contanto que esse número de versão da
versão inicie com "<literal/5.8/".  Caso <emphasis/qualquer/ versão 5.8*
de <literal/perl/ esteja disponível e a versão instalada seja 5.9*, será
feito um downgrade do <literal/perl/.
</simpara></listitem>
<listitem><simpara>Uma instância de qualquer pacote que não <literal/perl/
que esteja disponível no sistema local possui prioridade sobre outras
instâncias, mesmo instâncias pertencentes a versão alvo.
</simpara></listitem>
<listitem><simpara>Uma instância de um pacote a qual a origem não seja
o sistema local mas sim algum outro site listado n &sources-list; e a
qual pertença a uma distribuição "<literal/unstable/" é instalada somente
caso a mesma seja selecionada para instalação e nenhuma instância do
pacote já esteja instalada.
</simpara></listitem>
</itemizedlist>
</para>
</RefSect2>

<RefSect2><Title>Determinação da Versão do Pacote e Propriedades de Distribuição</Title>

<para>As localidades listadas em um arquivo &sources-list; de um sistema
devem fornecer arquivos <filename>Package</filename> e
<filename>Release</filename> para descrever as instâncias de pacote
disponíveis nestas localidades.
</para>

<para>O arquivo <filename>Packages</filename> é nromalmente encontrado no
diretório <filename>.../dists/<replaceable>nome-distribuição</replaceable>/<replaceable>componente</replaceable>/<replaceable>arquitetura</replaceable></filename> :
por exemplo, <filename>.../dists/stable/main/binary-i386/Packages</filename>.
O arquivo consiste de uma série de registros de múltiplas linhas, uma para
cada pacote disponível no diretório. Somente duas linhas em cada registro
são relevantes para definir prioridades do APT :
<variablelist>
<varlistentry>
<term>a linha <literal/Package:/</term>
<listitem><simpara>informa o nome do pacote</simpara></listitem>
</varlistentry>
<varlistentry>
<term>a linha <literal/Version:/</term>
<listitem><simpara>informa o número de versão do pacote</simpara></listitem>
</varlistentry>
</variablelist>
</para>

<para>O arquivo <filename>Release</filename> é normalmente encontrado no
diretório
<filename>.../dists/<replaceable>nome-distribuição</replaceable></filename> :
por exemplo, <filename>.../dists/stable/Release</filename>,
ou <filename>.../dists/woody/Release</filename>.
O arquivo consiste de um registro de múltiplas linhas o qual se aplica a
<emphasis/todas/ as instâncias de pacote na àrvore de diretórios abaixo
de seu diretório pai. Diferente do arquivo <filename/Packages/, quase
todas as linhas em um arquivo <filename/Release/ são relevantes para a
definição de prioridades do APT :

<variablelist>
<varlistentry>
<term>a linha <literal/Archive:/</term>
<listitem><simpara>dá nome ao repositório para o qual as instâncias de
pacote na àrvore de diretório pertencem. Por exemplo, a linha
<literal/Archive: stable/ especifica que todos os pacotes na àrvore de
diretório abaixo do diretório pai do arquivo <filename/Release/ estão
no respositório <literal/stable/.  Especificar esse valor no arquivo de
preferências do APT iria requerer a linha :
</simpara>

<programlisting>
Pin: release a=stable
</programlisting>
</listitem>
</varlistentry>

<varlistentry>
<term>a linha <literal/Version:/</term>
<listitem><simpara>dá nome a versão da distribuição. Por exemplo, as
instâncias de pacote na àrvore podem pertencer a distribuição Debian
GNU/Linux versão 3.0. Normalmente não existe número de versão para as
distribuições "testing" e "unstable" devido as mesmas não terem sido
lançadas ainda. Especificar isso no arquivo de preferências do APT
iria requerer uma das linhas a seguir.
</simpara>

<programlisting>
Pin: release v=3.0
Pin: release a=stable v=3.0
Pin: release 3.0
</programlisting>

</listitem>
</varlistentry>

<varlistentry>
<term>a linha <literal/Component:/</term>
<listitem><simpara>dá nome ao componente de licenciamento associado com
as instâncias de pacote na àrvore de diretório do arquivo
<filename/Release/. Por exemplo, a linha <literal/Component: main/
especifica que todas as instâncias na àrvore de diretório são do
componente <literal/main/, o que significa que as mesmas estão
licenciadas sob os termos da Linhas Guias Debian para o Software Livre
(a DFSG). Especificar esse componente no arquivo de preferências do APT
iria requerer a linha :
</simpara>

<programlisting>
Pin: release c=main
</programlisting>
</listitem>
</varlistentry>

<varlistentry>
<term>a linha <literal/Origin:/</term>
<listitem><simpara>dá nome ao produtor das instâncias de pacote na
àrvore de diretório do arquivo <filename/Release/. O mais comum é esse
valor ser <literal/Debian/.  Especificar essa origem no arquivo de
preferências do APT iria requerer a linha :
</simpara>

<programlisting>
Pin: release o=Debian
</programlisting>
</listitem>
</varlistentry>

<varlistentry>
<term>a linha <literal/Label:/</term>
<listitem><simpara>parece redundante. 
seems redundant. O mais comum é esse valor ser <literal/Debian/.
Especificar esse rótulo (label) no arquivo de preferências do APT
iria requerer a linha :
</simpara>

<programlisting>
Pin: release l=Debian
</programlisting>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>Todos os arquivos <filename>Packages</filename> e
<filename>Release</filename> obtidos das localidades listadas no arquivo
&sources-list; são mantidos no diretório
<filename>/var/lib/apt/lists</filename> ou no arquivo indicado pela variável
<literal/Dir::State::Lists/ no arquivo <filename/apt.conf/.
Por exemplo, o arquivo
<filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename>
contém o arquivo <filename>Release</filename> obtido do site
<literal/debian.lcs.mit.edu/ para a arquitetura <literal/binary-i386/,
arquivos do componente <literal/contrib/ da distribuição <literal/unstable/.
</para>

</RefSect2>

<RefSect2><Title>Linhas Opcionais em um Registro de Preferências do APT</Title>

<para>Cada registro em um arquivo de preferências do APT pode
opcionalmente iniciar com uma ou mais linhas iniciadas com a palavra
<literal/Explanation:/. Isto oferece uma oportunidade de se comentar
sobre o registro.
</para>

<para>A linha <literal/Pin-Priority:/ em cada registro de preferências do
APT é opcional. Caso omitida, o APT atribuirá uma prioridade de 1 menos o
último valor especificado em uma linha iniciando com
<literal/Pin-Priority: release .../.
</para>
</RefSect2>
</RefSect1>

<RefSect1><Title>Exemplos</>
<RefSect2><Title>Acompanhando a Stable</Title>

<para>O arquivo de preferências do APT a seguir fará com que o APT
atribua uma prioridade maior do que a prioridade padrão (500) para todos
as versões de pacote pertencentes a distribuição <literal/stable/ e uma
prioridade proibitivamente baixa para versões de pacotes pertencentes a
outras distribuições <literal/Debian/.

<programlisting>
Package: *
Pin: release a=stable
Pin-Priority: 900

Explanation: Desinstala ou não instala nenhuma instância originada do
Explanation: Debian a não ser aquelas na distribuição stable
Package: *
Pin: release o=Debian
Pin-Priority: -10
</programlisting>
</para>

<para>
Com um arquivo &sources-list; apropriado e o arquivo de preferências
acima, quaisquer um dos comandos a seguir farão com que o APT atualize
para a(s) ulítma(s) versão(ôes) <literal/stable/.

<programlisting>
apt-get install <replaceable>nome-pacote</replaceable>
apt-get upgrade
apt-get dist-upgrade
</programlisting>
</para>

<para>O comando a seguir fará com que o APT atualize o pacote
especificado para a última versão da distribuição <literal/testing/;
porém, atualizações futuras não irão ocorrer automaticamente.

<programlisting>
apt-get install <replaceable>pacote</replaceable>/testing
</programlisting>
</RefSect2>

 <RefSect2><Title>Acompanhando a Testing</Title>

<para>O arquivo de preferências do APT a seguir fará com que o
APT atribua uma prioridade maior para versões de pacote da distribuição
<literal/testing/, uma prioridade menor para versões de pacotes da
distribuição <literal/unstable/ e uma prioridade proibitivamente baixa
para versões de pacotes de outras distribuições <literal/Debian/.

<programlisting>
Package: *
Pin: release a=testing
Pin-Priority: 900

Package: *
Pin: release a=unstable
Pin-Priority: 800

Package: *
Pin: release o=Debian
Pin-Priority: -10
</programlisting>
</para>

<para>
Com o arquivo de preferências o APT acima, quaisquer dos
comandos a seguir farão com que o APT atualize para a(s)
última(s) versão(ões) <literal/testing/.

<programlisting>
apt-get install <replaceable>nome-pacote</replaceable>
apt-get upgrade
apt-get dist-upgrade
</programlisting>
</para>

<para>O comando a seguir fará com que o APT atualize o pacote
especificado para a última versão da distribuição <literal/unstable/.
Assim, o comando <command>apt-get dist-upgrade</command> e os outros
<emphasis/farão/ com que o pacote seja atualizado para a última versão
<literal/unstable/.

<programlisting>
apt-get install <replaceable>pacote</replaceable>/unstable
</programlisting>
</para>

</RefSect2>
</RefSect1>

 <RefSect1><Title>Consulte também</>
<para>
&apt-get; &apt-cache; &apt-conf; &sources-list;
 </RefSect1>

 &manbugs;
 &manauthor;
 &ptbr-mantranslator;

</refentry>