apt-ftparchive - Online na nuvem

PROGRAMA:

NOME

apt-ftparchive - Utilitário para gerar arquivos de índice

SINOPSE

apt-ftparchive [-dsq] [--md5] [--desvincular] [--somente leitura] [--conteúdo] [--arco arquitetura]
[-o =string_config] [-c =arquivo_config]
{pacotes caminho... [arquivo de substituição [prefixo de caminho]] |
fontes caminho... [arquivo de substituição [prefixo de caminho]] | conteúdo caminho |
liberar caminho | gerar arquivo_config seção... | limpar arquivo_config |
{-v | --version} | {-h | --ajuda}}

DESCRIÇÃO

apt-ftparchive é a ferramenta de linha de comando que gera os arquivos de índice que o APT usa para
acessar uma fonte de distribuição. Os arquivos de índice devem ser gerados no site de origem com base
no conteúdo desse site.

apt-ftparchive é um superconjunto do dpkg-scanpackages(1) programa, incorporando todo o seu
funcionalidade por meio do comando de pacotes. Ele também contém um gerador de arquivo de conteúdo,
conteúdo, e um meio elaborado de 'script' o processo de geração para um completo
arquivo.

Internamente apt-ftparchive pode usar bancos de dados binários para armazenar em cache o conteúdo de um arquivo .deb
arquivo e não depende de nenhum programa externo além de gzip(1). Ao fazer um completo
gera-o executa automaticamente verificações de mudança de arquivo e constrói o compactado desejado
arquivos de saída.

A menos que o -hou --Socorro opção for fornecida, um dos comandos abaixo deve estar presente.

pacotes
O comando de pacotes gera um arquivo de pacote de uma árvore de diretório. Leva o
determinado diretório e procura recursivamente por arquivos .deb, emitindo um registro de pacote
para stdout para cada um. Este comando é aproximadamente equivalente a dpkg-scanpackages(1).

A opção --db pode ser usado para especificar um banco de dados de cache binário.

fontes
O comando sources gera um arquivo de índice de origem a partir de uma árvore de diretório. Leva o
determinado diretório e procura recursivamente por arquivos .dsc, emitindo um registro de origem
para stdout para cada um. Este comando é aproximadamente equivalente a dpkg-scansources(1).

Se um arquivo de substituição for especificado, um arquivo de substituição de origem será procurado com
uma extensão de .src. A opção --source-override pode ser usada para alterar a fonte
sobrescrever o arquivo que será usado.

conteúdo
O comando de conteúdo gera um arquivo de conteúdo a partir de uma árvore de diretório. Leva o
determinado diretório e recursivamente procura por arquivos .deb, e lê a lista de arquivos
de cada arquivo. Em seguida, ele classifica e grava em stdout a lista de arquivos correspondidos a
pacotes. Os diretórios não são gravados na saída. Se vários pacotes possuem o mesmo
arquivo então cada pacote é separado por uma vírgula na saída.

A opção --db pode ser usado para especificar um banco de dados de cache binário.

liberar
O comando release gera um arquivo Release a partir de uma árvore de diretórios. É recursivamente
procura o diretório fornecido por pacotes não compactados e arquivos de código-fonte e outros
comprimido com gzip, bzip2 or lzma bem como arquivos Release e md5sum.txt por padrão
(APT :: FTPArchive :: Release :: Default-Patterns). Padrões de nome de arquivo adicionais podem ser
adicionado listando-os em APT :: FTPArchive :: Release :: Patterns. Em seguida, ele grava em stdout
um arquivo de lançamento contendo (por padrão) um resumo MD5, SHA1, SHA256 e SHA512 para cada
arquivo.

Os valores dos campos de metadados adicionais no arquivo Release são retirados do
variáveis ​​correspondentes em APT :: FTPArchive :: Release, por exemplo
APT :: FTPArchive :: Release :: Origin. Os campos suportados são: Origem, Etiqueta, Suite,
Versão, codinome, data, válido até, arquiteturas, componentes, descrição.

gerar
O comando generate foi projetado para ser executado a partir de um script cron e cria índices
de acordo com o arquivo de configuração fornecido. A linguagem de configuração fornece um meio flexível de
especificando quais arquivos de índice são construídos a partir de quais diretórios, além de fornecer um
meios simples de manter as configurações necessárias.

limpar
O comando clean organiza os bancos de dados usados ​​pelo arquivo de configuração fornecido por
removendo quaisquer registros que não sejam mais necessários.

A GERAR CONFIGURAÇÃO

O comando generate usa um arquivo de configuração para descrever os arquivos que vão
ser gerado. Ele segue o formato de configuração típico do ISC, conforme visto nas ferramentas ISC, como
bind 8 e dhcpd. apt.conf(5) contém uma descrição da sintaxe. Observe que o
a configuração de geração é analisada de maneira seccional, mas apt.conf(5) é analisado em uma árvore
maneiras. Isso afeta apenas como a tag de escopo é tratada.

A configuração de geração tem quatro seções separadas, cada uma descrita abaixo.

Você Seção
A seção Dir define os diretórios padrão necessários para localizar os arquivos necessários
durante o processo de geração. Esses diretórios são anexados a certos caminhos relativos
definido em seções posteriores para produzir um caminho completo e absoluto.

ArquivoDir
Especifica a raiz do arquivo FTP, em uma configuração Debian padrão este é o
diretório que contém os nós ls-LR e dist.

Substituir Dir
Especifica a localização dos arquivos de substituição.

CacheDir
Especifica a localização dos arquivos de cache.

FileListDir
Especifica a localização dos arquivos da lista de arquivos, se a configuração FileList for usada abaixo.

Padrão Seção
A seção Padrão especifica os valores padrão e as configurações que controlam a operação de
o gerador. Outras seções podem substituir esses padrões com uma configuração por seção.

Pacotes :: Compress
Define os esquemas de compactação padrão a serem usados ​​para os arquivos de índice de pacote. É um
string que contém uma lista separada por espaços de pelo menos um de: '.' (sem compressão),
'gzip' e 'bzip2'. O padrão para todos os esquemas de compactação é '. gzip '.

Pacotes :: Extensões
Define a lista padrão de extensões de arquivo que são arquivos de pacote. O padrão é
'.deb'.

Fontes :: Compress
Isso é semelhante a Packages :: Compress, exceto que controla a compressão para o
Arquivos de origem.

Fontes :: Extensões
Define a lista padrão de extensões de arquivo que são arquivos de origem. O padrão é
'.dsc'.

Conteúdo :: Compress
Isso é semelhante a Packages :: Compress, exceto que controla a compressão para o
Arquivos de conteúdo.

Tradução :: Compress
Isso é semelhante a Packages :: Compress, exceto que controla a compressão para o
Arquivo mestre de tradução.

DeLinkLimit
Especifica o número de kilobytes a desvincular (e substituir por links físicos) por execução.
Isso é usado em conjunto com a configuração de Links externos por seção.

Filemode
Especifica o modo de todos os arquivos de índice criados. O padrão é 0644. Todos os arquivos de índice
são configurados para este modo sem levar em consideração o umask.

Longa descrição
Especifica se descrições longas devem ser incluídas no arquivo Packages ou dividir
para um arquivo mestre de tradução.

Árvore Padrão Seção
Define padrões específicos para seções da árvore. Todas essas variáveis ​​são variáveis ​​de substituição
e ter as strings $ (DIST), $ (SECTION) e $ (ARCH) substituídas por seus respectivos
valores.

MaxContentsChange
Define o número de kilobytes de arquivos de conteúdo que são gerados a cada dia. o
os arquivos de conteúdo passam por round-robined para que, ao longo de vários dias, todos sejam reconstruídos.

ConteúdoIdade
Controla o número de dias que um arquivo de conteúdo pode ser verificado sem alteração.
Se este limite for ultrapassado, o mtime do arquivo de conteúdo é atualizado. Este caso pode ocorrer
se o arquivo do pacote for alterado de forma que não resulte em um novo conteúdo
arquivo [substituir editar por exemplo]. Uma suspensão é permitida na esperança de que novos .debs
ser instalado, exigindo um novo arquivo de qualquer maneira. O padrão é 10, as unidades estão em dias.

Diretório
Define o topo da árvore de diretórios .deb. Padrões para
$ (DIST) / $ (SECTION) / binário - $ (ARCH) /

Diretório Src
Define o topo da árvore de diretórios do pacote de origem. Padrões para
$ (DIST) / $ (SECTION) / fonte /

PACK
Define o arquivo Packages de saída. O padrão é $ (DIST) / $ (SECTION) / binary - $ (ARCH) / Packages

Fontes
Define o arquivo Sources de saída. O padrão é $ (DIST) / $ (SECTION) / source / Sources

Tradução
Define o arquivo mestre de tradução de saída com as descrições longas, se necessário
não ser incluído no arquivo Packages. Padrões para
$ (DIST) / $ (SECTION) / i18n / Translation-en

Prefixo Interno
Define o prefixo do caminho que faz com que um link simbólico seja considerado um link interno.
de um link externo. O padrão é $ (DIST) / $ (SECTION) /

Conteúdo
Define o arquivo de conteúdo de saída. O padrão é $ (DIST) / $ (SECTION) / Contents - $ (ARCH). Se
esta configuração faz com que vários arquivos Packages sejam mapeados em um único arquivo Contents (como está
o padrão) então apt-ftparchive irá integrar esses arquivos de pacote juntos
automaticamente.

Conteúdo :: Cabeçalho
Define o arquivo de cabeçalho para preceder a saída do conteúdo.

BinCacheDB
Define o banco de dados de cache binário a ser usado para esta seção. Várias seções podem compartilhar
o mesmo banco de dados.

Filelist
Especifica que, em vez de percorrer a árvore de diretórios, apt-ftparchive deveria ler o
lista de arquivos do arquivo fornecido. Nomes de arquivos relativos são prefixados com o arquivo
diretório.

Lista de arquivos de origem
Especifica que, em vez de percorrer a árvore de diretórios, apt-ftparchive deveria ler o
lista de arquivos do arquivo fornecido. Nomes de arquivos relativos são prefixados com o arquivo
diretório. Isso é usado ao processar índices de origem.

Árvore Seção
A seção Tree define uma árvore de arquivos Debian padrão que consiste em um diretório base,
em seguida, várias seções nesse diretório base e, finalmente, várias arquiteturas em cada
seção. O caminho exato usado é definido pela variável de substituição do diretório.

A seção Tree leva uma tag de escopo que define a variável $ (DIST) e define a raiz de
a árvore (o caminho é prefixado por ArchiveDir). Normalmente, esta é uma configuração como
dists / jessie.

Todas as configurações definidas na seção TreeDefault podem ser usadas em uma seção Árvore como
bem como três novas variáveis.

Ao processar uma seção da árvore apt-ftparchive executa uma operação semelhante a:

para eu nas Seções fazer
para j em Architectures do
Gerar para DIST = escopo SECTION = i ARCH = j

seções
Esta é uma lista de seções separadas por espaços que aparecem abaixo da distribuição;
normalmente é algo como main contrib non-free

Arquiteturas
Esta é uma lista separada por espaço de todas as arquiteturas que aparecem sob pesquisa
seção. A arquitetura especial 'fonte' é usada para indicar que esta árvore tem um
arquivo de origem. A arquitetura 'todos' sinaliza que arquivos específicos da arquitetura, como
Os pacotes não devem incluir informações sobre a arquitetura de todos os pacotes em todos os arquivos
pois estarão disponíveis em um arquivo dedicado.

Longa descrição
Especifica se descrições longas devem ser incluídas no arquivo Packages ou dividir
para um arquivo mestre de tradução.

Substituição de Bin
Define o arquivo de substituição binária. O arquivo de substituição contém seção, prioridade e
informações de endereço do mantenedor.

SrcOverride
Define o arquivo de substituição de origem. O arquivo de substituição contém informações da seção.

Substituição Extra
Define o arquivo binário de substituição extra.

SrcExtraOverride
Define o arquivo de substituição extra de origem.

BinDiretório Seção
A seção bindirectory define uma árvore de diretório binário sem estrutura especial. o
tag de escopo especifica a localização do diretório binário e as configurações são semelhantes a
a seção Tree sem variáveis ​​de substituição ou configurações SectionArchitecture.

PACK
Define a saída do arquivo Packages.

Fontes
Define a saída do arquivo Sources. É necessário pelo menos um dos Pacotes ou Fontes.

Conteúdo
Define a saída do arquivo de conteúdo (opcional).

Substituição de Bin
Define o arquivo de substituição binária.

SrcOverride
Define o arquivo de substituição de origem.

Substituição Extra
Define o arquivo binário de substituição extra.

SrcExtraOverride
Define o arquivo de substituição extra de origem.

BinCacheDB
Define o banco de dados do cache.

Prefixo do caminho
Acrescenta um caminho a todos os caminhos de saída.

Filelist, Lista de arquivos de origem
Especifica o arquivo da lista de arquivos.

A BINARY SOBREPOR ARQUIVO

O arquivo de substituição binária é totalmente compatível com dpkg-scanpackages(1). Contém quatro
campos separados por espaços. O primeiro campo é o nome do pacote, o segundo é o
prioridade para forçar esse pacote, a terceira é a seção para forçar esse pacote e
o campo final é o campo de permutação do mantenedor.

A forma geral do campo do mantenedor é:

old [// oldn] * => novo

ou simplesmente,

novo

O primeiro formulário permite que uma lista separada por barras duplas de endereços de e-mail antigos seja
Especificadas. Se algum desses for encontrado, new é substituído pelo campo do mantenedor. o
a segunda forma substitui incondicionalmente o campo do mantenedor.

A FONTE SOBREPOR ARQUIVO

O arquivo de substituição de origem é totalmente compatível com dpkg-scansources(1). Contém dois
campos separados por espaços. O primeiro campo é o nome do pacote fonte, o segundo é o
seção para atribuí-lo.

A EXTRA SOBREPOR ARQUIVO

O arquivo de substituição extra permite que qualquer tag arbitrária seja adicionada ou substituída na saída. Isto
tem três colunas, a primeira é o pacote, a segunda é a etiqueta e o restante do
a linha é o novo valor.

OPÇÕES

Todas as opções de linha de comando podem ser definidas usando o arquivo de configuração, as descrições
indique a opção de configuração a ser definida. Para opções booleanas você pode sobrescrever a configuração
arquivo usando algo como -f-,--não-f, -f = não ou várias outras variações.

--md5, --sha1, --sha256, --sha512
Gere a soma de verificação fornecida. Essas opções são ativadas por padrão, quando desativadas no
os arquivos de índice gerados não terão os campos de soma de verificação sempre que possível. Configuração
Itens: APT :: FTPArchive ::Checksums e APT :: FTPArchive ::Índice::Checksums onde Índice pode
ser Pacotes, Fontes ou Lançamento e Checksums pode ser MD5, SHA1, SHA256 ou SHA512.

-d, --db
Use um banco de dados de cache binário. Isso não tem efeito no comando de geração. Configuração
Item: APT :: FTPArchive :: DB.

-q, --quieto
Quieto; produz saída adequada para registro, omitindo indicadores de progresso. Mais q's
produzirá mais silencioso até um máximo de 2. Você também pode usar -q = # para definir o silêncio
nível, substituindo o arquivo de configuração. Item de configuração: silencioso.

--desvincular
Execute o Desvinculação. Se a configuração de Links Externos for usada, esta opção na verdade
permite desvincular os arquivos. O padrão é ativado e pode ser desativado com
--sem desvinculação. Item de Configuração: APT :: FTPArchive :: DeLinkAct.

--conteúdo
Executa a geração de conteúdo. Quando esta opção é definida e os índices de pacote estão sendo
gerado com um banco de dados de cache, então a lista de arquivos também será extraída e armazenada em
o DB para uso posterior. Ao usar o comando de geração, esta opção também permite o
criação de quaisquer arquivos de conteúdo. O padrão é ativado. Item de configuração:
APT :: FTPArchive :: Conteúdo.

-s, --source-override
Selecione o arquivo de substituição de origem para usar com o comando sources. Item de configuração:
APT :: FTPArchive :: SourceOverride.

--somente leitura
Torne os bancos de dados de cache somente leitura. Item de Configuração: APT :: FTPArchive :: ReadOnlyDB.

-a, --arco
Aceite nos comandos de pacotes e conteúdo apenas arquivos de pacote que correspondam a * _arch.deb ou
* _all.deb em vez de todos os arquivos de pacote no caminho fornecido. Item de configuração:
APT :: FTPArchive :: Arquitetura.

APT :: FTPArchive :: AlwaysStat
apt-ftparchive(1) armazena em cache o máximo possível de metadados em um cachedb. Se os pacotes são
recompilado e / ou republicado com a mesma versão novamente, isso levará a problemas
já que os metadados em cache agora desatualizados, como tamanho e somas de verificação, serão usados. Com isso
opção habilitada, isso não acontecerá mais, pois será verificado se o arquivo estava
mudado. Observe que esta opção é definida como "falsa" por padrão, pois não é recomendável
fazer upload de várias versões / compilações de um pacote com o mesmo número de versão, então, em teoria
ninguém terá esses problemas e, portanto, todas essas verificações extras são inúteis.

APT :: FTPArchive :: LongDescription
Esta opção de configuração é padronizada como "true" e só deve ser definida como "false" se o
Arquivo gerado com apt-ftparchive(1) também fornece arquivos de tradução. Observe que
o arquivo mestre de tradução só pode ser criado no comando gerar.

-h, --Socorro
Mostra um breve resumo do uso.

-v, --versão
Mostra a versão do programa.

-c, --config-arquivo
Arquivo de configuração; Especifique um arquivo de configuração a ser usado. O programa irá ler o
arquivo de configuração padrão e, em seguida, este arquivo de configuração. Se as definições de configuração
precisa ser definido antes que os arquivos de configuração padrão sejam analisados, especifique um arquivo com
que o APT_CONFIG variável de ambiente. Ver apt.conf(5) para informações de sintaxe.

-o, --opção
Defina uma opção de configuração; Isso definirá uma opção de configuração arbitrária. o
sintaxe é -o Foo :: Bar = bar. -o e --opção pode ser usado várias vezes para definir
opções diferentes.

EXEMPLOS

Para criar um arquivo Packages compactado para um diretório contendo pacotes binários (.deb):

apt-ftparchive pacotes anuário | gzip > Packages.gz

Use apt-ftparchive online usando serviços onworks.net