Ubuntu Manpages

deb-buildinfo

Indeling van het Debian bouw-informatiebestand

bestandsnaam.buildinfo

Bij elke bouw (build) van een Debian broncodepakket kan de bouwinformatie opgeslagen worden in een .buildinfo-controlebestand dat een aantal velden bevat. Ieder veld begint met een markering, zoals Source of Binary (niet hoofdlettergevoelig), gevolgd door een dubbele punt en de tekstinhoud van het veld. Velden worden enkel door veldmarkeringen begrensd. De tekstinhoud van het veld kan met andere woorden verschillende regels lang zijn, maar de installatiegereedschappen zullen bij het verwerken van de tekstinhoud de regels gewoonlijk samenvoegen (behalve in het geval van de multiregel-velden Binary-Only-Changes, Installed-Build-Depends, Environment, Checksums-Md5, Checksums-Sha1 en Checksums-Sha256; zie hierna)

De controle-data mogen ingesloten liggen in een OpenPGP-handtekening met ASCII-harnas volgens de specificatie RFC4880.

The name of the .buildinfo file will depend on the type of build and will be as specific as necessary but not more; for a build that includes any the name will be source-name_binary-version_arch.buildinfo, or otherwise for a build that includes all the name will be source-name_binary-version_all.buildinfo, or otherwise for a build that includes source the name will be source-name_source-version_source.buildinfo.

De waarde van dit veld bepaalt de indelingsversie van het bestand. De syntaxis van de veldwaarde is een versienummer met een hoofdversie- en een onderversiecomponent. Wijzigingen aan de indeling die niet neerwaarts compatibel zijn, hebben een verhoging van het hoofdversienummer tot gevolg en neerwaarts compatibele veranderingen (zoals het toevoegen van extra velden) verhogen het onderversienummer. De huidige indelingsversie is 1.0.
De naam van het broncodepakket. Indien de versie van het broncodepakket verschilt van de versie van het binaire pakket, dan zal de broncode-naam gevolgd worden door een broncode-versie tussen haakjes. Dit kan het geval zijn als de bouw gebeurt voor een uitsluitend binaire upload die niet door de onderhouder uitgevoerd wordt.
Dit gevouwen veld is een lijst, met spatie als scheidingsteken, van de gebouwde binaire pakketten.
Dit veld met spaties als scheidingsteken, somt de architecturen op van de bestanden die momenteel gebouwd worden. Gebruikelijke architecturen zijn amd64, armel, i386, enz. Merk op dat de waarde all bedoeld is voor pakketten die architectuuronafhankelijk zijn. Indien ook de broncode voor het pakket gebouwd wordt, is ook de bijzondere vermelding source aanwezig. Jokertekens voor architecturen mogen nooit voorkomen in de lijst.
Typically, this is the original package's version number in whatever form the program's author uses. It may also include a Debian revision number (for non-native packages). The exact format and sorting algorithm are described in deb-version(7).
Dit multiregel-veld bevat in voorkomend geval de samengevoegde tekst van het changelog-item voor een uitsluitend binaire upload die niet door de onderhouder uitgevoerd wordt (een binary-only non-maintainer upload - binNMU). Om van dit veld een geldig multiregel-veld te maken, worden lege regels vervangen door één enkel punt (‘.’) en springen alle regels in met één spatie. De exacte inhoud hangt af van de changelog-indeling.
Deze multiregel-velden bevatten een lijst van bestanden met voor elk van hen een controlesom en een grootte. Deze velden hebben een identieke syntaxis en verschillen onderling enkel inzake het gebruikte algoritme voor de controlesom: MD5 voor Checksums-Md5, SHA-1 voor Checksums-Sha1 en SHA-256 voor Checksums-Sha256.

De eerste regel van de veldwaarde (het deel dat op dezelfde regel staat als de door een dubbele punt gevolgde veldnaam) is steeds leeg. De inhoud van het veld wordt in de vervolgregels verwoord, één regel per bestand. Elke regel bestaat uit elementen die onderling door een spatie gescheiden zijn en het bestand beschrijven: zijn controlesom, zijn bestandsgrootte en zijn naam.

Deze velden sommen alle bestanden die de bouw vormen.

De naam van de distributie waaruit dit pakket afkomstig is.
De Debian-architectuur van de installatie waarin de pakketten gebouwd worden. Gebruikelijke architecturen zijn amd64, armel, i386, enz.
De datum waarop het pakket gebouwd werd. Hij moet dezelfde indeling hebben als de datum in een deb-changelog(5)-item.
The release and version (in an unspecified format) of the kernel running on the build system. This field is only going to be present if the builder has explicitly requested it, to avoid leaking possibly sensitive information.
Het absoluut bouwpad, wat overeenkomt met de uitgepakte broncodeboom. Dit veld is enkel aanwezig als de leverancier het op de witte lijst geplaatst heeft aan de hand van een patroonvergelijking, om zo het eventueel weglekken van gevoelige informatie te voorkomen.

On Debian and derivatives only build paths starting with /build/ will emit this field.

De lijst van geïnstalleerde en geconfigureerde pakketten die van invloed kunnen zijn op het proces van het bouwen van het pakket.

De lijst bestaat uit de naam van elk pakket, eventueel een architectuurkwalificatie voor andere architecturen, met een exacte versierestrictie, gescheiden door komma's.

De lijst bevat alle essentiële pakketten, pakketten vermeld in velden Build-Depends, Build-Depends-Arch, Build-Depends-Indep van de broncode, eventuele ingebouwde leveranciersspecifieke vereisten en al hun recursieve vereisten. Op Debian en zijn derivaten is de ingebouwde vereiste build-essential.

Waar het vereisten betreft die afkomstig zijn uit de controlevelden van de broncode, worden ook alle vereistenalternatieven in aanmerking genomen en alle pakketten die voorzien in de virtuele pakketten die vereist worden.

De lijst met omgevingsvariabelen waarvan bekend is dat zij het proces van het bouwen van het pakket beïnvloeden, waarbij elke variabele gevolgd wordt door een gelijkheidsteken (‘=’) en de waarde van de variabele tussen aanhalingstekens, wat dubbele aanhalingstekens (‘"’) moeten zijn, en waarbij de backslashes worden gemaskeerd (‘\\’).

deb-changes(5), deb-version(7), dpkg-genbuildinfo(1).