Provided by: apt_0.8.3ubuntu7_i386 bug

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