deb-buildinfo

Section: dpkg suite (5)
Updated: 1970-01-01
Page Index
 

NOME

deb-buildinfo - formato Debian de ficheiro de informação de compilação  

SINOPSE

filename.buildinfo  

DESCRIÇÃO

Each Debian source package build can record the build information in a .buildinfo control file, which contains a number of fields in deb822(5) format.

Each field begins with a tag, such as Source or Binary (case insensitive), followed by a colon, and the body of the field (case sensitive unless stated otherwise). Fields are delimited only by field tags. In other words, field text may be multiple lines in length, but the installation tools will generally join lines when processing the body of the field (except in case of the multiline fields Binary-Only-Changes, Installed-Build-Depends, Environment, Checksums-Md5, Checksums-Sha1 and Checksums-Sha256, see below).

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
The system has a merged /usr via aliased directories (previously known as merged-usr-via-symlinks). This will confuse dpkg-query, dpkg-statoverride, dpkg-trigger, update-alternatives and any other tool using pathnames as keys into their databases, as it creates filesystem aliasing problems, and messes with the understanding of the filesystem that dpkg has recorded in its database. For build systems that hardcode pathnames to specific binaries or libraries on the resulting artifacts, it can also produce packages that will be incompatible with non-/usr-merged filesystems.
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>.


 

Index

NOME
SINOPSE
DESCRIÇÃO
CAMPOS
VEJA TAMBÉM
TRADUÇÃO