.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "deb-buildinfo 5"
.TH deb-buildinfo 5 "2022-09-01" "1.20.12" "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAAM"
.IX Header "NAAM"
deb-buildinfo \- Indeling van het Debian bouw-informatiebestand
.SH "OVERZICHT"
.IX Header "OVERZICHT"
\&\fIbestandsnaam\fR\fB.buildinfo\fR
.SH "BESCHRIJVING"
.IX Header "BESCHRIJVING"
Van elke bouw van een Debian broncodepakket kan de bouwinformatie opgeslagen
worden in een controlebestand \fB.buildinfo\fR, dat een aantal velden bevat
volgens de indeling \fBdeb822\fR\|(5).
.PP
Ieder veld begint met een markering, zoals \fBSource\fR of \fBBinary\fR (niet
hoofdlettergevoelig), gevolgd door een dubbele punt en de tekstinhoud van
het veld (hoofdlettergevoelig tenzij anders vermeld). 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 \fBBinary-Only-Changes\fR,
\&\fBInstalled-Build-Depends\fR, \fBEnvironment\fR, \fBChecksums\-Md5\fR,
\&\fBChecksums\-Sha1\fR en \fBChecksums\-Sha256\fR; zie hierna)
.PP
De controle-data mogen ingesloten liggen in een OpenPGP-handtekening met
ASCII-harnas volgens de specificatie \s-1RFC4880.\s0
.PP
De naam van het \fB.buildinfo\fR\-bestand is afhankelijk van het type bouw en is
zo specifiek als nodig, maar niet meer. Voor een bouw die \fBany\fR bevat, is
de naam \fIbroncode-naam\fR\fB_\fR\fIbinaire-versie\fR\fB_\fR\fIarch\fR\fB.buildinfo\fR. In
geval het een bouw betreft die \fBall\fR bevat, is de naam
\&\fIbroncode-naam\fR\fB_\fR\fIbinaire-versie\fR\fB_\fR\fBall.buildinfo\fR. En in geval het
een bouw betreft die \fBsource\fR bevat, is de naam
\&\fIbroncode-naam\fR\fB_\fR\fIbroncode-versie\fR\fB_\fR\fBsource.buildinfo\fR.
.SH "VELDEN"
.IX Header "VELDEN"
.IP "\fBFormat:\fR \fIindelingsversie\fR (verplicht)" 4
.IX Item "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
\&\fB1.0\fR.
.IP "\fBSource:\fR \fIbroncode-naam\fR [\fB(\fR\fIbroncode-versie\fR\fB)\fR] (verplicht)" 4
.IX Item "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 \fIbroncode-naam\fR
gevolgd worden door een \fIbroncode-versie\fR tussen haakjes. Dit kan het geval
zijn als de bouw gebeurt voor een uitsluitend binaire upload die niet door
de onderhouder uitgevoerd wordt.
.IP "\fBBinary:\fR \fIlijst-binaire-pakketten\fR (vereist in de context)" 4
.IX Item "Binary: lijst-binaire-pakketten (vereist in de context)"
Dit samengevouwen veld is een met een spatie gescheiden lijst van gebouwde
binaire pakketten. Indien de bouw enkel de broncode betreft, dan wordt het
veld weggelaten (sinds dpkg 1.20.0).
.IP "\fBArchitecture:\fR \fIarch-lijst\fR (verplicht)" 4
.IX Item "Architecture: arch-lijst (verplicht)"
Dit veld met spaties als scheidingsteken, somt de architecturen op van de
bestanden die momenteel gebouwd worden. Gebruikelijke architecturen zijn
\&\fBamd64\fR, \fBarmel\fR, \fBi386\fR, enz. Merk op dat de waarde \fBall\fR bedoeld is
voor pakketten die architectuuronafhankelijk zijn. Indien ook de broncode
voor het pakket gebouwd wordt, is ook de bijzondere vermelding \fBsource\fR
aanwezig. Jokertekens voor architecturen mogen nooit voorkomen in de lijst.
.IP "\fBVersion:\fR \fIversie-tekenreeks\fR (verplicht)" 4
.IX Item "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
\&\fBdeb-version\fR(7).
.IP "\fBBinary-Only-Changes:\fR" 4
.IX Item "Binary-Only-Changes:"
.PD 0
.IP " \fIchangelog-item\fR" 4
.IX Item " changelog-item"
.PD
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 \('e\('en enkel punt (\(oq.\(cq) en springen alle regels in met
\('e\('en spatie. De exacte inhoud hangt af van de changelog-indeling.
.IP "\fBChecksums\-Md5:\fR (verplicht)" 4
.IX Item "Checksums-Md5: (verplicht)"
.PD 0
.IP "\fBChecksums\-Sha1:\fR (verplicht)" 4
.IX Item "Checksums-Sha1: (verplicht)"
.IP "\fBChecksums\-Sha256:\fR (verplicht)" 4
.IX Item "Checksums-Sha256: (verplicht)"
.IP " \fIcontrolesom\fR \fIgrootte\fR \fIbestandsnaam\fR" 4
.IX Item " controlesom grootte bestandsnaam"
.PD
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: \s-1MD5\s0 voor \fBChecksums\-Md5\fR, \s-1SHA\-1\s0 voor \fBChecksums\-Sha1\fR en
\&\s-1SHA\-256\s0 voor \fBChecksums\-Sha256\fR.
.Sp
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, \('e\('en 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.
.Sp
Deze velden sommen alle bestanden die de bouw vormen.
.IP "\fBBuild-Origin:\fR \fInaam\fR" 4
.IX Item "Build-Origin: naam"
De naam van de distributie waaruit dit pakket afkomstig is.
.IP "\fBBuild-Architecture:\fR \fIarch\fR (verplicht)" 4
.IX Item "Build-Architecture: arch (verplicht)"
De Debian-architectuur van de installatie waarin de pakketten gebouwd
worden. Gebruikelijke architecturen zijn \fBamd64\fR, \fBarmel\fR, \fBi386\fR, enz.
.IP "\fBBuild-Date:\fR \fIbouwdatum\fR" 4
.IX Item "Build-Date: bouwdatum"
De datum waarop het pakket gebouwd werd. Hij moet dezelfde indeling hebben
als de datum in een \fBdeb-changelog\fR(5)\-item.
.IP "\fBBuild-Kernel-Version:\fR \fIbouwkernel-versie\fR" 4
.IX 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.
.IP "\fBBuild-Path:\fR \fIbouwpad\fR" 4
.IX Item "Build-Path: bouwpad"
Het absoluut bouwpad, wat overeenkomt met de uitgepakte broncodeboom. Dit
veld is enkel aanwezig als de leverancier het toegelaten heeft aan de hand
van een patroonvergelijking om het eventueel weglekken van gevoelige
informatie te voorkomen.
.Sp
Op Debian en zijn derivaten zullen enkel bouwpaden die beginnen met
\&\fI/build/\fR aanleiding geven tot het aanmaken van dit veld.
.IP "\fBBuild-Tainted-By:\fR" 4
.IX Item "Build-Tainted-By:"
.PD 0
.IP " \fIlijst-met-bezoedelingsredenen\fR" 4
.IX Item " lijst-met-bezoedelingsredenen"
.PD
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).
.Sp
Op Debian en zijn derivaten kunnen de volgende reden-labels gegeven worden:
.RS 4
.IP "\fBmerged-usr-via-aliased-dirs\fR" 4
.IX Item "merged-usr-via-aliased-dirs"
Het systeem heeft een via aliassen samengevoegde map \fI/usr\fR (vroeger gekend
als \fBmerged-usr-via-symlinks\fR). Dit sticht verwarring bij \fBdpkg-query\fR,
\&\fBdpkg-statoverride\fR, \fBdpkg-trigger\fR, \fBupdate-alternatives\fR 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 \fBdpkg\fR 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.
.IP "\fBusr-local-has-configs\fR" 4
.IX Item "usr-local-has-configs"
Het systeem bevat configuratiebestanden onder \fI/usr/local/etc\fR.
.IP "\fBusr-local-has-includes\fR" 4
.IX Item "usr-local-has-includes"
Het systeem bevat kopbestanden onder \fI/usr/local/include\fR.
.IP "\fBusr-local-has-programs\fR" 4
.IX Item "usr-local-has-programs"
Op het systeem staan programma's onder \fI/usr/local/bin\fR of
\&\fI/usr/local/sbin\fR.
.IP "\fBusr-local-has-libraries\fR" 4
.IX Item "usr-local-has-libraries"
Het systeem bevat statische of gedeelde bibliotheken onder
\&\fI/usr/local/lib\fR.
.RE
.RS 4
.RE
.IP "\fBInstalled-Build-Depends:\fR (verplicht)" 4
.IX Item "Installed-Build-Depends: (verplicht)"
.PD 0
.IP " \fIpakketlijst\fR" 4
.IX Item " pakketlijst"
.PD
De lijst van ge\(:installeerde en geconfigureerde pakketten die van invloed
kunnen zijn op het proces van het bouwen van het pakket.
.Sp
De lijst bestaat uit de naam van elk pakket, eventueel een
architectuurkwalificatie voor andere architecturen, met een exacte
versierestrictie, gescheiden door komma's.
.Sp
De lijst bevat alle essenti\(:ele pakketten, pakketten vermeld in velden
\&\fBBuild-Depends\fR, \fBBuild-Depends-Arch\fR, \fBBuild-Depends-Indep\fR van de
broncode, eventuele ingebouwde leveranciersspecifieke vereisten en al hun
recursieve vereisten. Op Debian en zijn derivaten is de ingebouwde vereiste
\&\fBbuild-essential\fR.
.Sp
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.
.IP "\fBEnvironment:\fR" 4
.IX Item "Environment:"
.PD 0
.IP " \fIvariabelelijst\fR" 4
.IX Item " variabelelijst"
.PD
De lijst met omgevingsvariabelen waarvan bekend is dat zij het proces van
het bouwen van het pakket be\(:invloeden, waarbij elke variabele gevolgd wordt
door een gelijkheidsteken (\(oq=\(cq) en de waarde van de variabele tussen
aanhalingstekens, wat dubbele aanhalingstekens (\(oq"\(cq) moeten zijn, en waarbij
de backslashes worden gemaskeerd (\(oq\e\e\(cq).
.SH "ZIE OOK"
.IX Header "ZIE OOK"
\&\fBdeb822\fR\|(5), \fBdeb-changes\fR(5), \fBdeb-version\fR(7), \fBdpkg-genbuildinfo\fR(1).