Provided by: apt-utils_0.8.16~exp12ubuntu10_i386 bug

NAME

       apt-ftparchive - Utilitario para gerar ficheiros de indice

SYNOPSIS

       apt-ftparchive [-hvdsq] [--md5] [--delink] [--readonly] [--contents]
                      [--arch arquitectura] [-o configura,c~ao=string]
                      [-c=ficheiro]
                      {[packages caminho... [override [prefixo-de-caminho]]] |
                      [sources caminho... [sobrepor [prefixo-de-caminho]]] |
                      [contents caminho] | [release caminho] |
                      [generate ficheiro-de-configura,c~ao sec,c~ao...] |
                      [clean ficheiro-de-configura,c~ao]}

DESCRI,c~aO

       apt-ftparchive e a ferramenta de linha de comandos que cria os
       ficheiros indice que o APT usa para aceder a uma fonte de distribuicao.
       Os ficheiros indice devem ser gerados no site de origem baseados no
       conteudo desse site.

       apt-ftparchive e um super conjunto do programa dpkg-scanpackages(1),
       incorporando todas as suas funcionalidades atraves do comando packages.
       Tambem contem um gerador de ficheiro de conteudos, contents, e um meio
       elaborado de colocar em script o processo de geracao para um arquivo
       completo.

       Internamente o apt-ftparchive pode fazer uso de bases de dados binarias
       para por em cache os conteudos de um ficheiro .deb e nao precisa de
       nenhum programa externo a excepcao do gzip(1). Quando faz uma geracao
       completa, executa automaticamente verificacoes de alteracoes de
       ficheiros e constroi os ficheiros comprimidos desejados.

       A menos que a opcao -h, ou --help seja fornecida, um dos comandos
       abaixo tem que estar presentes.

       packages
           O comando packages gera um ficheiro pacote a partir duma arvore de
           directorios. Recebe um dado directorio e procura recursivamente por
           ficheiros .deb, emitindo um registo de pacote para o stdout por
           cada um. Este comando e aproximadamente equivalente ao dpkg-
           scanpackages(1).

           A opcao --db pode ser usada para especificar uma base de dados de
           cache binaria.

       sources
           O comando sources gera um indice de fonte a partir duma arvore de
           directorios. Recebe um dado directorio e procura recursivamente por
           ficheiros .dsc, emitindo um registo de fonte para o stdout por cada
           um. Este comando e aproximadamente equivalente ao dpkg-
           scansources(1).

           Se for especificado um ficheiro de sobreposicao entao sera
           procurado um ficheiro de sobreposicao de fonte com uma extensao de
           .src. A opcao --source-override pode ser usada para alterar o
           ficheiro de sobreposicao de fonte que ira ser usado.

       contents
           O comandocontents gera um ficheiro de conteudos a partir duma
           arvore de directorios. Recebe um dado directorio e procura
           recursivamente por ficheiros .deb, e le a lista de ficheiros de
           cada ficheiro. Entao organiza e escreve para o stdout a lista de
           ficheiros correspondente a pacotes. Os directorios nao sao escritos
           no saida. Se multiplos pacotes possuirem o mesmo ficheiro entao
           cada pacote e separado por uma virgula na saida.

           A opcao --db pode ser usada para especificar uma base de dados de
           cache binaria.

       release
           The release command generates a Release file from a directory tree.
           It recursively searches the given directory for uncompressed
           Packages and Sources files and the ones compressed with gzip, bzip2
           or lzma as well as Release and md5sum.txt files by default
           (APT::FTPArchive::Release::Default-Patterns). Additional filename
           patterns can be added by listing them in
           APT::FTPArchive::Release::Patterns. It then writes to stdout a
           Release file containing a MD5, SHA1 and SHA256 digest for each
           file.

           Valores para os campos de metadados adicionais no ficheiro Release
           sao tomados a partir das variaveis correspondentes sob
           APT::FTPArchive::Release, ex.  APT::FTPArchive::Release::Origin. Os
           campos suportados sao: Origin, Label, Suite, Version, Codename,
           Date, Architectures, Components, Description.

       generate
           O comando generate e desenhado para ser executado a partir dum
           script cron e constroi indices de acordo com o ficheiro de
           configuracao fornecido. A linguagem de configuracao disponibiliza
           um meio flexivel de de especificar quais ficheiros indice sao
           construidos a partir de quais directorios, assim como
           disponibilizar um meio simples de manter as definicoes requeridas.

       clean
           O comando clean arruma as bases de dados usadas pelo ficheiro de
           configuracao fornecido ao remover quaisquer registos que ja nao sao
           necessarios.

A CONFIGURA,c~aO DO GENERATE

       O comando generate usa um ficheiro de configuracao para descrever os
       arquivos que vao ser gerados. Segue o formato tipico de configuracao
       ISC como visto em ferramentas ISC como o bind 8 e dhcpd.  apt.conf(5)
       contem uma descricao da sintaxe. Note que a configuracao gerada e
       analisada de maneira seccional, mas o apt.conf(5) e analisado numa
       maneira de arvore. Isto apenas afecta o modo de como a etiqueta scope e
       manuseada.

       A configuracao do generate tem 4 seccoes separadas, cada uma descrita
       mais abaixo.

   Sec,c~ao Dir
       A seccao Dir define os directorios standard necessarios para localizar
       os ficheiros requisitados durante o processo de geracao. Estes
       directorios precedem a certos caminhos relativos definidos em seccoes
       posteriores para produzir um caminho completo e absoluto.

       ArchiveDir
           Especifica a raiz do arquivo FTP, numa configuracao Debian standard
           este e o directorio que contem o ls-LR e nos da distribuicao.

       OverrideDir
           Especifica a localizacao dos ficheiros de sobrepor.

       CacheDir
           Especifica a localizacao dos ficheiros de cache

       FileListDir
           Especifica a localizacao dos ficheiros de listas de ficheiros, se a
           definicao FileList for usada mais abaixo.

   Sec,c~ao Default
       A seccao Default especifica valores predefinidos, e definicoes que
       controlam a operacao do gerador. Outras seccoes podem sobrepor estas
       predefinicoes em uma definicao por-seccao.

       Packages::Compress
           Define os esquemas de compressao predefinidos a usar para os
           ficheiros de indice Package. E uma string que contem uma lista
           separada por espacos de pelo menos um de: '.' (nenhuma compressao),
           'gzip' and 'bzip2'. A predefinicao para todos os esquemas de
           compressao e '. gzip'.

       Packages::Extensions
           Define a lista predefinida das extensoes de ficheiros que sao
           ficheiros pacote. A predefinicao e '.deb'.

       Sources::Compress
           Isto e semelhante a Packages::Compress excepto que controla a
           compressao para os ficheiros das Fontes.

       Sources::Extensions
           Define a lista predefinida das extensoes de ficheiros que sao
           ficheiros de fontes. A predefinicao e '.dsc'.

       Contents::Compress
           Isto e semelhante a Packages::Compress excepto que controla a
           compressao para os ficheiros de Conteudos.

       Translation::Compress
           Isto e semelhante a Packages::Compress excepto que controla a
           compressao para o ficheiro mestre Translation-en.

       DeLinkLimit
           Especifica o numero de kilobytes para delink (e substitui com hard
           links) por execucao. Isto e usado em conjunto com a definicao
           External-Links por seccao.

       FileMode
           Especifica o modo de todos os ficheiros indice criados. A
           predefinicao e 0644. Todos os ficheiros indice sao definidos para
           este modo independentemente do umask.

       LongDescription
           Define se as descricoes longas devem ser incluidas no ficheiro
           Packages ou divididas em um ficheiro Translation-en mestre.

   Sec,c~ao TreeDefault
       Define predefinicoes especificas para as seccoes Tree. Todas estas
       variaveis sao variaveis de substituicao e tem as strings $(DIST),
       $(SECTION) e $(ARCH) substituidas pelos seus respectivos valores.

       MaxContentsChange
           Define o numero de kilobytes dos ficheiros de conteudo que sao
           gerados a cada dia. Os ficheiros de conteudo sao re-circulados para
           que ao fim de alguns dias todos sejam reconstruidos.

       ContentsAge
           Controla o numero de dias que se permite a um ficheiro de conteudo
           ser verificado sem alteracao. Se este limite for ultrapassado o
           mtime do ficheiro de conteudo e actualizado. Este caso pode ocorrer
           se o ficheiro de pacote e alterado num modo que nao resulta num
           novo ficheiro de conteudo [por exemplo uma edicao de sobreposicao].
           E permitido um soltar na esperanca que novos .debs sejam
           instalados, requerendo um novo ficheiro de qualquer modo. A
           predefinicao e 10, as unidades sao em dias.

       Directory
           Define o topo da arvore de directorios .deb. A predefinicao e
           $(DIST)/$(SECTION)/binary-$(ARCH)/

       SrcDirectory
           Define o topo da arvore de directorios de pacotes fonte. A
           predefinicao e $(DIST)/$(SECTION)/source/

       Packages
           Define o ficheiro Packages de saida. A predefinicao e
           $(DIST)/$(SECTION)/binary-$(ARCH)/Packages

       Sources
           Define o ficheiro Sources de saida. A predefinicao e
           $(DIST)/$(SECTION)/source/Sources

       Translation
           Define se o ficheiro mestre Translation-en de saida com as
           descricoes longas nao deve ser incluido no ficheiro Packages. A
           predefinicao e $(DIST)/$(SECTION)/i18n/Translation-en

       InternalPrefix
           Define o prefixo de caminho que causa que um symlink seja
           considerado um link interno em vez de um link externo. A
           predefinicao e $(DIST)/$(SECTION)/

       Contents
           Define a saida do ficheiro Contents. A predefinicao e
           $(DIST)/Contents-$(ARCH). Se esta definicao causar multiplos
           ficheiros Packages para mapear em um unico ficheiro Contents (tal
           como a predefinicao) entao o apt-ftparchive ira automaticamente
           integrar esses ficheiros pacotes todos juntos.

       Contents::Header
           Define o ficheiro cabecalho para prefixar a saida de conteudos.

       BinCacheDB
           Define a base de dados de cache binaria a usar para esta seccao.
           Multiplas seccoes podem partilhar a mesma base de dados.

       FileList
           Especifica que em vez de navegar na arvore de directorios, o
           apt-ftparchive devera ler a lista de ficheiros a partir do ficheiro
           fornecido. Nomes de ficheiros relativos sao prefixados com o
           directorio de arquivo.

       SourceFileList
           Especifica que em vez de navegar na arvore de directorios, o
           apt-ftparchive devera ler a lista de ficheiros a partir do ficheiro
           fornecido. Nomes de ficheiros relativos sao prefixados com o
           directorio de arquivo. Isto e usado quando se processa indices de
           fonte.

   Sec,c~ao Tree
       A seccao Tree define uma arvore de ficheiros Debian standard que
       consiste de um directorio base, depois multiplas seccoes nesse
       directorio base e finalmente multiplas Arquitecturas em cada seccao. O
       caminho exacto usado e definido pela variavel de substituicao
       Directory.

       A seccao Tree recebe uma etiqueta scope que define a variavel $(DIST) e
       define a raiz da arvore (o caminho e prefixado por ArchiveDir).
       Tipicamente esta e uma definicao tal como dists/squeeze.

       Todas as definicoes definidas na seccao TreeDefault podem ser usadas na
       seccao Tree assim como as novas tres variaveis.

       Quando processa uma seccao Tree, o apt-ftparchive executa uma operacao
       semelhante a:

           for i in Sections do
              for j in Architectures do
                 Generate for DIST=scope SECTION=i ARCH=j

       Sections
           Isto e uma lista de seccoes separada por espacos que aparece sob a
           distribuicao, tipicamente isto e algo como main contrib non-free

       Architectures
           Isto e uma lista separada por espacos de todas as arquitecturas que
           aparecem sob a seccao de buscas. A arquitectura especial 'source' e
           usada para indicar que esta arvore tem um arquivo fonte.

       LongDescription
           Define se as descricoes longas devem ser incluidas no ficheiro
           Packages ou divididas em um ficheiro Translation-en mestre.

       BinOverride
           Define o ficheiro de sobreposicao binario. O ficheiro de
           sobreposicao informacao de seccao, prioridade e endereco do
           responsavel.

       SrcOverride
           Define o ficheiro de sobreposicao fonte. O ficheiro de sobreposicao
           informacao de seccao.

       ExtraOverride
           Define o ficheiro de sobreposicao extra binario.

       SrcExtraOverride
           Define o ficheiro de sobreposicao extra fonte.

   Sec,c~ao BinDirectory
       A seccao bindirectory define uma arvore de directorios binarios sem
       nenhuma estrutura especial. A etiqueta scope especifica a localizacao
       do directorio binario e as definicoes sao semelhantes as da seccao Tree
       sem nenhumas variaveis de substituicao ou definicoes
       SectionArchitecture.

       Packages
           Define a saida do ficheiro Packages.

       Sources
           Define a saida do ficheiro Sources. E necessario pelo menos um de
           Packages ou Sources.

       Contents
           Define a saida do ficheiro Contents (opcional)

       BinOverride
           Define o ficheiro de sobreposicao binario.

       SrcOverride
           Define o ficheiro de sobreposicao fonte.

       ExtraOverride
           Define o ficheiro de sobreposicao extra binario.

       SrcExtraOverride
           Define o ficheiro de sobreposicao extra fonte.

       BinCacheDB
           Define a base de dados de cache.

       PathPrefix
           Acrescenta um caminho a todos os caminhos de saida.

       FileList, SourceFileList
           Especifica o ficheiro de lista de ficheiros.

O FICHEIRO BINARY OVERRIDE

       O ficheiro de sobreposicao binario e totalmente compativel com dpkg-
       scanpackages(1). Contem 4 campos separados por espacos. O primeiro
       campo e o nome do pacote, o segundo e a prioridade a qual forcar esse
       pacote, o terceiro e a seccao onde forcar esse pacote e o ultimo campo
       e o campo de permutacao do responsavel.

       O formato geral do campo do responsavel e:

           old [// oldn]* => new

       ou simplesmente,

           new

       . O primeiro formato permite uma lista separada por um duplo slash (//)
       de antigos enderecos e email a serem especificados. Se nenhum destes
       for encontrado entao 'new' e substituido para o campo do responsavel. O
       segundo formato substitui incondicionalmente o campo do responsavel.

O FICHEIRO SOURCE OVERRIDE

       O ficheiro de sobreposicao de fonte e totalmente compativel com dpkg-
       scansources(1). Contem dois campos separados por espacos. O primeiro
       campo e o nome de pacote fonte, o segundo e a seccao onde o atribuir.

O FICHEIRO EXTRA OVERRIDE

       O ficheiro de sobreposicao extra permite que qualquer etiqueta
       arbitraria seja adicionada ou substituida na saida. Tem 3 colunas, a
       primeira e o pacote, a segunda e a etiqueta e restante da linha e o
       novo valor.

OP,c~oES

       Todas as opcoes de linha de comandos podem ser definidas usando o
       ficheiro de configuracao, as descricoes indicam a opcao de configuracao
       a definir. Para opcoes booleanas voce pode sobre por o ficheiro de
       configuracao usando algo como -f-,--no-f, -f=no ou varias outras
       variantes.

       --md5, --sha1, --sha256
           Generate the given checksum. These options default to on, when
           turned off the generated index files will not have the checksum
           fields where possible. Configuration Items:
           APT::FTPArchive::Checksum and APT::FTPArchive::Index::Checksum
           where Index can be Packages, Sources or Release and Checksum can be
           MD5, SHA1 or SHA256.

       -d, --db
           Usa uma base de dados de cache binaria. Isto nao tem efeito no
           comando generate. Item de configuracao: APT::FTPArchive::DB.

       -q, --quiet
           Silencioso; produz saida apropriada para registar em logs, omitindo
           indicadores de progresso. Mais q's irao produzir mais silencio ate
           um maximo de 2. Voce tambem pode usar -q=# para definir o nivel de
           silencio, sobrepondo o ficheiro de configuracao. Item de
           Configuracao: quiet.

       --delink
           Executa Dissociacao. Se e usada a definicao External-Links entao
           esta opcao activa a dissociacao dos ficheiros. A sua predefinicao e
           ligada e e pode ser desligada com --no-delink. Item de
           Configuracao: APT::FTPArchive::DeLinkAct.

       --contents
           Executa a geracao de conteudos. Quando esta opcao esta definida e
           os indices de pacotes sao gerados com um base de dados cache entao
           a listagem de ficheiros tambem sera extraida e guardada na base de
           dados para utilizacao posterior. Quando se usa o comando generate,
           esta opcao tambem permite a criacao de quaisquer ficheiros de
           Conteudos. A predefinicao e ligado. Item de Configuracao:
           APT::FTPArchive::Contents.

       -s, --source-override
           Selecciona o ficheiro de sobreposicao de fonte a usar com o comando
           sources. Item de Configuracao: APT::FTPArchive::SourceOverride.

       --readonly
           Torna as bases de dados de cache apenas de leitura. Item de
           Configuracao: APT::FTPArchive::ReadOnlyDB.

       -a, --arch
           Aceita nos comandos packages e contents apenas ficheiros de pacotes
           que condizem com *_arch.deb ou *_all.deb em vez de todos os
           ficheiros de pacotes presentes no caminho fornecido. Item de
           Configuracao: APT::FTPArchive::Architecture.

       APT::FTPArchive::AlwaysStat

           apt-ftparchive(1) poe em cache o maximo possivel de metadados numa
           base de dados de cache. Se os pacotes forem recompilados e/ou
           republicados de novo com a mesma versao, ira originar problemas
           porque serao usados os metadados desactualizados em cache como o
           tamanho e sumarios de verificacao. Com esta opcao activa isto nao
           ira mais acontecer porque sera verificado se o ficheiro foi
           alterado. Note que esta opcao vem regulada para "false" por
           predefinicao pois nao e recomendado disponibilizar multiplas
           versoes/compilacoes de um pacote com o mesmo numero de versao,
           portanto em teoria ninguem ira ter estes problemas e entao todas as
           verificacoes extras serao desnecessarias.

       APT::FTPArchive::LongDescription
           Esta opcao de configuracao tem a predefinicao de "true" e deve
           apenas ser definida para "false" se o Arquivo gerado com apt-
           ftparchive(1) tambem disponibilizar ficheiros Translation. Note que
           o ficheiro mestre Translation-en so pode ser criado no comando
           generate.

       -h, --help
           Mostra um sumario curto da utilizacao.

       -v, --version
           Mostra a versao do programa.

       -c, --config-file
           Ficheiro de Configuracao; Especifica o ficheiro de configuracao a
           usar. O programa ira ler o ficheiro de configuracao predefinido e
           depois este ficheiro de configuracao. Se as definicoes de
           configuracao precisarem de ser definidas antes, os ficheiros de
           configuracao predefinidos sao analisados especificando um ficheiro
           com a variavel de ambiente APT_CONFIG. Veja apt.conf(5) para
           informacao de sintaxe.

       -o, --option
           Define uma Opcao de Configuracao; Isto ira definir uma opcao de
           configuracao arbitraria. A sintaxe e -o Foo::Bar=bar.  -o e
           --option podem ser usadas varias vezes para definir opcoes
           diferentes.

EXAMPLES

       Para criar um ficheiro Packages comprimido para um directorio que
       contem pacotes binarios (.deb):

           apt-ftparchive pacotes direct'orio | gzip > Packages.gz

VEJA TAMB'eM

       apt.conf(5)

DIAGN'oSTICO

       apt-ftparchive devolve zero na operacao normal, 100 decimal em erro.

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

NOTES

        1. pagina de bugs do APT
           http://bugs.debian.org/src:apt