Provided by: dpkg-dev_1.19.7ubuntu3.2_all 
NAAM
deb-buildinfo - Indeling van het Debian bouw-informatiebestand
OVERZICHT
bestandsnaam.buildinfo
BESCHRIJVING
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.
De naam van het .buildinfo-bestand is afhankelijk van het type bouw en is zo specifiek als
nodig, maar niet meer. Voor een bouw die any bevat, is de naam
broncode-naam_binaire-versie_arch.buildinfo. In geval het een bouw betreft die all bevat,
is de naam broncode-naam_binaire-versie_all.buildinfo. En in geval het een bouw betreft
die source bevat, is de naam broncode-naam_broncode-versie_source.buildinfo.
VELDEN
Format: indelingsversie (verplicht)
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.
Source: broncode-naam [(broncode-versie)] (verplicht)
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.
Binary: lijst-binaire-pakketten (verplicht)
Dit gevouwen veld is een lijst, met spatie als scheidingsteken, van de gebouwde
binaire pakketten.
Architecture: arch-lijst (verplicht)
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.
Version: versie-tekenreeks (verplicht)
Gewoonlijk is dit het originele versienummer van het pakket, welke vorm de auteur
van het programma er ook voor gebruikt. Het kan ook een Debian-revisienummer
bevatten (voor niet uit Debian stammende pakketten). De exacte indeling en het
sorteringsalgoritme worden beschreven in deb-version(7).
Binary-Only-Changes:
changelog-item
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.
Checksums-Md5: (verplicht)
Checksums-Sha1: (verplicht)
Checksums-Sha256: (verplicht)
controlesom grootte bestandsnaam
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.
Build-Origin: naam
De naam van de distributie waaruit dit pakket afkomstig is.
Build-Architecture: arch (verplicht)
De Debian-architectuur van de installatie waarin de pakketten gebouwd worden.
Gebruikelijke architecturen zijn amd64, armel, i386, enz.
Build-Date: bouwdatum
De datum waarop het pakket gebouwd werd. Hij moet dezelfde indeling hebben als de
datum in een deb-changelog(5)-item.
Build-Kernel-Version: bouwkernel-versie
De uitgave en de versie (in een niet-gespecificeerde indeling) van de kernel die op
het bouwsysteem functioneert. Dit veld zal enkel aanwezig zijn als het
bouwprogramma er expliciet om gevraagd heeft, om het eventueel weglekken van
gevoelige informatie te voorkomen.
Build-Path: bouwpad
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.
Op Debian en zijn derivaten zullen enkel bouwpaden die beginnen met /build/
aanleiding geven tot het aanmaken van dit veld.
Build-Tainted-By:
lijst-met-bezoedelingsredenen
Dit gevouwen veld bevat een niet-exhaustieve lijst, met spatie als scheidingsteken,
van labels (samengesteld uit alfanumerieke tekens en gedachtestreepjes) met redenen
die aanduiden waarom de huidige bouw bezoedeld werd (sinds dpkg 1.19.5).
Op Debian en zijn derivaten kunnen de volgende reden-labels gegeven worden:
merged-usr-via-symlinks
Het systeem heeft een via symbolische koppelingen samengevoegde map /usr.
Dit sticht verwarring bij dpkg-query, dpkg-statoverride, dpkg-trigger,
update-alternatives en elk ander hulpmiddel dat in zijn databank gebruik
maakt van padnamen als sleutel, omdat het zorgt voor problemen met aliassen
in het bestandssysteem en knoeit met het overzicht van het bestandssysteem
dat dpkg in zijn databank opgeslagen heeft. Met bouwsystemen die in de door
hen gemaakte objecten gebruik maken van vaste padnamen naar specifieke
uitvoerbare bestanden of bibliotheken, kan dit ook leiden tot pakketten die
niet compatibel zijn met bestandssystemen zonder samengevoegde /usr-map.
usr-local-has-configs
Het systeem bevat configuratiebestanden onder /usr/local/etc.
usr-local-has-includes
Het systeem bevat kopbestanden onder /usr/local/include.
usr-local-has-programs
Op het systeem staan programma's onder /usr/local/bin of /usr/local/sbin.
usr-local-has-libraries
Het systeem bevat statische of gedeelde bibliotheken onder /usr/local/lib.
Installed-Build-Depends: (verplicht)
pakketlijst
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.
Environment:
variabelelijst
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 (‘\\’).
ZIE OOK
deb-changes(5), deb-version(7), dpkg-genbuildinfo(1).