apt_preferences

NOME

apt_preferences - Ficheiro de controle de preferências para o APT

DESCRIÇÃO

O ficheiro de preferências do APT /etc/apt/preferences e os ficheiros fragmentados no directório /etc/apt/preferences.d/ podem ser usados para controlar quais as versões de pacotes irão ser selecionadas para instalação. Várias versões de um pacote podem estar disponíveis para instalação quando o ficheiro sources.list(5) contém referências a mais do que uma distribuição (por exemplo, stable e testing). O APT atribui uma prioridade a cada versão que está disponível. Sujeito a constrangimentos de dependências, o apt-get seleciona a versão com a prioridade mais alta para instalação. As preferências do APT sobrepõem as prioridades que o APT atribui às versões de pacotes por predefinição, assim dando controle ao utilizador sobre qual é selecionado para instalação. Podem estar disponíveis várias instâncias da mesma versão de um pacote quando o ficheiro sources.list(5) contém referências a mais do que uma fonte. Neste caso o apt-get descarrega a instância listada mais cedo no ficheiro sources.list(5). As preferências do APT não afectam a escolha da instância, apenas a escolha da versão. As preferências são um poder forte nas mãos de um administrador de sistemas mas também se podem tornar no seu maior pesadelo se forem usadas sem cuidado! O APT não irá questionar as preferências, portanto as definições erradas irão acabar em pacotes não instaláveis ou decisões erradas ao actualizar pacotes. Irão surgir ainda mais problemas se forem misturadas múltiplas distribuições sem o perfeito entendimento dos parágrafos seguintes. Os pacotes incluídos num lançamento específico não são testados e por isso nem sempre funcionam como esperado nos lançamentos mais antigos ou recentes ou em conjunto com outros pacotes de lançamentos diferentes. Você foi avisado. Note que os ficheiros no directório /etc/apt/preferences.d são analisados em ordem alfanumérica ascendente e precisam obedecer à convenção de nomes seguinte: Os ficheiros ou não têm extensão ou têm "pref" na extensão do nome de ficheiro e apenas contêm caracteres alfanuméricos, traço (-), underscore (_) e ponto (.). Caso contrário o APT irá escrever um aviso de que ignorou um ficheiro, a menos que esse ficheiro corresponda a um padrão da lista de configuração Dir::Ignore-Files-Silently - e neste caso será ignorado em silêncio.

Atribuições de Prioridade Predefinidas do APT

Senão existir um ficheiro de preferências ou se não existe uma entrada no ficheiro que se aplique a uma versão particular então a prioridade atribuída a essa versão é a prioridade da distribuição à qual essa versão pertence. É possível definir uma distribuição singular, "o lançamento de destino", a qual recebe uma prioridade mais alta que as outras distribuições por predefinição. O lançamento de destino pode ser definido na linha de comandos do apt-get ou no ficheiro de configuração do APT /etc/apt/apt.conf. Note que isto tem precedências sobre qualquer prioridade geral que possa definir no ficheiro /etc/apt/preferences descrito mais tarde, mas não sobre pacotes especificamente imobilizados. Por exemplo, Se o lançamento destinado foi especificado, então o APT usa o seguinte algoritmo para definir as prioridades das versões de um pacote. Atribuir: priority 1 priority 100 priority 500 priority 990 A mais alta dessas prioridades cuja descrição coincide com a versão é especificada para a versão. Se o lançamento de destino não foi especificado, então o APT simplesmente atribui prioridade 100 a todas as versões de pacotes instalados e prioridade 500 e todas as versões de pacotes não instalados, à excepção de versões que venham de arquivos cujos ficheiros Release estejam marcados como "NotAutomatic: yes" - estas versões ficam com prioridade 1 ou prioridade 100 se for marcado adicionalmente como "ButAutomaticUpgrades: yes". O APT então aplica as seguintes regras, listadas em ordem de precedência, para determinar qual versão de um pacote deve instalar. Numa situação típica, a versão instalada de um pacote (prioridade 100) não é tão recente como uma das versões disponíveis nas fontes listadas no ficheiro sources.list(5) (prioridade 500 ou 990). Então o pacote será actualizado quando for executado apt-get install algum-pacote ou apt-get upgrade. Mais raramente, a versão instalada de um pacote é mais recente que qualquer das outras versões disponíveis. O pacote não será regredido para uma versão inferior quando for executado apt-get install algum-pacote ou apt-get upgrade. Por vezes a versão instalada de um pacote é mais recente que a versão pertencente ao lançamento de destino, mas não tão recente que uma versão pertencente a alguma outra distribuição. Tal pacote será de facto actualizado quando for executado apt-get install algum-pacote ou apt-get upgrade, porque pelo menos uma das versões disponíveis tem uma prioridade mais alta que a versão instalada.

Actualizações Faseadas

O APT compreende um campo chamado Phased-Update-Percentage que pode ser usado para controlar o lançamento de uma nova versão. É um número inteiro entre 0 e 100. A elegibilidade do sistema para uma actualização faseada é determinada ao semear a geração de número aleatório com o nome do pacote fonte, o número de versão, e /etc/id-de-máquina, e depois calcular um inteiro na gama [0, 100]. Se este inteiro for maior que Phased-Update-Percentage, a versão é fixada a 1, e assim mantida retida. Caso contrário, aplicam-se as regras políticas normais. No caso de você ter vários sistemas em que deseja receber o mesmo conjunto de actualizações, você pode definir APT::Machine-ID para um UUID tal que eles todos faseem o mesmo, ou definir APT::Get::Never-Include-Phased-Updates ou APT::Get::Always-Include-Phased-Updates para verdadeiro de modo a que o APT nunca/sempre considere actualizações faseadas.

O Efeito das Preferências do APT

O ficheiro de preferências do APT permite ao administrador do sistema controlar a atribuição de prioridades. O ficheiro consiste em um ou mais registos de multi-linhas separados por linhas vazias. Os registos podem ter um ou dois formatos, um formato específico e um formato geral. O efeito do operador vírgula é semelhante a um "e" lógico. Todas as condições têm de ser satisfeitas para o pin corresponder. Há uma excepção: Para qualquer tipo de condição (tal como duas condições "a"), apenas a última de tais condições é verificada.

Corresponder pacotes no campo Package

O campo Package especifica o pacote ao qual uma prioridade de fixação é aplicada. O campo pode ou conter um nome de pacote binário, um nome de pacote fonte (prefixado com "src:"), uma expressão glob(7) ou uma expressão regular (dentro de barras). Podem ser listados vários nomes de pacotes, expressões glob(7) e expressões regulares separados por espaços o que neste caso o registo irá corresponder a qualquer um dos pacotes correspondentes. Por predefinição, apenas pacotes da arquitectura nativa são correspondidos. Para corresponder pacotes binários de qualquer arquitectura, adicione o sufixo :any ao nome do pacote. Você pode também limitar a correspondência a uma arquitectura específica ao acrescentar o nome da arquitectura ao nome do pacote, separado pelo caractere dos dois pontos. Por exemplo, o seguinte exemplo usa uma expressão glob e uma expressão regular para designar a prioridade 500 a todos os pacotes de experimental onde o nome começa com gnome (como uma expressão tipo glob(7)) ou contém a palavra kde (como uma expressão regular extensa do POSIX rodeada de barras). A regra para essas expressões é que elas podem ocorrer em qualquer sítio onde uma string pode ocorrer. Assim, o seguinte pin designa a prioridade 990 a todos os pacotes de um lançamento que começa com lunar. Se ocorrer uma expressão regular num campo Package, o comportamento é o mesmo como se esta expressão regular fosse substituída por uma lista de todos os nomes de pacotes a que ela coincide. No entanto não está decidido se isto irá mudar no futuro; assim você deve sempre listar os pins "wild-card" primeiro, para que depois os pins específicos os sobreporem. O padrão "*" num campo Package não é considerado uma expressão glob(7) em si próprio. Para fixar todos os binários produzidos pelo pacote fonte do apt desta versão do APT para 990, você pode fazer: A fixação de pacote fonte pode ser combinada com expressões regulares e padrões glob, e também podem tomar uma arquitectura binária. Por exemplo, vamos fixar todos os binários para todas as arquitecturas produzidas por qualquer pacote fonte que contenha apt no seu nome para 990: O sufixo :any certifica a selecção de pacotes binários de qualquer arquitectura. Sem este sufixo, o apt assume implicitamente o sufixo :native o qual irá apenas selecionar pacotes da arquitectura nativa.

Como o APT Interpreta as Prioridades

As prioridades (P) atribuídas no ficheiro de preferências do APT têm de ser inteiros positivos ou negativos. Elas são interpretadas como o seguinte (falando grosso): P >= 1000 990 <= P < 1000 500 <= P < 990 100 <= P < 500 0 < P < 100 P < 0 P = 0 O primeiro registo de forma-especifica que corresponda a uma versão de pacote disponível determina a prioridade da versão do pacote. Falhando isso, a prioridade do pacote é definida como o máximo de todas as prioridades definidas por registos de forma-genérica que correspondam à versão. Os registos definidos que usem padrões diferentes de "*" no campo Pin são tratados como registos de forma-especifica. Por exemplo, suponha que o ficheiro de preferências do APT contém os três registos apresentados atrás: Então:

Determinação da Versão do Pacote e Propriedades da Distribuição

As localizações listadas no ficheiro sources.list(5) devem fornecer os ficheiros Packages e Release para descrever os pacotes disponíveis nessa localização. O ficheiro Packages é normalmente encontrado no directório .../dists/ nome-da-distribuição/componente/arquitectura: por exemplo, .../dists/stable/main/binary-i386/Packages. Consiste numa série de registos de várias linhas, um para cada pacote disponível nesse directório. Apenas duas linhas em cada registo são relevantes para definir prioridades do APT: a linha Package: a linha Version: O ficheiro Release fica normalmente no directório .../dists/ nome da distribuição: por exemplo, .../dists/stable/Release, ou .../dists/bookworm/Release. Consiste num único registo de várias linhas que se aplica a todos os pacotes na árvore de directórios sob o seu pai. Ao contrário do ficheiro Packages, quase todas as linhas num ficheiro Release são relevantes para definir as prioridades do APT: a linha Archive: ou Suite: a linha Codename: a linha Version: a linha Component: a linha Origin: a linha Label: Todos os ficheiros Packages e Release obtidos das localizações listadas no ficheiro sources.list(5) são armazenados no directório /var/lib/apt/lists, ou no ficheiro nomeado pela variável Dir::State::Lists no ficheiro apt.conf. Por exemplo, o ficheiro debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release contém o ficheiro Release obtido do site debian.lcs.mit.edu para ficheiros da arquitectura binary-i386 do componente contrib da distribuição unstable.

Linhas Opcionais num Registo de Preferências do APT

Cada registo no ficheiro de preferências do APT por começar opcionalmente com uma ou mais linhas começadas com a palavra Explanation:. Isto disponibiliza um espaço para comentários.

EXEMPLOS

Acompanhando Stable

O seguinte ficheiro de preferências do APT irá fazer com que o APT atribua uma prioridade mais alta que o predefinido (500) a todos as versões de pacotes que pertencem a uma distribuição stable e uma prioridade proibitivamente baixa a versões de pacotes pertencentes a outras distribuições Debian. Com um ficheiro sources.list(5) apropriado e o ficheiro de preferências acima, qualquer dos seguintes comandos irá fazer com que o APT actualize para as versões stable mais recentes. O seguinte comandos irá fazer com que o APT actualize o pacote especificado para a versão mais recente da distribuição testing; o pacote não será actualizado de novo a menos que seja executado este comando outra vez.

Acompanhando Testing ou Unstable

O seguinte ficheiro de preferências do APT irá fazer com que o APT atribua uma prioridade alta a versões de pacotes da distribuição testing, uma prioridade mais baixa a versões de pacotes da distribuição unstable, e uma prioridade proibitivamente baixa a versões de pacotes de outras distribuições Debian. Com um ficheiro sources.list(5) apropriado e o ficheiro de preferências acima, qualquer dos seguintes comandos irá fazer com que o APT actualize para as versões testing mais recentes. O comando seguinte irá fazer com que o APT actualize o pacote especificado para a versão mais recente da distribuição unstable. Posteriormente, o apt-get upgrade irá actualizar o pacote para a versão testing mais recente se essa for mais recente que a versão instalada, caso contrário, para a versão unstable mais recente se essa for mais recente que a versão instalada.

Acompanhando a evolução de um nome de código de lançamento

O seguinte ficheiro de preferências do APT irá fazer com que o APT atribua uma prioridade mais alta que a predefinida (500) a todas as versões de pacotes pertencentes a um nome de código especificado de uma distribuição com uma prioridade proibitivamente baixa a versões de pacotes pertencentes a outras distribuições, nomes de código ou arquivos Debian. Note que com estas preferências o APT irá seguir a migração de um lançamento a partir do arquivo testing para stable e mais tarde oldstable. Se você que seguir por exemplo o progresso em testing não obstante as alterações do nome de código, você deve usar as configurações exemplo acima. Com um ficheiro sources.list(5) apropriado e o ficheiro de preferências acima, qualquer dos seguintes comandos fará com que o APT actualize para a versão mais recente no lançamento com nome de código trixie. O seguinte comando irá fazer com que o APT actualize o pacote especificado para a versão mais recente da distribuição sid. Posteriormente, apt-get upgrade irá actualizar o pacote para a versão trixie mais recente se essa for mais recente que a versão instalada, caso contrário, para a versão sid mais recente se essa for mais recente que a versão instalada.

FICHEIROS

/etc/apt/preferences /etc/apt/preferences.d/

VEJA TAMBÉM

apt-get(8) apt-cache(8) apt.conf(5) sources.list(5)

BUGS

página de bugs do APT[1]. Se deseja reportar um bug no APT, por favor veja /usr/share/doc/debian/bug-reporting.txt ou o comando reportbug(1).

TRADUÇÃO

A tradução Portuguesa foi feita por Américo Monteiro <[email protected]> de 2009 a 2012. A tradução foi revista pela equipa de traduções portuguesas da Debian <[email protected]>. Note que este documento traduzido pode conter partes não traduzidas. Isto é feito propositadamente, para evitar perdas de conteúdo quando a tradução está atrasada relativamente ao conteúdo original.

AUTOR

Equipa do APT

NOTAS

1.

página de bugs do APT