chiark - git - mdw - dpkg/blob - man/nl/deb-buildinfo.man

   1 .\" dpkg manual page - deb-buildinfo(5)
   2 .\"
   3 .\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk>
   4 .\" Copyright © 2010 Russ Allbery <rra@debian.org>
   5 .\" Copyright © 2015-2016 Guillem Jover <guillem@debian.org>
   6 .\"
   7 .\" This is free software; you can redistribute it and/or modify
   8 .\" it under the terms of the GNU General Public License as published by
   9 .\" the Free Software Foundation; either version 2 of the License, or
  10 .\" (at your option) any later version.
  11 .\"
  12 .\" This is distributed in the hope that it will be useful,
  13 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 .\" GNU General Public License for more details.
  16 .\"
  17 .\" You should have received a copy of the GNU General Public License
  18 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
  19 .
  20 .\"*******************************************************************
  21 .\"
  22 .\" This file was generated with po4a. Translate the source file.
  23 .\"
  24 .\"*******************************************************************
  25 .TH deb\-buildinfo 5 %RELEASE_DATE% %VERSION% dpkg\-suite
  26 .nh
  27 .SH NAAM
  28 deb\-buildinfo \- Indeling van het Debian bouw\-informatiebestand
  29 .
  30 .SH OVERZICHT
  31 \fIbestandsnaam\fP\fB.buildinfo\fP
  32 .
  33 .SH BESCHRIJVING
  34 Bij elke bouw (build) van een Debian broncodepakket kan de bouwinformatie
  35 opgeslagen worden in een \fB.buildinfo\fP\-controlebestand dat een aantal velden
  36 bevat. Ieder veld begint met een markering, zoals \fBSource\fP of \fBBinary\fP
  37 (niet hoofdlettergevoelig), gevolgd door een dubbele punt en de tekstinhoud
  38 van het veld. Velden worden enkel door veldmarkeringen begrensd. De
  39 tekstinhoud van het veld kan met andere woorden verschillende regels lang
  40 zijn, maar de installatiegereedschappen zullen bij het verwerken van de
  41 tekstinhoud de regels gewoonlijk samenvoegen (behalve in het geval van de
  42 multiregel\-velden \fBBinary\-Only\-Changes\fP, \fBInstalled\-Build\-Depends\fP,
  43 \fBEnvironment\fP, \fBChecksums\-Md5\fP, \fBChecksums\-Sha1\fP en \fBChecksums\-Sha256\fP;
  44 zie hierna)
  45 .PP
  46 De controle\-data mogen ingesloten liggen in een OpenPGP\-handtekening met
  47 ASCII\-harnas volgens de specificatie RFC4880.
  48 .PP
  49 De naam van het \fB.buildinfo\fP\-bestand is afhankelijk van het type bouw en is
  50 zo specifiek als nodig, maar niet meer. Voor een bouw die \fBany\fP bevat, is
  51 de naam \fIbroncode\-naam\fP\fB_\fP\fIbinaire\-versie\fP\fB_\fP\fIarch\fP\fB.buildinfo\fP. In
  52 geval het een bouw betreft die \fBall\fP bevat, is de naam
  53 \fIbroncode\-naam\fP\fB_\fP\fIbinaire\-versie\fP\fB_\fP\fBall.buildinfo\fP. En in geval het
  54 een bouw betreft die \fBsource\fP bevat, is de naam
  55 \fIbroncode\-naam\fP\fB_\fP\fIbroncode\-versie\fP\fB_\fP\fBsource.buildinfo\fP.
  56 .
  57 .SH VELDEN
  58 .TP
  59 \fBFormat:\fP \fIindelingsversie\fP (verplicht)
  60 De waarde van dit veld bepaalt de indelingsversie van het bestand. De
  61 syntaxis van de veldwaarde is een versienummer met een hoofdversie\- en een
  62 onderversiecomponent. Wijzigingen aan de indeling die niet neerwaarts
  63 compatibel zijn, hebben een verhoging van het hoofdversienummer tot gevolg
  64 en neerwaarts compatibele veranderingen (zoals het toevoegen van extra
  65 velden) verhogen het onderversienummer. De huidige indelingsversie is
  66 \fB1.0\fP.
  67 .TP
  68 \fBSource:\fP \fIbroncode\-naam\fP [\fB(\fP\fIbroncode\-versie\fP\fB)\fP] (verplicht)
  69 De naam van het broncodepakket. Indien de versie van het broncodepakket
  70 verschilt van de versie van het binaire pakket, dan zal de \fIbroncode\-naam\fP
  71 gevolgd worden door een \fIbroncode\-versie\fP tussen haakjes. Dit kan het geval
  72 zijn als de bouw gebeurt voor een uitsluitend binaire upload die niet door
  73 de onderhouder uitgevoerd wordt.
  74 .TP
  75 \fBBinary:\fP \fIlijst\-binaire\-pakketten\fP (verplicht)
  76 Dit gevouwen veld is een lijst, met spatie als scheidingsteken, van de
  77 gebouwde binaire pakketten.
  78 .TP
  79 \fBArchitecture:\fP \fIarch\-lijst\fP (verplicht)
  80 Dit veld met spaties als scheidingsteken, somt de architecturen op van de
  81 bestanden die momenteel gebouwd worden. Gebruikelijke architecturen zijn
  82 \fBamd64\fP, \fBarmel\fP, \fBi386\fP, enz. Merk op dat de waarde \fBall\fP bedoeld is
  83 voor pakketten die architectuuronafhankelijk zijn. Indien ook de broncode
  84 voor het pakket gebouwd wordt, is ook de bijzondere vermelding \fBsource\fP
  85 aanwezig. Jokertekens voor architecturen mogen nooit voorkomen in de lijst.
  86 .TP
  87 \fBVersion:\fP \fIversie\-tekenreeks\fP (verplicht)
  88 Gewoonlijk is dit het originele versienummer van het pakket, welke vorm de
  89 auteur van het programma er ook voor gebruikt. Het kan ook een
  90 Debian\-revisienummer bevatten (voor niet uit Debian stammende pakketten). De
  91 exacte indeling en het sorteringsalgoritme worden beschreven in
  92 \fBdeb\-version\fP(5).
  93 .TP
  94 \fBBinary\-Only\-Changes:\fP
  95 .TQ
  96 \fI changelog\-item\fP
  97 Dit multiregel\-veld bevat in voorkomend geval de samengevoegde tekst van het
  98 changelog\-item voor een uitsluitend binaire upload die niet door de
  99 onderhouder uitgevoerd wordt (een binary\-only non\-maintainer upload \-
 100 binNMU). Om van dit veld een geldig multiregel\-veld te maken, worden lege
 101 regels vervangen door één enkel punt (‘.’) en springen alle regels in met
 102 één spatie. De exacte inhoud hangt af van de changelog\-indeling.
 103 .TP
 104 \fBChecksums\-Md5:\fP (verplicht)
 105 .TQ
 106 \fBChecksums\-Sha1:\fP (verplicht)
 107 .TQ
 108 \fBChecksums\-Sha256:\fP (verplicht)
 109 .TQ
 110  \fIcontrolesom\fP \fIgrootte\fP \fIbestandsnaam\fP
 111 Deze multiregel\-velden bevatten een lijst van bestanden met voor elk van hen
 112 een controlesom en een grootte. Deze velden hebben een identieke syntaxis en
 113 verschillen onderling enkel inzake het gebruikte algoritme voor de
 114 controlesom: MD5 voor \fBChecksums\-Md5\fP, SHA\-1 voor \fBChecksums\-Sha1\fP en
 115 SHA\-256 voor \fBChecksums\-Sha256\fP.
 116
 117 De eerste regel van de veldwaarde (het deel dat op dezelfde regel staat als
 118 de door een dubbele punt gevolgde veldnaam) is steeds leeg. De inhoud van
 119 het veld wordt in de vervolgregels verwoord, één regel per bestand. Elke
 120 regel bestaat uit elementen die onderling door een spatie gescheiden zijn en
 121 het bestand beschrijven: zijn controlesom, zijn bestandsgrootte en zijn
 122 naam.
 123
 124 Deze velden sommen alle bestanden die de bouw vormen.
 125 .TP
 126 \fBBuild\-Origin:\fP\fI naam\fP
 127 De naam van de distributie waaruit dit pakket afkomstig is.
 128 .TP
 129 \fBBuild\-Architecture:\fP \fIarch\fP (verplicht)
 130 De Debian\-architectuur van de installatie waarin de pakketten gebouwd
 131 worden. Gebruikelijke architecturen zijn \fBamd64\fP, \fBarmel\fP, \fBi386\fP, enz.
 132 .TP
 133 \fBBuild\-Date:\fP \fIbouwdatum\fP
 134 De datum waarop het pakket gebouwd werd. Hij moet dezelfde indeling hebben
 135 als de datum in een \fBdeb\-changelog\fP(5)\-item.
 136 .TP
 137 \fBBuild\-Path:\fP \fIbouwpad\fP
 138 Het absoluut bouwpad, wat overeenkomt met de uitgepakte broncodeboom. Dit
 139 veld is enkel aanwezig als de leverancier het op de witte lijst geplaatst
 140 heeft aan de hand van een patroonvergelijking, om zo het eventueel weglekken
 141 van gevoelige informatie te voorkomen.
 142
 143 Op Debian en zijn derivaten zullen enkel bouwpaden die beginnen met
 144 \fI/build/\fP aanleiding geven tot het aanmaken van dit veld.
 145 .TP
 146 \fBInstalled\-Build\-Depends:\fP (verplicht)
 147 .TQ
 148 \fIpakketlijst\fP
 149 De lijst van geïnstalleerde en geconfigureerde pakketten die van invloed
 150 kunnen zijn op het proces van het bouwen van het pakket.
 151
 152 De lijst bestaat uit de naam van elk pakket, eventueel een
 153 architectuurkwalificatie voor andere architecturen, met een exacte
 154 versierestrictie, gescheiden door komma's.
 155
 156 De lijst bevat alle essentiële pakketten, pakketten vermeld in velden
 157 \fBBuild\-Depends\fP, \fBBuild\-Depends\-Arch\fP, \fBBuild\-Depends\-Indep\fP van de
 158 broncode, eventuele ingebouwde leveranciersspecifieke vereisten en al hun
 159 recursieve vereisten. Op Debian en zijn derivaten is de ingebouwde vereiste
 160 \fBbuild\-essential\fP.
 161
 162 Waar het vereisten betreft die afkomstig zijn uit de controlevelden van de
 163 broncode, worden ook alle vereistenalternatieven in aanmerking genomen en
 164 alle pakketten die voorzien in de virtuele pakketten die vereist worden.
 165 .TP
 166 \fBEnvironment:\fP
 167 .TQ
 168 \fIvariabelelijst\fP
 169 De lijst met omgevingsvariabelen waarvan bekend is dat zij het proces van
 170 het bouwen van het pakket beïnvloeden, waarbij elke variabele gevolgd wordt
 171 door een gelijkheidsteken (‘=’) en de waarde van de variabele tussen
 172 aanhalingstekens, wat dubbele aanhalingstekens (‘"’) moeten zijn, en waarbij
 173 de backslashes worden gemaskeerd (‘\e\e’).
 174 .
 175 .\" .SH EXAMPLE
 176 .\" .RS
 177 .\" .nf
 178 .\"
 179 .\" .fi
 180 .\" .RE
 181 .
 182 .SH "ZIE OOK"
 183 \fBdeb\-changes\fP(5), \fBdeb\-version\fP(5), \fBdpkg\-genbuildinfo\fP(1).