Provided by: dpkg-dev_1.21.1ubuntu2.3_all 
NOME
deb-buildinfo - formato Debian de ficheiro de informação de compilação
SINOPSE
filename.buildinfo
DESCRIÇÃO
Cada compilação de pacote fonte Debian pode gravar a informação de compilação num ficheiro de controle
.buildinfo, o qual contem um número de campos em formato deb822(5).
Cada campo começa com uma etiqueta, tal como Source ou Binary (insensível a maiúsculas/minúsculas),
seguida de dois pontos, e do corpo do campo (sensível a maiúsculas/minúsculas a menos que declarado o
contrário). Os campos são delimitados apenas pelas etiquetas (tags) dos campos. Por outras palavras, o
campo de texto pode ter várias linhas de comprimento, mas as ferramentas de instalação irão geralmente
juntar as linhas quando processam o corpo do campo (excepto no caso de campos multi-linha Binary-Only-
Changes, Installed-Build-Depends, Environment, Checksums-Md5, Checksums-Sha1 e Checksums-Sha256, ver
abaixo).
Os dados de controle podem estar inclusos numa assinatura OpenPGP ASCII Armored, como especificado em
RFC4880.
O nome do ficheiro .buildinfo irá depender do tipo de compilação e irá ser tão específico quanto
necessário e não mais; para uma compilação que inclui any o nome será source-name_binary-
version_arch.buildinfo, ou caso contrário para uma compilação que inclui all o nome será source-
name_binary-version_all.buildinfo, ou caso contrário para uma compilação que inclui source o nome será
source-name_source-version_source.buildinfo.
CAMPOS
Format: format-version (necessário)
O valor deste campo declara a versão de formato do ficheiro. A sintaxe do valor do campo é um número
de versão com um componente maior ou menor. Alterações incompatíveis com versões anteriores ao
formato irão colidir com a versão maior, e alterações compatíveis com versões anteriores (tais como
adições de campos) irão colidir com a versão menor. A versão de formato actual é 1.0.
Source: source-name [(source-version)] (necessário)
O nome do pacote fonte. Se a versão fonte diferir da versão binário, então o source-name será seguido
por um source-version em parênteses. Isto pode acontecer quando a compilação é para envio de
não-maintainer apenas-binário.
Binary: binary-package-list (necessário em contexto)
Este campo dobrado é uma lista de pacotes binários compilados separados por espaços. Se a compilação
for de "apenas-fonte", então o campo é omitido (desde dpkg 1.20.0).
Architecture: arch-list (necessário)
Este campo separado por espaços lista as arquitecturas de todos os ficheiros actualmente a serem
compilados. Arquitecturas comuns são amd64, armel, i386, etc. Note que o valor all destina-se a
pacotes que são independentes da arquitectura. Se o pacote fonte for também compilado, está também
presente a entrada especial source. Wildcards de arquitectura nunca devem estar presentes na lista.
Version: string-de-versão (obrigatório)
Tipicamente, isto é o número de versão do pacote original seja em que formato o autor do programa
usa. Pode também incluir um número de revisão Debian (para pacotes não-nativos). O formato exacto e
algoritmo de ordenação estão descritos em deb-version(7).
Binary-Only-Changes:
changelog-entry
Este campo multi-linha contem o texto concatenado da entrada changelog para um envio de
não-maintainer apenas binário (binNMU) se esse for o caso. Para tornar isto numa entrada multi-linha
válida as linhas vazias são substituídas com um único ponto final (‘.’) e todas as linhas são
indentadas por um caractere de espaço. O conteúdo exacto depende do formato do changelog.
Checksums-Md5: (necessário)
Checksums-Sha1: (necessário)
Checksums-Sha256: (necessário)
checksum size filename
Estes campos multi-linha contêm uma lista de ficheiros com um sumário de verificação e tamanho para
cada um deles. Estes campos têm a mesma sintaxe e diferem apenas no algoritmo de checksum usado: MD5
para Checksums-Md5, SHA-1 para Checksums-Sha1 e SHA-256 para Checksums-Sha256.
A primeira linha do campo valor (a parte na mesma linha que tem o campo nome seguido de dois pontos)
é sempre vazia. O conteúdo do campo é expressado como linhas de continuação, uma linha por ficheiro.
Cada linha consiste de entradas separadas por espaços que descrevem o ficheiro: o sumário de
verificação (checksum), o tamanho do ficheiro, e o nome do ficheiro.
Estes campos listam todos os ficheiros que fazem a compilação.
Build-Origin: name
O nome da distribuição de onde este pacote originou.
Build-Architecture: arch (necessário)
A arquitectura Debian para a instalação dos pacotes que estão a ser compilados. Arquitecturas comuns
são amd64, armel, i386, etc.
Build-Date: build-date
A data em que o pacote foi compilado. Tem de estar no mesmo formato que a data duma entrada deb-
changelog(5).
Build-Kernel-Version: build-kernel-version
O lançamento e versão (num formato não especificado) do kernel que corre no sistema de compilação.
Este campo só vai estar presente se o compilador o tiver explicitamente requerido, para evitar fugir
informação possivelmente sensível.
Build-Path: build-path
O caminho de compilação absoluto, que corresponde à árvore fonte desempacotada. Este campo apenas vai
estar presente se o fornecedor o permitiu via algum padrão de correspondência para evitar denunciar
informação possivelmente sensível.
Em Debian e derivados apenas os caminhos de compilação começados com /build/ irão emitir este campo.
Build-Tainted-By:
taint-reason-list
Este campo dobrado contem uma lista separada por espaços de etiquetas de razão não-exaustiva
(formadas por caracteres alfanuméricos e traços) as quais identificam porque a compilação actual foi
contaminada (desde dpkg 1.19.5).
Em Debian e derivados as seguintes etiquetas de razão podem ser emitidas:
merged-usr-via-aliased-dirs
Este sistema tem um /usr fundido via directórios com nomes alternativos (anteriormente conhecido
como merged-usr-via-symlinks). Isto irá confundir dpkg-query, dpkg-statoverride, dpkg-trigger,
update-alternatives e qualquer outra ferramenta que use nomes-de-caminho como chaves para as suas
base de dados, pois isto cria problemas de nomes alternativos no sistema de ficheiros, e complica
o conhecimento do sistema de ficheiros que o dpkg gravou na sua base de dados. Para sistema de
compilação, isso . For build systems that dificulta a codificação dos nomes de caminhos para
binários ou bibliotecas específicas nos artefactos resultantes, também pode produzir pacotes que
sejam incompatíveis com sistemas de ficheiros não-usr fundidos.
usr-local-has-configs
O sistema tem ficheiros de configuração sob /usr/local/etc.
usr-local-has-includes
O sistema tem ficheiros cabeçalho sob /usr/local/include.
usr-local-has-programs
O sistema tem programas sob /usr/local/bin ou /usr/local/sbin.
usr-local-has-libraries
O sistema tem bibliotecas, sejam estáticas ou partilhadas sob /usr/local/lib.
Installed-Build-Depends: (necessário)
package-list
A lista de pacotes instalados e configurados que podem afectar o processo de compilação do pacote.
A lista consiste do nome de cada pacote, opcionalmente tem a qualificação da arquitectura para outras
arquitecturas, com uma restrição de versão exacta, separados por vírgulas.
A lista inclui todos os pacotes essenciais, os pacotes listados em Build-Depends, Build-Depends-Arch,
campos de controle de fonte Build-Depends-Indep, quaisquer dependências de compilação específicas do
fornecedor, e todas as suas dependências recursivas. Em Debian e derivados a dependência embutida é
build-essential.
Para as dependências que venham de campos de controle da fonte, todas as alternativas a dependências
e todos os fornecedores de pacotes virtuais de quais se depende serão incluídos.
Environment:
variable-list
A lista de variáveis de ambiente que se sabe afectarem o processo de compilação do pacote, com cada
variável de ambiente seguida por um sinal igual (‘=’) e o valor da variável citando entre aspas
(‘"’), e barras escapadas (‘\\’).
VEJA TAMBÉM
deb822(5), deb-changes(5), deb-version(7), dpkg-genbuildinfo(1).
TRADUÇÃO
Américo Monteiro
Se encontrar algum erro na tradução deste documento, por favor comunique para Américo Monteiro
<a_monteiro@gmx.com>.
1.21.1 2024-02-23 deb-buildinfo(5)