Provided by:
apt_0.8.3ubuntu7_i386 
NAME
apt.conf - Ficheiro de configuracao para o APT
DESCRI,c~aO
apt.conf e o ficheiro de configuracao principal para a suite de
ferramentas do APT, as nao e o unico lugar onde se podem fazer
alteracoes as opcoes. Entao todas as ferramentas partilham os ficheiros
de configuracao e tambem usam um analisador de linha de comandos comum
para disponibilizar um ambiente uniforme.
Quando a ferramenta APT arranca ira ler os ficheiros de configuracao
pela seguinte ordem:
1. o ficheiro especificado pela variavel de ambiente APT_CONFIG (se
existir)
2. todos os ficheiros em Dir::Etc::Parts em ordem ascendente
alfanumerica sem extensao ou com "conf" como extensao do nome de
ficheiro e que apenas contem caracteres alfanumericos, traco (-),
underscore (_) e ponto (.) - caso contrario serao ignorados em
silencio.
3. o ficheiro de configuracao principal especificado por
Dir::Etc::main
4. as opcoes de linha de comandos sao aplicadas para sobrepor as
directivas de configuracao ou para carregar mais ficheiros de
configuracao.
SINTAXE
O ficheiro de configuracao e organizado numa arvore com as opcoes
organizadas em grupos de funcionamento. A especificacao das opcoes e
dada com um sinal de dois pontos duplo , por exemplo
APT::Get::Assume-Yes e uma opcao dentro do grupo de ferramentas do APT,
para a ferramenta Get. A opcoes nao herdam dos seus grupos parentes.
Sintacticamente a linguagem de configuracao e modelada apos o que as
ferramentas ISC usam, como o bind e o dhcp. As linhas que comecam com
// sao tratadas como comentarios (ignoradas), assim como todo o texto
entre /* e */, tal como os comentarios de C/C++. Cada linha e do
formato APT::Get::Assume-Yes "true";. O ponto e virgula a direita e as
aspas sao necessarias. O valor deve estar numa linha, e nao ha nenhum
tipo de concatenacao de string. Nao pode incluir aspas interiores. O
comportamento da backslash "\" e caracteres de escape dentro de um
valor e indefinido e nao deve ser usado. Um nome de opcao pode incluir
caracteres alfanumericos e os caracteres "/-:._+". Um novo scope pode
ser aberto com chavetas, como:
APT {
Get {
Assume-Yes "true";
Fix-Broken "true";
};
};
com novas linhas colocadas para o tornar mais legivel. As listas podem
ser criadas ao abrir um scope e incluindo uma string unica entre aspas
seguida por um ponto e virgula. Podem ser incluidas multiplas entradas,
cada uma separada por um ponto e virgula (;).
DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
Em geral o exemplo de ficheiro de configuracao em
/usr/share/doc/apt/examples/apt.conf
/usr/share/doc/apt/examples/configure-index.gz e um bom guia de como
deve ficar.
Os nomes dos items de configuracao nao sao sensiveis a
maiusculas/minusculas. Portanto no exemplo previo voce poderia usar
dpkg::pre-install-pkgs.
Os nomes dos items de configuracao sao opcionais se uma lista for
definida com pode ser vista no exemplo DPkg::Pre-Install-Pkgs acima. Se
voce nao especificar um nome, uma nova entrada ira simplesmente
adicionar uma nova opcao a lista. Se voce especificar um nome, voce
pode sobrepor a opcao como qualquer outra opcao ao re-atribuir um novo
valor a opcao.
Sao permitidas duas especiais, #include (a qual esta obsoleta e nao e
suportada por implementacoes alternativas) e #clear: #include ira
incluir o ficheiro fornecido, a menos que o nome do ficheiro termine
numa barra (/), entao todo o directorio e incluido. #clear e usado
para apagar uma parte da arvore de configuracao. O elemento
especificado e os seus descendentes sao apagados. (Note que estas
linhas tambem precisam de acabar com um 'ponto e virgula' (;) .)
O comando #clear e a unica maneira de apagar uma lista ou um scope
completo. Reabrindo um scope ou o ::-style descrito abaixo n~ao ira
sobrepor entradas escritas anteriormente. Apenas as opcoes podem ser
sobrepostas ao atribuir um novo valor a elas - listas e scopes nao
podem ser sobrepostos, apenas limpos.
Todas as ferramentas do APT recebem uma opcao -o que permite uma
directiva de configuracao arbitraria para ser especificada na linha de
comandos. A sintaxe e um nome de opcao completo (APT::Get::Assume-Yes
por exemplo) seguido por um igual (=) e depois o valor da opcao. Tambem
pode ser acrescentadas listas ao adicionar um duplo dois-pontos (::) a
direita para o nome da lista. (Como deve suspeitar: A sintaxe de scope
nao pode ser usada na linha de comandos.)
Note que voce apenas pode usar :: para acrescentar um item por linha a
uma lista e nao o deve usar em combinacao com a sintaxe scope. (A
sintaxe scope implicitamente insere ::). Usar ambas as sintaxes
juntamente ira disparar um bug que infelizmente alguns utilizadores nos
transmitem: Uma opcao com o nome nao usual "::" a qual actua como
qualquer outra opcao com um nome. Isto introduz muitos problemas
incluindo que, um utilizador que escreve multiplas linhas nesta sintaxe
errada na esperanca de acrescentar a uma lista, ira ganhar o oposto
porque apenas a ultima atribuicao para esta opcao "::" sera a usada.
Futuras versoes do APT ira levantar erros e parar de funcionar se
encontrarem esta ma utilizacao, portanto por favor corrija tais
declaracoes agora enquanto o APT nao se queixa explicitamente acerca
delas.
O GRUPO APT
Este grupo de opcoes controla o comportamento geral do APT assim como
mantem as opcoes para todas as ferramentas.
Architecture
System Architecture; define a arquitectura a usar quando procura
ficheiros e analisa listas de pacotes. A predefinicao interna e a
arquitectura para a qual o APT foi compilado.
Default-Release
Lancamento predefinido de onde instalar pacotes se existir mais de
uma versao disponivel. Contem o nome do lancamento, nome de codigo
ou versao de lancamento. Exemplos: 'stable', 'testing', 'unstable',
'lenny', 'squeeze', '4.0', '5.0*'. Veja tambem apt_preferences(5).
Ignore-Hold
Ignore Held packages; Esta opcao global faz com que ao resolver
problemas, os pacotes segurados sejam ignorados na sua decisao de
marcacao.
Clean-Installed
A predefinicao e ligada. Quando ligada, a funcionalidade autoclean
ira remover quaisquer pacotes que ja nao possam ser descarregados a
partir da cache. Se desligada, entao os pacotes que estao
instalados localmente sao tambem excluidos da limpeza - mas note
que o APT nao disponibiliza um meio directo de os reinstalar.
Immediate-Configure
A predefinicao e ligado o que ira fazer com que o APT instale
pacotes essenciais e importantes o mais rapido possivel na operacao
de instalar/actualizar. Isto e feito para limitar o efeito de uma
chamada falhada do dpkg(1). Se esta opcao for desactivada, o APT
trata um pacote importante do mesmo modo que um pacote extra: Entre
o desempacotamento do pacote importante A e a sua configuracao
podem acontecer muitas outras chamadas de desempacotamento e
configuracao, exemplo, para o pacote B que nao tem nenhuma relacao
com A, mas causa uma falha na chamada ao dpkg (ex, porque o script
do responsavel do pacote B gera um erro) o qual resulta num estado
do sistema em que o pacote A esta desempacotado mas ainda nao
configurado - ja nao se garante o funcionamento de cada pacote que
depende de A porque a sua dependencia ja nao esta satisfeita. O
marcador de configuracao imediata e tambem aplicado a todas as
dependencias que possam gerar um problema se as dependencias, ex,
formam um circulo como uma dependencia com a marca de imediato a
ser comparavel com uma Pre-Dependencia. Portanto, em teoria, e
possivel que o APT encontre uma situacao na qual e incapaz de
executar configuracao imediata, entre em erro e refira esta opcao
para que o utilizador possa desactivar temporariamente a
configuracao imediata para ser capaz de executar uma
instalacao/actualizacao outra vez. Note o uso da palavra "teoria"
aqui pois este problema foi poucas vezes encontrado ate agora no
mundo real em versoes de distribuicao nao-estaveis e causados por
dependencias erradas do pacote em questao ou por um sistema ja num
estado corrompido, portanto voce nao deve desactivar esta opcao as
cegas porque, em primeiro lugar, o cenario mencionado acima nao e o
unico problema que a configuracao imediata pode ajudar a prevenir.
Antes de uma grande operacao como dist-upgrade ser corrida com esta
opcao desactivada, deve ser tentado primeiro fazer um install
explicito ao pacote que o APT e incapaz de configurar
imediatamente, mas por favor certifique-se de tambem relatar o seu
problema a sua distribuicao e a equipa do APT com o link de bug
abaixo para que possam trabalhar na melhoria ou correccao do
processo de actualizacao.
Force-LoopBreak
Nunca Active esta opcao a menos que saiba -realmente- o que esta a
fazer. Permite ao APT remover temporariamente um pacote essencial
para interromper um ciclo vicioso de Conflitos/Conflitos ou
Conflitos/Pre-Dependencia entre dois pacotes essenciais. TAL CICLO
VICIOSO NAO DEVERA NUNCA EXISTIR E E UM GRAVE BUG. Esta opcao
devera funcionar se os pacotes essenciais nao forem tar, gzip,
libc, dpkg, bash ou qualquer coisa de que estes dependem.
Cache-Start, Cache-Grow e Cache-Limit
O APT usa desde a versao 0.7.26 um ficheiro de cache com mapa de
memoria de tamanho ajustavel para armazenar a informacao
disponivel. Cache-Start actua como uma dica para que tamanho a
Cache ira crescer e e por isso a quantidade de memoria que o APT
ira requerer no arranque. O valor predefinido e 20971520 bytes (~20
MB). Note que esta quantidade de espaco precisa estar disponivel
para o APT caso contrario ele ira con certeza falhar, portanto para
dispositivos com pouca memoria este valor deve ser diminuido
enquanto que em sistemas com muitas fontes configuradas este pode
ser aumentado. Cache-Grow define em bytes com a predefinicao de
1048576 (~1 MB) quanto o tamanho da Cache sera aumentado no caso do
espaco definido por Cache-Start nao ser suficiente. Este valor sera
aplicado varias vezes ate que a cache seja suficientemente grande
para armazenar toda a informacao ou que o tamanho da cache alcance
o Cache-Limit. O valor predefinido de Cache-Limit e 0 o que
significa nenhum limite. Se Cache-Grow for definido para 0, o
crescimento automatico da cache e desactivado.
Build-Essential
Define quais pacote(s) sao considerados dependencias essenciais de
compilacao.
Get
A subseccao Get controla a ferramenta apt-get(8), por favor veja a
sua documentacao para mais informacao acerca das opcoes daqui.
Cache
A subseccao Cache controla a ferramenta apt-cache(8), por favor
veja a sua documentacao para mais informacao acerca das opcoes
daqui.
CDROM
A subseccao CDROM controla a ferramenta apt-cdrom(8), por favor
veja a sua documentacao para mais informacao acerca das opcoes de
aqui.
O GRUPO ACQUIRE
O grupo de opcoes Acquire controla a descarga de pacotes e os
manipuladores de URI.
Check-Valid-Until
Opcao relacionada com seguranca com predefinicao a 'verdadeiro'
como uma validacao expirada para um ficheiro Release previne
ataques repetidos durante longo tempo e pode, por exemplo, ajudar
os utilizadores a identificar mirrors que nao sao actualizados a
muito tempo - mas a funcionalidade depende da precisao de hora no
sistema do utilizador. Os responsaveis do arquivo sao encorajados a
criar ficheiros Release com o cabecalho Valid-Until, mas se nao o
fizerem ou se preferir-se um valor mais rigoroso pode-se usar a
opcao Max-ValidTime seguinte.
Max-ValidTime
Segundos em que o ficheiro Release deve considerado valido apos ser
criado. A predefinicao e "para sempre" (0) se o ficheiro Release do
arquivo nao conter um cabecalho Valid-Until. Se o tiver entao esta
data e a predefinida. A data do ficheiro Release ou a data
especificada pela hora de criacao do do ficheiro Release (cabecalho
Date) mais os segundos especificados com esta opcao sao usados para
verificar se a validacao de um ficheiro ja expirou ao usar uma data
anterior as duas. Definicoes especificas do Arquivo podem ser
feitas ao adicionar a etiqueta do arquivo ao nome da opcao.
PDiffs
Tenta descarregar deltas chamados PDiffs para Pacotes ou ficheiros
Fonte em vez de os descarregar por inteiro. Verdadeiro por
predefinicao.
Estao tambem disponiveis duas sub-opcoes para limitar o uso de
PDiffs: Com FileLimit pode ser especificado quantos ficheiros PDiff
sao descarregados no maximo para aplicar um patch a um ficheiro.
Por outro lado SizeLimit e a percentagem maxima do tamanho de todas
as patches comparadas com o tamanho do ficheiro de destino. Se um
destes limites for excedido, e descarregado o ficheiro completo em
vez das patches.
Queue-Mode
Modo de fila; Queue-Mode pode ser um de host ou access que
determina como o APT paraleliza ligacoes de saida. host significa
que sera aberta uma ligacao por maquina destino, access significa
que sera aberta uma ligacao por tipo de URI.
Retries
Numero de tentativas a executar. Se isto for diferente de zero o
APT ira tentar, no numero fornecido de vezes, obter ficheiros
falhados.
Source-Symlinks
Usa links simbolicos para arquivos fonte. Se definido para
verdadeiro, entao os arquivos fonte serao links simbolicos, quando
possivel, em vez de copias. A predefinicao e verdadeiro.
http
HTTP URIs; http::Proxy e o proxy http predefinido a usar. Esta no
formato standard de http://[[user][:pass]@]host[:port]/. Tambem
pode ser especificados proxies por maquina ao usar o formato
http::Proxy::<host> com a palavra chave especial DIRECT que
significa nao usar proxies. Se nenhuma das definicoes acima for
especificada, sera usada a variavel de ambiente http_proxy.
Sao disponibilizadas tres definicoes para controle de cache como
caches de proxy compativeis com HTTP/1.1. No-Cache diz ao proxy
para nao usar a sua resposta em cache sob nenhumas circunstancias,
Max-Age e enviado apenas para ficheiros de indice e diz a cache
para refrescar o seu objecto se for mais antigo que o numero de
segundos fornecido. Debian actualiza os seus ficheiros indice
diariamente, portanto a predefinicao e 1 dia. No-Store especifica
que a cache nunca devera armazenar este requisito, e apenas
definido para ficheiros de arquivo. Isto pode ser util para
prevenir a poluicao de uma cache proxy com ficheiros .deb muito
grandes. Nota: o Squid 2.0.2 nao suporta nenhuma destas opcoes.
A opcao timeout define o tempo limite usado por este metodo, isto
aplica-se a todas as coisas incluindo tempos limite de ligacao e
tempos limite de dados.
E disponibilizada uma definicao para controlar a profundidade do
pipeline em casos onde o servidor remoto nao e compativel com RFC
ou e buggy (como o Squid 2.0.2). Acquire::http::Pipeline-Depth
pode ser um valor de 0 a 5 que indica quantos requerimentos
pendentes o APT deve enviar. TEM de ser especificado um valor de 0
se a maquina remota nao hesitar propriamente em ligacoes TCP - de
outro modo ira ocorrer corrupcao de dados. As maquinas que requerem
isto estao em violacao de RFC 2068.
A largura de banda usada pode ser limitada com
Acquire::http::Dl-Limit que aceita valores inteiros em kilobytes. O
valor predefinido e 0 que desactiva o limite e tenta usar o maximo
possivel da largura de banda (Note que esta opcao implicita
desactiva a descarga de multiplos servidores ao mesmo tempo.)
Acquire::http::User-Agent pode ser usado para definir um
Utilizador-Agente diferente para o metodo de download por http,
porque alguns proxies apenas permitem acesso a clientes se o
cliente usar um identificador conhecido.
https
HTTPS URIs. as opcoes Cache-control, Timeout, AllowRedirect,
Dl-Limit e proxy sao as mesmas para o metodo http e ira tambem usar
as opcoes predefinidas do metodo http se nao forem explicitamente
definidas para https. A opcao Pipeline-Depth ainda nao e suportada.
A sub-opcao CaInfo especifica o lugar do ficheiro que contem
informacao acerca de certificados de confianca. <host>::CaInfo e a
opcao por maquina correspondente. A sub-opcao booleana Verify-Peer
determina se o certificado da maquina servidora e um certificado de
confianca ou nao. <host>::Verify-Peer e a opcao por maquina
correspondente. A sub-opcao Verify-Host determina se o nome da
maquina servidora e verificado ou nao. <host>::Verify-Host e a
opcao por maquina correspondente. SslCert determina qual
certificado a usar para autenticacao de clientes <host>::SslCert e
a opcao por maquina correspondente. SslKey determina qual chave
privada a usar para autenticacao de clientes. <host>::SslKey e a
opcao por maquina correspondente. SslForceVersion sobrepoe a
versao SSL predefinida a usar. Pode conter strings 'TLSv1' ou
'SSLv3'. <host>::SslForceVersion e a opcao po maquina
correspondente.
ftp
URIs FTP; ftp::Proxy e o proxy ftp predefinido a usar. Esta no
formato standard de ftp://[[user][:pass]@]host[:port]/. Os proxies
por maquina podem tambem ser especificados ao usar o formato
ftp::Proxy::<host> com a palavra chave especial DIRECT que
significa nao usar nenhum proxy. Se nenhuma das definicoes acima
for especificada, sera usada a variavel de ambiente ftp_proxy. Para
usar um proxy ftp voce tem que definir o script ftp::ProxyLogin no
ficheiro de configuracao. Esta entrada especifica os comandos a
enviar para dizer ao servidor proxy ao que se ligar. Por favor veja
/usr/share/doc/apt/examples/configure-index.gz para um exemplo de
como fazer isto. As variaveis de substituicao disponiveis sao
$(PROXY_USER) $(PROXY_PASS) $(SITE_USER) $(SITE_PASS) $(SITE) e
$(SITE_PORT). Cada uma e tirada do seu componente URI respectivo.
A opcao timeout define o tempo limite usado por este metodo, isto
aplica-se a todas as coisas incluindo tempos limite de ligacao e
tempos limite de dados.
Sao disponibilizadas varias definicoes para controlar o modo
passivo. Geralmente e seguro deixar o modo passivo ligado, funciona
em quase todos ambientes. No entanto algumas situacoes requerem que
o modo passivo seja desactivado e em vez disso usar o modo port
ftp. Isto pode ser feito globalmente, para ligacoes que passam por
um proxy ou para uma maquina especifica (Veja a amostra de ficheiro
de configuracao para exemplos).
E possivel usar proxy FTP sobre HTTP ao definir a variavel de
ambiente ftp_proxy para um url http - veja a discussao do metodo
http em cima para a sintaxe. Voce nao pode definir isto no ficheiro
de configuracao e nao e recomendado usar FTP sobre HTTP devido a
sua baixa eficiencia.
A definicao ForceExtended controla o uso de comandos RFC2428 EPSV e
EPRT. A predefinicao e falso, o que significa que estes comandos
apenas sao usados se a ligacao de controle for IPv6. Definir isto
para verdadeiro forca o seu uso mesmo em ligacoes IPv4. Note que a
maioria dos servidores FTP nao suporta RFC2428.
cdrom
CDROM URIs; a unica definicao para URIs de CDROM e o ponto de
montagem, cdrom::Mount que deve ser o ponto de montagem para a
drive de CDROM como especificado em /etc/fstab. E possivel fornecer
comandos de montar e desmontar alternativos se o seu ponto de
montagem nao puder ser listado na fstab (como uma montagem SMB e
pacotes de montagem antiga). A sintaxe e colocar
/cdrom/::Mount "foo";
dentro do bloco cdrom. E importante ter a barra final. Comandos
para desmontar podem ser especificados usando UMount.
gpgv
GPGV URIs;a unica opcao para GPGV URIs e a opcao para passar
parametros adicionais ao gpgv. gpgv::Options Opcoes adicionais
passadas ao gpgv.
CompressionTypes
Lista dos tipos de compressao que sao compreendidos pelos metodos
de aquisicao. Ficheiros como Packages podem estar disponiveis em
varios formatos de compressao. Por predefinicao os metodos de
aquisicao podem descomprimir ficheiros comprimidos em bzip2, lzma e
gzip, mais formatos podem ser adicionados na hora com esta
definicao ou o metodo usado pode ser alterado. A sintaxe para isto
e:
Acquire::CompressionTypes::Extens~ao de Ficheiro "Nome de m'etodo";
Tambem o subgrupo Order pode ser usado para definir em que ordem o
sistema de aquisicao ira tentar descarregar os ficheiros
comprimidos. O sistema de aquisicao ira tentar com o primeiro e
prosseguir com o proximo tipo de compressao na lista em caso de
erro, portanto para preferir um sobre outro tipo, simplesmente
adicione o tipo preferido em primeiro lugar - tipos predefinidos
nao ja adicionados serao adicionados em tempo de execucao ao fim da
lista, entao, ex.
Acquire::CompressionTypes::Order:: "gz";
pode ser usado para preferir ficheiros comprimidos em gzip sobre
bzip2 e lzma. Se o lzma deve ser preferido sobre gzip e bzip2 a
definicao de configuracao devera parecer-se com isto:
Acquire::CompressionTypes::Order { "lzma"; "gz"; };
. Nao e necessario adicionar explicitamente bz2 a lista pois sera
adicionado automaticamente.
Note que em tempo de execucao sera verificado o Dir::Bin::nome de
m'etodo: se esta definicao existir, o metodo apenas sera usado se
este ficheiro existir, ex. para o metodo bzip2 (o embutido) a
definicao e
Dir::Bin::bzip2 "/bin/bzip2";
. Note tambem que as entradas na lista especificadas na linha de
comandos serao adicionadas no fim da lista especificada nos
ficheiros de configuracao, mas antes das entradas predefinidas.
Para preferir um tipo neste caso sobre aqueles especificados nos
ficheiros de configuracao voce pode definir a opcao directamente -
nao em estilo de lista. Isto nao ira sobrepor a lista definida, ira
apenas prefixar a lista com este tipo.
Apesar de ser possivel de adicionar um tipo de compressao vazio a
lista de ordem, o APT na sua versao actual nao o compreende
correctamente e ira mostrar muitos avisos acerca de ficheiros nao
descarregados - estes avisos sao na maioria vezes falsos positivos.
Futuras versoes irao talvez incluir um modo de realmente preferir
ficheiros nao-comprimidos para suportar a utilizacao de mirrors
locais.
GzipIndexes
Quando descarrega indices comprimidos em gzip (Pacotes, Fontes ou
Traducoes), mantem-os localmente comprimidos em gzip em vez de os
desempacotar. Isto poupa imenso espaco no disco a custa de mais
pedidos a CPU quando constroi as caches de pacotes locais. Falso
por predefinicao.
Languages
A subseccao Languages controla quais ficheiros Translation sao
descarregados e em que ordem o APT tenta mostrar as Traducoes das
Descricoes. O APT ira tentar mostra a primeira Descricao disponivel
para a Linguagem que esta listada em primeiro. As linguagens podem
ser definidas com os seus codigos de linguagem curtos ou longos.
Note que nem todos os arquivos disponibilizam ficheiros Translation
para todas as Linguagens - especialmente os codigos de linguagem
longos sao raros, portanto por favor informe-se sobre os quais
estao disponiveis antes de definir aqui valores impossiveis.
A lista predefinida inclui "environment" e "en". "environment" tem
um significado especial aqui: sera substituida em tempo de execucao
por codigos de linguagem extraidos a partir da variavel de ambiente
LC_MESSAGES. Tambem ira assegurar que estes codigos nao sao
incluidos duas vezes na lista. Se LC_MESSAGES estiver definida para
"C" apenas o ficheiro Translation-en sera usado (se disponivel).
Para forcar o apt a nao usar nenhum ficheiro de traducao use a
definicao Acquire::Languages=none. "none" e outro codigo de
significado especial que ira parar a procura por um ficheiro
Translation apropriado. Isto pode ser usado pelo administrador do
sistema para dizer ao APT que deve tambem descarregar estes
ficheiros sem realmente os usar, se o ambiente nao especificar
estas linguagens. Portanto o seguinte exemplo de configuracao ira
resultar na ordem "en, de" num ambiente em ingles e "de, en" num
ambiente em alemao. Note que o "fr" e descarregado, mas nao e usado
se o APT nao for usado num ambiente em frances, em tal ambiente a
ordem deveria ser "fr, de, en".
Acquire::Languages { "environment"; "de"; "en"; "none"; "fr"; };
DIRECTORIES
A seccao Dir::State tem directorios que pertencem a informacao de
estado local. lists e o directorio para colocar listas de pacotes
descarregadas e status e o nome do ficheiro de estado do dpkg.
preferences e o nome do ficheiro de preferencias do APT. Dir::State
contem o directorio predefinido para pre-fixar em todos os sub items
que nao comecam com / ou ./.
Dir::Cache contem localizacoes pertencentes a informacao da cache
local, como as caches de dois pacotes srcpkgcache e pkgcache assim como
a localizacao onde colocar arquivos descarregados,
Dir::Cache::archives. A geracao de caches pode ser desligada ao definir
os seus nomes para vazio. Isto ira abrandar o arranque mas poupar
espaco em disco. Provavelmente e preferivel desligar o pkgcache em vez
do srcpkgcache. Tal como Dir::State o directorio predefinido e contido
em Dir::Cache
Dir::Etc contem a localizacao dos ficheiros de configuracao, sourcelist
fornece a localizacao da sourcelist e main e o ficheiro da configuracao
predefinida (definicao nao tem efeito, a menos que seja feita a partir
do ficheiro de configuracao especificado por APT_CONFIG).
A definicao Dir::Parts le todos os fragmentos de configuracao em ordem
lexica a partir do directorio especificado. Apos isto estar feito entao
e carregado o ficheiro de configuracao principal.
Programas binarios sao apontados por Dir::Bin. Dir::Bin::Methods
especifica a localizacao dos manipuladores do metodo e de gzip, bzip2,
lzma, dpkg, apt-get dpkg-source dpkg-buildpackage e apt-cache
especifica a localizacao dos respectivos programas.
O item de configuracao RootDir tem um significado especial. Se
definido, todos os caminhos em Dir:: serao relativos a RootDir, mesmo
caminhos que est~ao absolutamente especificados. Entao, por exemplo, se
RootDir estiver definido para /tmp/staging e Dir::State::status estiver
definido para /var/lib/dpkg/status, entao o ficheiro status sera
procurado em /tmp/staging/var/lib/dpkg/status.
A lista Ignore-Files-Silently pode ser usada para especificar quais os
ficheiros que o APT deve ignorar em silencio enquanto analisa os
ficheiros nos directorios de fragmento. Por predefinicao que termine
com .disabled, ~, .bak ou .dpkg-[a-z]+ e ignorado em silencio. Como
visto no ultimo valor predefinido, estes padroes podem usar sintaxe de
expressao regular.
APT EM DSELECT
Quando o APT e usado com um metodo dselect(1), varias directivas de
configuracao controlam o comportamento predefinido. Estas estao na
seccao DSelect.
Clean
Modo Cache Clean: este valor deve ser um de always, prompt, auto,
pre-auto e never. always e prompt irao remover todos os pacotes da
cache apos a actualizacao, prompt (a predefinicao) fa-lo
condicionalmente. auto remove apenas aqueles pacotes que ja nao
podem ser descarregados (por exemplo, substituidos por uma nova
versao). pre-auto executa esta accao antes de descarregar novos
pacotes.
opcoes
O conteudo desta variavel e passado ao apt-get(8) como opcoes de
linha de comandos quando e corrido para a fase de instalacao.
Updateoptions
O conteudo desta variavel e passado ao apt-get(8) como opcoes de
linha de comandos quando e executado para a fase de actualizacao.
PromptAfterUpdate
Se for verdadeira a operacao [U]pdate no dselect(1) ira sempre
avisar para continuar. A predefinicao e avisar apenas em caso de
erro.
COMO O APT CHAMA O DPKG
Varias directivas de configuracao controlam como o APT invoca o invokes
dpkg(1). Estas estao na seccao DPkg.
opcoes
Isto e uma lista de opcoes para passar ao dpkg. As opcoes tem de
ser especificadas usando a notacao de lista e cada item da lista e
passado como um argumento unico ao dpkg(1).
Pre-Invoke, Post-Invoke
Isto e uma lista de comandos shell para executar antes/apos invocar
o dpkg(1). Tal como as opcoes isto tem que ser especificado em
notacao listada. Os comandos sao invocados em ordem usando /bin/sh,
caso algum deles falhe, o APT ira abortar.
Pre-Install-Pkgs
Isto e uma lista de comandos shell para executar antes de invocar o
dpkg(1). Tal como as opcoes isto tem que ser especificado em
notacao listada. Os comandos sao invocados em ordem usando /bin/sh,
caso algum deles falhe, o APT ira abortar. O APT passa para os
comandos na entrada standard os nomes de ficheiros de todos os
ficheiros .deb que vai instalar, um por cada linha.
A versao 2 deste protocolo despeja mais informacao, incluindo a
versao de protocolo, o espaco de configuracao do APT e os pacotes,
ficheiros e versoes que foram alteradas. A versao 2 e activada ao
definir DPkg::Tools::options::cmd::Version a 2. cmd e um comando
dado ao Pre-Install-Pkgs.
Run-Directory
O APT muda para este directorio (chdir) antes de invocar o dpkg, a
predefinicao e /.
Build-options
Estas opcoes sao passadas ao dpkg-buildpackage(1) quando compila
pacotes, a predefinicao e desactivar a assinatura e produzir todos
os binarios.
Utiliza,c~ao trigger do dpkg (e op,c~oes relacionadas)
APT pode chamar o dpkg num modo que faz uso agressivo dos triggers
sobre multiplas chamadas do dpkg. Sem mais opcoes o dpkg ira usar
triggers apenas entre a sua propria execucao. Activando estas opcoes
pode portanto diminuir o tempo necessario para executar a instalacao /
actualizacao. Note que e intencao futura activar estas opcoes por
predefinicao, mas como muda drasticamente a maneira como o APT chama o
dpkg, precisa de muitos mais testes. Estas op,c~oes s~ao portanto
experimentais e n~ao deve ser usadas em ambientes produtivos. Tambem
interrompe o relatorio de progresso, entao todos os frontends irao
permanecer a cerca de metade (ou mais) do tempo no estado de 100%
enquanto na realidade esta a configurar todos os pacotes.
Note que nao e garantido que o APT ira suportar estas opcoes ou que
estas opcoes nao irao causar (grandes) problemas no futuro. Se voce
compreendeu os riscos e problemas actuais com estas opcoes, mas tem
coragem suficiente para ajudar a testa-la, crie um novo ficheiro de
configuracao e teste uma combinacao de opcoes. Por favor reporte
quaisquer bugs, problemas e melhoramentos que encontre e certifique-se
de anotar nos seus relatorios quais as opcoes que usou. Pedir ajuda ao
dpkg tambem pode ser util para propositos de depuracao, veja ex. dpkg
--audit. Uma combinacao de opcoes defensiva seria
DPkg::NoTriggers "true";
PackageManager::Configure "smart";
DPkg::ConfigurePending "true";
DPkg::TriggersPending "true";
DPkg::NoTriggers
Adiciona a bandeira 'no triggers' a todas as chamadas do dpkg
(excepto a chamada ConfigurePending). Veja dpkg(1) se esta
interessado no que isto realmente representa. Em resumo: o dpkg nao
ira correr os triggers quando esta bandeira esta presente a menos
que seja explicitamente chamado a faze-lo numa chamada extra. Note
que esta opcao existe (nao documentada) tambem em versoes mais
antigas do apt com um significado ligeiramente diferente:
Anteriormente esta opcao apenas acrescentava --no-triggers as
chamadas configure para o dpkg - agora o apt ira adicionar esta
bandeira tambem as chamadas unpack e remove.
PackageManager::Configure
Valores validos sao "all", "smart" e "no". "all" e o valor
predefinido e faz com que o APT configure todos os pacotes
explicitos. O modo "smart" serve para configurar apenas pacotes que
precisam de ser configurados antes que outro pacote possa ser
desempacotado (pre-dependencias) e o resto configurado pelo dpkg
com uma chamada gerada pela proxima opcao. "no" por outro lado nao
ira configurar nada e confiar no dpkg para configuracoes (o qual
ira falhar se encontrar uma pre-dependencia). Definir esta opcao
para outra que nao seja o valor all ira implicitamente activar
tambem a proxima opcao predefinida, caso contrario o sistema
poderia acabar num estado nao configurado o qual poderia nao
arrancar!
DPkg::ConfigurePending
Se esta opcao for definida, o apt ira chamar dpkg --configure
--pending para permitir ao dpkg lidar como todas as configuracoes e
triggers requisitados. Esta opcao e activada automaticamente por
predefinicao se a opcao anterior nao for definida para all, mas
desactiva-la pode ser util se deseja correr o APT multiplas vezes
numa fila - ex. numa instalacao. Nestes cenarios voce pode
desactivar esta opcao em todas excepto na ultima execucao.
DPkg::TriggersPending
Util para configuracao smart, pois um pacote que tenha triggers
pendentes nao e considerado como installed e o dpkg trata-o como
actualmente unpacked o que e um modo de lidar com pre-dependencias
(veja debbugs #526774). Note que isto ira processar todos os
triggers, e nao apenas os triggers necessarios para configurar este
pacote.
PackageManager::UnpackAll
Como a configuracao pode ser diferida a ser feita no final pelo
dpkg, pode ser tentada a ordenar a serie de desempacotamento apenas
por necessidades criticas, ex. por pre-dependencias. A predefinicao
e verdadeiro e entao o metodo "antigo" de ordenar em varios passos
por tudo. Enquanto ambos os metodos estao presentes em versoes
jovens do APT, o metodo OrderCritical nao foi usado, portanto este
metodo e muito experimental e necessita de mais melhorias antes de
se tornar realmente util.
OrderList::Score::Immediate
Os pacotes essenciais ( e as suas dependencias) deve ser
configurados imediatamente apos a descompactacao. Sera uma boa
ideia fazer isto bem cedo no processo de actualizacao pois estas
chamadas de configuracao tambem requerem actualmente
DPkg::TriggersPending o que ira correr alguns triggers (que talvez
nao sejam necessarios). Os essenciais obtem por predefinicao uma
pontuacao alta mas a bandeira 'imediato' e relativamente baixa (um
pacote que tenha uma pre-dependencia tem pontuacao mais alta). Esta
opcao e as outras no mesmo grupo podem ser usadas para alterar a
pontuacao. O exemplo seguinte mostra as definicoes que sao valores
predefinidos.
OrderList::Score {
Delete 500;
Essential 200;
Immediate 10;
PreDepends 50;
};
OP,c~oES PERIODIC E ARCHIVES
Os grupos de opcoes APT::Periodic e APT::Archives configuram o
comportamento das actualizacoes periodicas do APT, o que e feito pelo
script /etc/cron.daily/apt. Veja o cabecalho deste script para uma
breve documentacao das suas opcoes.
OP,c~oES DE DEPURA,c~aO
Activar opcoes na seccao Debug:: ira causar o envio de informacao de
depuracao para o fluxo de erros standard do programa utilizando as
bibliotecas do apt, ou activar modos especiais do programa que sao
principalmente uteis para depurar o comportamento do apt. A maioria
destas opcoes nao tem interesse para o utilizador normal, mas algumas
podem ter:
o Debug::pkgProblemResolver activa mensagens na saida acerca das
decisoes tomadas por dist-upgrade, upgrade, install, remove, purge.
o Debug::NoLocking desactiva o bloqueio de todos os ficheiros. Isto
pode ser usado para executar algumas operacoes (por exemplo,
apt-get -s install) como um utilizador nao root.
o Debug::pkgDPkgPM escreve a linha de comandos actual de cada vez
que o apt invoca o dpkg(1).
o
Debug::IdentCdrom desactiva a inclusao de dados statfs em IDs de
CDROM.
Segue-se uma lista completa de opcoes de depuracao para o apt.
Debug::Acquire::cdrom
Escreve informacao relacionada com o acesso a fontes de cdrom://.
Debug::Acquire::ftp
Escreve informacao relacionada com o descarregamento de pacotes
usando FTP.
Debug::Acquire::http
Escreve informacao relacionada com o descarregamento de pacotes
usando HTTP.
Debug::Acquire::https
Escreve informacao relacionada com o descarregamento de pacotes
usando HTTPS.
Debug::Acquire::gpgv
Escreve informacao relacionada com a verificacao de assinaturas
criptograficas usando gpg.
Debug::aptcdrom
Escreve informacao acerca do processo de aceder a coleccoes de
pacotes armazenados em CD-ROMs.
Debug::BuildDeps
Descreve os processos de resolver dependencias de compilacao no
apt-get(8).
Debug::Hashes
Escreve cada hash criptografico que e gerado pelas bibliotecas do
apt.
Debug::IdentCDROM
Nao inclui informacao de statfs, nomeadamente o numero de blocos
usados e livres no sistema de ficheiros do CD-ROM, quando gera um
ID para um CD-ROM.
Debug::NoLocking
Desactiva o bloqueio de todos os ficheiros. Por exemplo, isto ira
permitir o funcionamento de duas instancias do "apt-get update" ao
mesmo tempo.
Debug::pkgAcquire
Regista no log quando os items sao adicionados ou removidos da fila
de download global.
Debug::pkgAcquire::Auth
Escreve mensagens de estado e erros relacionados com a verificacao
de checksums e assinaturas criptograficas dos ficheiros
descarregados.
Debug::pkgAcquire::Diffs
Escreve informacao acerca do download e aplicacao de diffs de lista
de indice do pacote, e erros relacionados com as diffs de lista de
indice do pacote.
Debug::pkgAcquire::RRed
Escreve informacao relacionada com a aplicacao de patch na lista de
pacotes do apt quando se descarrega diffs de indice em vez de
indices completos.
Debug::pkgAcquire::Worker
Regista todas as interaccoes com os sub-processos que realmente
executam os downloads.
Debug::pkgAutoRemove
Regista no log eventos relacionados com o estado
instalado-automaticamente de pacotes e com a remocao de pacotes nao
utilizados.
Debug::pkgDepCache::AutoInstall
Gera mensagens de depuracao descrevendo quais pacotes estao a ser
instalados automaticamente para resolver dependencias. Isto
corresponde ao passo de instalacao-automatica inicial executado em,
ex, apt-get install, e nao ao resolvedor de dependencias total do
apt; veja Debug::pkgProblemResolver para isso.
Debug::pkgDepCache::Marker
Gera mensagens de depuracao descrevendo qual pacote esta marcado
como manter/instalar/remover enquanto o "solucionador-de-problemas"
faz o seu trabalho. Cada adicao ou remocao pode activar accoes
adicionais; elas sao mostradas indentadas dois espacos adicionais
sob da entrada original. O formato de cada linha e MarkKeep,
MarkDelete ou MarkInstall seguido por package-name <a.b.c -> d.e.f
| x.y.z> (seccao) onde a.b.c e a versao actual do pacote, d.e.f e a
versao considerada para instalacao e x.y.z e a versao mais recente,
mas nao considerada para instalacao (devido a baixa pontuacao). Os
dois ultimos podem ser omitidos se nao existir nenhum ou for a
mesma versao que aquela instalada. section e o nome da seccao onde
o pacote aparece.
Debug::pkgInitConfig
Despeja a configuracao predefinida para o erro standard no
arranque.
Debug::pkgDPkgPM
Ao invocar o dpkg(1), escreve com precisao a linha de comandos com
a qual esta a ser invocado, com argumentos separados por um
caractere de espaco unico.
Debug::pkgDPkgProgressReporting
Escreve todos os dados recebidos do dpkg(1) no descritor de
ficheiro de estado e quaisquer erros encontrados enquanto os
analisa.
Debug::pkgOrderList
Gera um rastro do algoritmo que decide a ordem na qual o apt deve
passar os pacotes ao dpkg(1).
Debug::pkgPackageManager
Escreve mensagens de estado seguindo os passos executados quando
invoca o dpkg(1).
Debug::pkgPolicy
Escreve a prioridade da cada lista de pacote no arranque.
Debug::pkgProblemResolver
Rastreia a execucao do resolvedor de dependencias (isto so se
aplica ao que acontece quando e encontrado um problema de
dependencias complexo).
Debug::pkgProblemResolver::ShowScores
Mostra uma lista de todos os pacotes instalados com as suas
pontuacoes calculadas usadas pelo pkgProblemResolver. A descricao
do do pacote e a mesma que e descrita em Debug::pkgDepCache::Marker
Debug::sourceList
Escreve informacao acerca dos fornecedores lida de
/etc/apt/vendors.list.
EXAMPLES
/usr/share/doc/apt/examples/configure-index.gz e um ficheiro de
configuracao que mostra valores exemplo para todas as opcoes possiveis.
FICHEIROS
/etc/apt/apt.conf
Ficheiro de configuracao do APT. Item de Configuracao:
Dir::Etc::Main.
/etc/apt/apt.conf.d/
Ficheiros de configuracao fragmentados do APT. Item de
Configuracao: Dir::Etc::Parts.
VEJA TAMB'eM
apt-cache(8), apt-config(8), apt_preferences(5).
BUGS
p'agina 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,C~AO
A traducao Portuguesa foi feita por Americo Monteiro
a_monteiro@netcabo.pt em 2009, 2010. A traducao foi revista pela equipa
de traducoes portuguesas da Debian traduz@debianpt.org.
Note que este documento traduzido pode conter partes nao traduzidas.
Isto e feito propositadamente, para evitar perdas de conteudo quando a
traducao esta atrasada relativamente ao conteudo original.
AUTHORS
Jason Gunthorpe
APT team
Daniel Burrows <dburrows@debian.org>
Documentacao inicial do Debug::*.
NOTES
1. pagina de bugs do APT
http://bugs.debian.org/src:apt