.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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 2024-01-24 1.22.4 "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 NAMN
.IX Header "NAMN"
deb-buildinfo \- filformat f\(:or Debiansbygginformation
.SH SYNOPS
.IX Header "SYNOPS"
\&\fIfilnamn\fR\fB.buildinfo\fR
.SH BESKRIVNING
.IX Header "BESKRIVNING"
Alla Debian\-k\(:allkodspaket kan lagra bygginformation i en \fB.buildinfo\fR\-styrfil, som inneh\(oaller ett antal f\(:alt i \fBdeb822\fR\|(5)\-format.
.PP
Varje f\(:alt b\(:orjar med en etikett, s\(oasom \fBSource\fR eller \fBBinary\fR (skiftl\(:agesoberoende), f\(:oljt av ett kolontecken och f\(:altets kropp (skiftl\(:agesberoende s\(oavida inte annat anges). F\(:alt avdelas endast av f\(:altetiketter. Med andra ord kan texten i f\(:alten sp\(:anna \(:over flera rader, men installationsverktygen kommer oftast att sl\(oa samman rader n\(:ar kroppen tolkas (f\(:orutom n\(:ar det g\(:aller flerradsf\(:alten \fBBinary-Only-Changes\fR, \fBInstalled-Build-Depends\fR, \fBEnvironment\fR, \fBChecksums\-Md5\fR, \fBChecksums\-Sha1\fR och \fBChecksums\-Sha256\fR, se nedan).
.PP
Styrinformationen kan omges av en OpenPGP-signatur i ASCII-skal, s\(oasom beskrivs i RFC4880.
.PP
Namnet p\(oa \fB.buildinfo\fR\-filen kommer att bero p\(oa byggtypen och kommer att vara s\(oa specifik som m\(:ojligt, men inte mer; namnet kommer att vara:
.IP \fIk\(:allkodsnamn\fR\fB_\fR\fIbin\(:arversion\fR\fB_\fR\fIark\fR\fB.buildinfo\fR 4
.IX Item "k\(:allkodsnamn_bin\(:arversion_ark.buildinfo"
f\(:or ett bygge som inneh\(oaller \fBany\fR (n\(oagon)
.IP \fIk\(:allkodsnamn\fR\fB_\fR\fIbin\(:arversion\fR\fB_\fR\fBall.buildinfo\fR 4
.IX Item "k\(:allkodsnamn_bin\(:arversion_all.buildinfo"
annars f\(:or ett bygge som inneh\(oaller \fBall\fR (alla)
.IP \fIk\(:allkodsnamn\fR\fB_\fR\fIk\(:allkodsversion\fR\fB_\fR\fBsource.buildinfo\fR 4
.IX Item "k\(:allkodsnamn_k\(:allkodsversion_source.buildinfo"
annars f\(:or ett bygge som inneh\(oaller \fBsource\fR (k\(:allkod)
.SH F\(:ALT
.IX Header "F\(:ALT"
.IP "\fBFormat:\fR \fIformatversion\fR (kr\(:avs)" 4
.IX Item "Format: formatversion (kr\(:avs)"
V\(:ardet f\(:or f\(:altet anger filens formatversion. F\(:altets syntax \(:ar ett versionsnummer med en huvud\- och en underdel. \(:Andringar som inte \(:ar bak\(oatkompatibla \(:okar huvudversionen medan \(:andringar som \(:ar bak\(oatkompatibla (till exempel nya f\(:alt) \(:okar underversionen. Aktuell formatversion \(:ar \fB1.0\fR.
.IP "\fBSource:\fR \fIk\(:allkodsnamn\fR [\fB(\fR\fIk\(:allkodsversion\fR\fB)\fR] (kr\(:avs)" 4
.IX Item "Source: k\(:allkodsnamn [(k\(:allkodsversion)] (kr\(:avs)"
Namnet p\(oa k\(:allkodspaketet. Om k\(:allkodsversionen skiljer sig fr\(oan bin\(:arversionen kommer \fIk\(:allkodsnamn\fR f\(:oljas av \fIk\(:allkodsversion\fR i parentes. Detta kan uppst\(oa n\(:ar bygget \(:ar f\(:or en ins\(:andning best\(oaende av enbart bin\(:arer fr\(oan n\(oagon annan \(:an den paketansvarige (\(rqbinary\-only non-maintainer upload\(rq).
.IP "\fBBinary:\fR \fIbin\(:arpaketlista\fR (kr\(:avs i sammanhang)" 4
.IX Item "Binary: bin\(:arpaketlista (kr\(:avs i sammanhang)"
Det h\(:ar flerdelade f\(:altet \(:ar en blankstegsavdelad lista \(:over byggda bin\(:arpaket. Om endast k\(:allkod byggs kommer f\(:altet att uteslutas (sedan dpkg 1.20.0).
.IP "\fBArchitecture:\fR \fIark-lista\fR (kr\(:avs)" 4
.IX Item "Architecture: ark-lista (kr\(:avs)"
Detta blankstegsavdelade f\(:alt anger vilken sorts maskinvara paketet f\(:or tillf\(:allet byggs f\(:or. Vanliga arkitekturer \(:ar \fBamd64\fR, \fBarmel\fR, \fBi386\fR osv. Observera att v\(:ardet \fBall\fR \(:ar avsett f\(:or paket som \(:ar oberoende av arkitektur. Om k\(:allkoden f\(:or paketet ocks\(oa byggs kommer specialposten \fBsource\fR ocks\(oa vara med. Arkitekturer med jokertecken \(:ar inte till\(oatna i listan.
.IP "\fBVersion:\fR \fIversionsstr\(:ang\fR (kr\(:avs)" 4
.IX Item "Version: versionsstr\(:ang (kr\(:avs)"
Vanligtvis \(:ar detta det ursprungliga paketets versionsnummer p\(oa den form programmets f\(:orfattare anv\(:ander. Den kan \(:aven inneh\(oalla ett Debianuppdateringsnummer (f\(:or paket vars k\(:alla \(:ar utanf\(:or Debian). Exakt format och sorteringsalgoritm beskrivs i \fBdeb\-version\fR\|(7).
.IP \fBBinary-Only-Changes:\fR 4
.IX Item "Binary-Only-Changes:"
.PD 0
.IP "\ \fIpost\-fr\(oan\-\(:andringsloggen\fR" 4
.IX Item " post-fr\(oan-\(:andringsloggen"
.PD
Det h\(:ar flerradiga f\(:altet inneh\(oaller den sammanslagna texten fr\(oan \(:andringsloggposter f\(:or en ins\(:andning av enbart bin\(:arer fr\(oan n\(oagon annan \(:an paketansvarige (\(rqbinary\-only non-maintainer upload\(rq, binNMU) om detta \(:ar tillf\(:allet. F\(:or att g\(:ora f\(:altet till ett giltigt flerradsf\(:alt ers\(:atts tomma rader med en ensam punkt (\(rq.\(rq) och alla rader f\(oar ett teckens indrag. Exakt inneh\(oall beror p\(oa formatet p\(oa \(:andringsloggen.
.IP "\fBChecksums\-Md5:\fR (kr\(:avs)" 4
.IX Item "Checksums-Md5: (kr\(:avs)"
.PD 0
.IP "\fBChecksums\-Sha1:\fR (kr\(:avs)" 4
.IX Item "Checksums-Sha1: (kr\(:avs)"
.IP "\fBChecksums\-Sha256:\fR (kr\(:avs)" 4
.IX Item "Checksums-Sha256: (kr\(:avs)"
.IP "\ \fIkontrollsumma\fR \fIstorlek\fR \fIfilnamn\fR" 4
.IX Item " kontrollsumma storlek filnamn"
.PD
De h\(:ar flerradsf\(:alteten inneh\(oaller en lista med filer med en kontrollsumma och storlek f\(:or var och en. F\(:alten har samma syntax och skiljer sig bara vad g\(:aller vilken kontrollsummealgoritm som anv\(:ands: MD5 f\(:or \fBChecksums\-Md5\fR, SHA\-1 f\(:or \fBChecksums\-Sha1\fR och SHA\-256 f\(:or \fBChecksums\-Sha256\fR.
.Sp
F\(:orsta raden i f\(:altv\(:ardet (delen av p\(oa samma rad som f\(:altnamnet f\(:oljt av kolon) \(:ar alltid tom. Inneh\(oallet i f\(:altet anges som forts\(:attningsrader, en rad per fil. Varje rad best\(oar av blankstegsavdelade f\(:alt som beskriver filen: kontrollsumman, filstorleken och filnamnet.
.Sp
De h\(:ar f\(:alten visar alla filer bygget best\(oar av.
.IP "\fBBuild-Origin:\fR \fInamn\fR" 4
.IX Item "Build-Origin: namn"
Namnet p\(oa den distribution paketet h\(:arstammar fr\(oan.
.IP "\fBBuild-Architecture:\fR \fIark\fR (kr\(:avs)" 4
.IX Item "Build-Architecture: ark (kr\(:avs)"
Debianarkitekturen f\(:or den installation paketen byggs i. Vanliga arkitekturer \(:ar \fBamd64\fR, \fBarmel\fR, \fBi386\fR osv.
.IP "\fBBuild-Date:\fR \fIbyggdatum\fR" 4
.IX Item "Build-Date: byggdatum"
Datumet paketet byggdes. Det m\(oaste vara p\(oa samma format som datumet i en \fBdeb\-changelog\fR\|(5)\-post.
.IP "\fBBuild-Kernel-Version:\fR \fIbyggk\(:arneversion\fR" 4
.IX Item "Build-Kernel-Version: byggk\(:arneversion"
Utg\(oava och version (i ett inte specificerat format) f\(:or k\(:arnan som k\(:ors p\(oa byggsystemet. F\(:altet kommer endast finnas om byggaren specifikt har bett om det, f\(:or att undg\(oa att l\(:acka m\(:ojligt k\(:anslig information.
.IP "\fBBuild-Path:\fR \fIbyggs\(:okv\(:ag\fR" 4
.IX Item "Build-Path: byggs\(:okv\(:ag"
Absolut byggs\(:okv\(:ag som motsvarar det uppackade k\(:allkodstr\(:adet. F\(:altet kommer endast finnas om \(oaterf\(:ors\(:aljaren till\(oater det via en m\(:onsterigenk\(:anning f\(:or att undg\(oa att l\(:acka m\(:ojligt k\(:anslig information.
.Sp
P\(oa Debian och dess derivat till\(oats bara byggs\(:okv\(:agar som b\(:orjar med \fI/build/\fR att ta med detta f\(:alt.
.IP \fBBuild-Tainted-By:\fR 4
.IX Item "Build-Tainted-By:"
.PD 0
.IP "\ \fIlista\-f\(:ord\(:arvelsesorsaker\fR" 4
.IX Item " lista-f\(:ord\(:arvelsesorsaker"
.PD
Det h\(:ar flerdelade f\(:altet inneh\(oaller en blankstegsavdelad lista \(:over ofullst\(:andiga orsagstaggar (best\(oaende av alfanumeriska tecken och bindestreck) som anger varf\(:or aktuellt bygge har f\(:ord\(:arvats (sedan dpkg 1.19.5).
.Sp
P\(oa Debian och dess derivat kan f\(:oljande orsakstaggar skapas:
.RS 4
.IP \fBmerged-usr-via-aliased-dirs\fR 4
.IX Item "merged-usr-via-aliased-dirs"
Systemet har en sammanslagen \fI/usr\fR via aliaskataloger (tidigare k\(:ant som \fBmerged-usr-via-symlinks\fR). Detta kommer f\(:orvirra \fBdpkg-query\fR, \fBdpkg-statoverride\fR, \fBdpkg-trigger\fR, \fBupdate-alternatives\fR och andra verktyg som anv\(:ander s\(:okv\(:agsnamn som nyckel i sina databaser, eftersom det skapar filsystemaliasproblem och st\(:or f\(:orst\(oaelsen av filsystemet som \fBdpkg\fR har lagrat i sin databas. F\(:or byggsystem som h\(oardkodar s\(:okv\(:agar till specifika bin\(:arer eller bibliotek i de resulterande artefakterna kan det ocks\(oa skapa paket som \(:ar inkompatibla med system som inte har /usr\-sammanslagna filsystem.
.IP \fBusr-local-has-configs\fR 4
.IX Item "usr-local-has-configs"
Systemet har konfigurationsfiler under \fI/usr/local/etc\fR.
.IP \fBusr-local-has-includes\fR 4
.IX Item "usr-local-has-includes"
Systemer har huvudfiler under \fI/usr/local/include\fR.
.IP \fBusr-local-has-programs\fR 4
.IX Item "usr-local-has-programs"
Systemet har program under \fI/usr/local/bin\fR och \fI/usr/local/sbin\fR.
.IP \fBusr-local-has-libraries\fR 4
.IX Item "usr-local-has-libraries"
Systemet har bibliotek, antingen statiska eller delade, under \fI/usr/local/lib\fR.
.IP \fBcan-execute-cross-built-programs\fR 4
.IX Item "can-execute-cross-built-programs"
Systemet kan k\(:ora korskompilerade program, antingen direkt eller via ett emuleringslager.
.Sp
St\(:ods sedan dpkg 1.21.10.
.RE
.RS 4
.RE
.IP "\fBInstalled-Build-Depends:\fR (kr\(:avs)" 4
.IX Item "Installed-Build-Depends: (kr\(:avs)"
.PD 0
.IP "\ \fIpaketlista\fR" 4
.IX Item " paketlista"
.PD
Listan \(:over intallerade och konfigurerade paket som kan p\(oaverka paketets byggprocess.
.Sp
Listan inneh\(oaller varje paketnamn, m\(:ojligen med en angiven arkitektur f\(:or oegna arkitekturer, med en exakt versionsbegr\(:ansning, avdelade med kommatecken.
.Sp
Listan inneh\(oaller alla systemkritiska paket, paket angivna i k\(:allkodens styrf\(:alt \fBBuild-Depends\fR, \fBBuild-Depends-Arch\fR, \fBBuild-Depends-Indep\fR, eventuella \(oaterf\(:ors\(:aljarspecifika inbyggda beroenden och alla deras rekursiva beroenden. P\(oa Debian och dess derivat \(:ar det inbyggda beroendet \fBbuild-essential\fR.
.Sp
Alla beroendealternativ och alla f\(:ors\(:ojare av virtuella paketberoenden kommer tas med f\(:or beroenden som kommer fr\(oan f\(:alt i k\(:allkodsstyrfilen.
.IP \fBEnvironment:\fR 4
.IX Item "Environment:"
.PD 0
.IP "\ \fIvariabellista\fR" 4
.IX Item " variabellista"
.PD
Listan \(:over milj\(:ovariabler som \(:ar k\(:anda f\(:or att p\(oaverka paketbyggprocessen, d\(:ar varje milj\(:ovariabel f\(:oljs av ett likamedtecken (\(rq=\(rq) och variabelns citerade v\(:arde, inom dubbla citattecken (\(cq"\(cq) och med omv\(:anda snedstreck ersatta (\(rq\e\e\(rq).
.SH "SE \(:AVEN"
.IX Header "SE \(:AVEN"
\&\fBdeb822\fR\|(5), \fBdeb\-changes\fR\|(5), \fBdeb\-version\fR\|(7), \fBdpkg\-genbuildinfo\fR\|(1).
.SH \(:OVERS\(:ATTNING
.IX Header "\(:OVERS\(:ATTNING"
Peter Krefting och Daniel Nylander.