doc/pt_BR/apt_preferences.pt_BR.5

   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" "04 December 2006" "" ""
   7
   8 .SH NAME
   9 apt_preferences \- Arquivo de controle de preferências para o APT
  10 .SH "DESCRIçãO"
  11 .PP
  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.
  15 .PP
  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
  22 maior prioridade.
  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.
  26 .PP
  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"
  33 .PP
  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\&.
  43 Por exemplo,
  44
  45 .nf
  46 \fBapt-get install -t testing \fIalgum-pacote\fB\fR
  47 .fi
  48
  49 .nf
  50 APT::Default-Release "stable";
  51 .fi
  52 .PP
  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.
  55 Atribuirá :
  56 .TP
  57 \fBprioridade 100\fR
  58 para a instância que já esteja instalada (caso exista).
  59 .TP
  60 \fBprioridade 500\fR
  61 para as instâncias que não estã instaladas e que não pertencem a versão alvo.
  62 .TP
  63 \fBprioridade 990\fR
  64 para as instâncias que não estejam instaladas e pertençam a versão alvo.
  65 .PP
  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.
  69 .PP
  70 O APT aplica as regras a seguir, listadas em ordem de precedência, para
  71 determinar qual instância de um pacote instalar.
  72 .TP 0.2i
  73 \(bu
  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.)
  80 .TP 0.2i
  81 \(bu
  82 Instala a instância de prioridade mais alta.
  83 .TP 0.2i
  84 \(bu
  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
  87 versão).
  88 .TP 0.2i
  89 \(bu
  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
  93 desinstalada.
  94 .PP
  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.
 101 .PP
 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.
 107 .PP
 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"
 117 .PP
 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.
 122 .TP 0.2i
 123 \(bu
 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
 128 com "5.8".
 129
 130 .nf
 131 Package: perl
 132 Pin: version 5.8*
 133 Pin-Priority: 1001
 134 .fi
 135 .TP 0.2i
 136 \(bu
 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.
 142
 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.
 147
 148 .nf
 149 Package: *
 150 Pin: origin ""
 151 Pin-Priority: 999
 152 .fi
 153
 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".
 160
 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
 163 seja "unstable".
 164
 165 .nf
 166 Package: *
 167 Pin: release a=unstable
 168 Pin-Priority: 50
 169 .fi
 170
 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".
 174
 175 .nf
 176 Package: *
 177 Pin: release a=unstable, v=3.0
 178 Pin-Priority: 50
 179 .fi
 180 .SS "COMO O APT INTERPRETA PRIORIDADES"
 181 .PP
 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):
 185 .TP
 186 \fBP > 1000\fR
 187 faz com que uma instância seja instalada
 188 mesmo caso isso constitua um dowgrade do pacote
 189 .TP
 190 \fB990 < P <=1000\fR
 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
 194 .TP
 195 \fB500 < P <=990\fR
 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
 199 .TP
 200 \fB100 < P <=500\fR
 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
 204 .TP
 205 \fB0 <= P <=100\fR
 206 faz com que uma versão seja instalada
 207 somente caso não exista uma versão instalada do pacote
 208 .TP
 209 \fBP < 0\fR
 210 impede a versão de ser instalada
 211 .PP
 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.
 218 .PP
 219 Por exemplo, suponha que o arquivo de preferências do APT contenha
 220 os três registros apresentados anteriormente :
 221
 222 .nf
 223 Package: perl
 224 Pin: version 5.8*
 225 Pin-Priority: 1001
 226
 227 Package: *
 228 Pin: origin ""
 229 Pin-Priority: 999
 230
 231 Package: *
 232 Pin: release unstable
 233 Pin-Priority: 50
 234 .fi
 235 Então :
 236 .TP 0.2i
 237 \(bu
 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\&.
 243 .TP 0.2i
 244 \(bu
 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.
 248 .TP 0.2i
 249 \(bu
 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"
 256 .PP
 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.
 260 .PP
 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 :
 267 .TP
 268 \fBa linha Package:\fR
 269 informa o nome do pacote
 270 .TP
 271 \fBa linha Version:\fR
 272 informa o número de versão do pacote
 273 .PP
 274 O arquivo \fIRelease\fR é normalmente encontrado no
 275 diretório
 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
 283 prioridades do APT :
 284 .TP
 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
 288 "Archive: stable"
 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 :
 293
 294 .nf
 295 Pin: release a=stable
 296 .fi
 297 .TP
 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.
 305
 306 .nf
 307 Pin: release v=3.0
 308 Pin: release a=stable v=3.0
 309 Pin: release 3.0
 310 .fi
 311 .TP
 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 :
 320
 321 .nf
 322 Pin: release c=main
 323 .fi
 324 .TP
 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 :
 330
 331 .nf
 332 Pin: release o=Debian
 333 .fi
 334 .TP
 335 \fBa linha Label:\fR
 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
 339 linha :
 340
 341 .nf
 342 Pin: release l=Debian
 343 .fi
 344 .PP
 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"
 356 .PP
 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.
 360 .PP
 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 ...\&.
 365 .SH "EXEMPLOS"
 366 .SS "ACOMPANHANDO A STABLE"
 367 .PP
 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\&.
 373
 374 .nf
 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
 377 Package: *
 378 Pin: release a=stable
 379 Pin-Priority: 900
 380
 381 Package: *
 382 Pin: release o=Debian
 383 Pin-Priority: -10
 384 .fi
 385 .PP
 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\&.
 389
 390 .nf
 391 apt-get install \fInome-pacote\fR
 392 apt-get upgrade
 393 apt-get dist-upgrade
 394 .fi
 395 .PP
 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
 399 executado novamente.
 400
 401 .nf
 402 apt-get install \fIpacote\fR/testing
 403 .fi
 404 .SS "ACOMPANHANDO A TESTING"
 405 .PP
 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\&.
 411
 412 .nf
 413 Package: *
 414 Pin: release a=testing
 415 Pin-Priority: 900
 416
 417 Package: *
 418 Pin: release a=unstable
 419 Pin-Priority: 800
 420
 421 Package: *
 422 Pin: release o=Debian
 423 Pin-Priority: -10
 424 .fi
 425 .PP
 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\&.
 429
 430 .nf
 431 apt-get install \fInome-pacote\fR
 432 apt-get upgrade
 433 apt-get dist-upgrade
 434 .fi
 435 .PP
 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
 442 versão instalada.
 443
 444 .nf
 445 apt-get install \fIpacote\fR/unstable
 446 .fi
 447 .SH "CONSULTE TAMBéM"
 448 .PP
 449 \fBapt-get\fR(8) \fBapt-cache\fR(8) \fB\fIapt.conf\fB\fR(5) \fB\fIsources.list\fB\fR(5)
 450 .SH "BUGS"
 451 .PP
 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)\&.
 455 .SH "AUTHOR"
 456 .PP
 457 O APT foi escrito pela equipe APT <apt@packages.debian.org>\&.
 458 .SH "TRADUçãO"
 459 .PP
 460 Esta página de manual foi traduzida para o Português do Brasil por
 461 André Luís Lopes <andrelop@ig.com.br>\&.