Commit | Line | Data |
---|---|---|
1479465f GJ |
1 | .\" dpkg manual page - dpkg-buildpackage(1) |
2 | .\" | |
3 | .\" Copyright © 1995-1996 Ian Jackson | |
4 | .\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> | |
5 | .\" Copyright © 2007-2008 Frank Lichtenheld <djpig@debian.org> | |
6 | .\" Copyright © 2008-2015 Guillem Jover <guillem@debian.org> | |
7 | .\" Copyright © 2008-2012 Raphaël Hertzog <hertzog@debian.org> | |
8 | .\" | |
9 | .\" This is free software; you can redistribute it and/or modify | |
10 | .\" it under the terms of the GNU General Public License as published by | |
11 | .\" the Free Software Foundation; either version 2 of the License, or | |
12 | .\" (at your option) any later version. | |
13 | .\" | |
14 | .\" This is distributed in the hope that it will be useful, | |
15 | .\" but WITHOUT ANY WARRANTY; without even the implied warranty of | |
16 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
17 | .\" GNU General Public License for more details. | |
18 | .\" | |
19 | .\" You should have received a copy of the GNU General Public License | |
20 | .\" along with this program. If not, see <https://www.gnu.org/licenses/>. | |
21 | . | |
22 | .\"******************************************************************* | |
23 | .\" | |
24 | .\" This file was generated with po4a. Translate the source file. | |
25 | .\" | |
26 | .\"******************************************************************* | |
27 | .TH dpkg\-buildpackage 1 %RELEASE_DATE% %VERSION% dpkg\-suite | |
28 | .nh | |
29 | .SH NAAM | |
30 | dpkg\-buildpackage \- binaire of broncodepakketten bouwen uit de broncode | |
31 | . | |
32 | .SH OVERZICHT | |
33 | \fBdpkg\-buildpackage\fP [\fIoptie\fP...] | |
34 | . | |
35 | .SH BESCHRIJVING | |
36 | \fBdpkg\-buildpackage\fP is een programma dat het proces van het bouwen van een | |
37 | Debian pakket automatiseert. Het bestaat uit de volgende stappen: | |
38 | .IP \fB1.\fP 3 | |
39 | Het bereidt de bouwomgeving voor door verschillende omgevingsvariabelen in | |
40 | te stellen(zie \fBOMGEVING\fP), voert de uitbreiding (hook) \fBinit\fP uit en | |
41 | roept \fBdpkg\-source \-\-before\-build\fP aan (tenzij \fB\-T\fP of \fB\-\-target\fP | |
42 | gebruikt werd). | |
43 | .IP \fB2.\fP 3 | |
44 | Het controleert of voldaan is aan de bouw\-vereisten en de | |
45 | bouw\-tegenstrijdigheden (tenzij \fB\-d\fP of \fB\-\-no\-check\-builddeps\fP opgegeven | |
46 | werd). | |
47 | .IP \fB3.\fP 3 | |
48 | Indien met de optie \fB\-T\fP of \fB\-\-target\fP een of meer specifieke doelen | |
49 | geselecteerd werden, roept het deze doelen aan en stopt dan. Anders voert | |
50 | het de uitbreiding (hook) \fBpreclean\fP uit en roept het \fBfakeroot | |
51 | debian/rules clean\fP aan om de bouwboom zuiver te maken (tenzij \fB\-nc\fP of | |
52 | \fB\-\-no\-pre\-clean\fP opgegeven werd). | |
53 | .IP \fB4.\fP 3 | |
54 | Het voert de uitbreiding (hook) \fBsource\fP uit en roept \fBdpkg\-source \-b\fP aan | |
55 | om het broncodepakket te genereren (indien het bouwen van \fBsource\fP | |
56 | aangevraagd werd met \fB\-\-build\fP of gelijkwaardige opties). | |
57 | .IP \fB5.\fP 3 | |
58 | Het voert de uitbreiding (hook) \fBbuild\fP uit en roept \fBdebian/rules\fP | |
59 | \fIbuild\-target\fP aan. Het voert vervolgens de uitbreiding (hook) \fBbinary\fP | |
60 | uit, gevolgd door \fBfakeroot debian/rules\fP \fIbinary\-target\fP (tenzij enkel de | |
61 | bouw van het broncodepakket gevraagd werd met \fB\-\-build=source\fP of | |
62 | gelijkwaardige opties). Merk op dat \fIbuild\-target\fP en \fIbinary\-target\fP | |
63 | ofwel \fBbuild\fP en \fBbinary\fP zijn (de standaardsituatie, of indien een bouw | |
64 | van het type \fBany\fP en \fBall\fP aangevraagd werd met \fB\-\-build\fP of | |
65 | gelijkwaardige opties), ofwel \fBbuild\-arch\fP en \fBbinary\-arch\fP (indien een | |
66 | bouw van het type \fBany\fP maar niet \fBall\fP aangevraagd werd met \fB\-\-build\fP of | |
67 | gelijkwaardige opties), ofwel \fBbuild\-indep\fP en \fBbinary\-indep\fP (indien een | |
68 | bouw van het type \fBall\fP maar niet \fBany\fP aangevraagd werd met \fB\-\-build\fP of | |
69 | gelijkwaardige opties). | |
70 | .IP \fB6.\fP 3 | |
71 | Het voert de uitbreiding (hook) \fBbuildinfo\fP uit en roept | |
72 | \fBdpkg\-genbuildinfo\fP aan om een bestand \fB.buildinfo\fP aan te | |
73 | maken. Verschillende opties van \fBdpkg\-buildpackage\fP worden aan | |
74 | \fBdpkg\-genbuildinfo\fP overgemaakt. | |
75 | .IP \fB7.\fP 3 | |
76 | Het voert de uitbreiding (hook) \fBchanges\fP uit en roept \fBdpkg\-genchanges\fP | |
77 | aan om een bestand \fB.changes\fP aan te maken. De naam van het | |
78 | \&\fB.changes\fP\-bestand is afhankelijk van het bouwtype en zal zo specifiek als | |
79 | nodig zijn, maar niet meer dan dat. Voor een bouw die \fBany\fP bevat, zal de | |
80 | naam \fIbroncode\-naam\fP\fB_\fP\fIbinaire\-versie\fP\fB_\fP\fIarch\fP\fB.changes\fP zijn. Voor | |
81 | een bouw die \fBall\fP bevat, zal de naam | |
82 | \fIbroncode\-naam\fP\fB_\fP\fIbinaire\-versie\fP\fB_\fP\fBall.changes\fP zijn. En voor een | |
83 | bouw die \fBsource\fP bevat, zal de naam | |
84 | \fIbroncode\-naam\fP\fB_\fP\fIbroncode\-versie\fP\fB_\fP\fBsource.changes\fP zijn. Veel | |
85 | opties van \fBdpkg\-buildpackage\fP worden aan \fBdpkg\-genchanges\fP overgemaakt. | |
86 | .IP \fB8.\fP 3 | |
87 | Het voert de uitbreiding (hook) \fBpostclean\fP uit en als \fB\-tc\fP of | |
88 | \fB\-\-post\-clean\fP werd opgegeven zal het nogmaals \fBfakeroot debian/rules | |
89 | clean\fP aanroepen. | |
90 | .IP \fB9.\fP 3 | |
91 | Het roept \fBdpkg\-source \-\-after\-build\fP aan. | |
92 | .IP \fB10.\fP 3 | |
93 | Het voert de uitbreiding (hook) \fBcheck\fP uit en roept een | |
94 | pakketcontroleprogramma aan voor nazicht van het bestand \fB.changes\fP (indien | |
95 | er in \fBDEB_CHECK_COMMAND\fP of met \fB\-\-check\-command\fP een commando opgegeven | |
96 | werd). | |
97 | .IP \fB11.\fP 3 | |
98 | Het voert de uitbreiding (hook) \fBsign\fP uit en roept \fBgpg2\fP of \fBgpg\fP aan | |
99 | (voor zover het geen bouw van het type UNRELEASED is) voor het ondertekenen | |
100 | van het bestand \fB.dsc\fP (als dat bestaat, tenzij \fB\-us\fP of | |
101 | \fB\-\-unsigned\-source\fP opgegeven werden), van het bestand \fB.buildinfo\fP | |
102 | (tenzij \fB\-ui\fP, \fB\-\-unsigned\-buildinfo\fP, \fB\-uc\fP of \fB\-\-unsigned\-changes\fP | |
103 | opgegeven werden) en van het bestand \fB.changes\fP (tenzij \fB\-uc\fP of | |
104 | \fB\-\-unsigned\-changes\fP opgegeven werden). | |
105 | .IP \fB12.\fP 3 | |
106 | Het voert de uitbreiding (hook) \fBdone\fP uit. | |
107 | . | |
108 | .SH OPTIES | |
109 | Alle opties kunnen zowel opgegeven worden aan de commandoregel als in de | |
110 | systeem\- en gebruikersconfiguratiebestanden voor \fBdpkg\-buildpackage\fP. Elke | |
111 | regel in het configuratiebestand is ofwel een optie (exact hetzelfde als de | |
112 | commandoregeloptie, maar zonder de verbindingsstreepjes aan het begin) of | |
113 | commentaar (als hij begint met een ‘\fB#\fP’). | |
114 | ||
115 | .TP | |
116 | \fB\-\-build=\fP\fItype\fP | |
117 | Geeft het bouw\-\fItype\fP op vanuit een lijst van door komma's gescheiden | |
118 | componenten (sinds dpkg 1.18.5). Wordt doorgegeven aan \fBdpkg\-genchanges\fP. | |
119 | ||
120 | De waarden die gebruikt mogen worden zijn: | |
121 | .RS | |
122 | .TP | |
123 | \fBsource\fP | |
124 | Bouwt het broncodepakket. Opmerking: Indien u deze waarde op zichzelf staand | |
125 | gebruikt en indien het gewoon (opnieuw) bouwen van het bronpakket het enige | |
126 | is wat u wilt doen, dan is het altijd beter om \fBdpkg\-source\fP te gebruiken, | |
127 | aangezien dat niet vereist dat eventuele bouwvereisten geïnstalleerd worden | |
128 | om het doel \fBclean\fP te aanroepen. | |
129 | .TP | |
130 | \fBany\fP | |
131 | Bouwt de architectuurspecifieke binaire pakketten. | |
132 | .TP | |
133 | \fBall\fP | |
134 | Bouwt de architectuuronafhankelijke binaire pakketten. | |
135 | .TP | |
136 | \fBbinary\fP | |
137 | Bouwt de architectuurspecifieke en de architectuuronafhankelijke binaire | |
138 | pakketten. Dit is een alias voor \fBany,all\fP. | |
139 | .TP | |
140 | \fBfull\fP | |
141 | Bouwt alles. Dit is een alias voor \fBsource,any,all\fP en identiek aan de | |
142 | standaardsituatie wanneer geen bouwoptie opgegeven werd.. | |
143 | .RE | |
144 | .TP | |
145 | \fB\-g\fP | |
146 | Het equivalent van \fB\-\-build=source,all\fP (sinds dpkg 1.17.11). | |
147 | .TP | |
148 | \fB\-G\fP | |
149 | Het equivalent van \fB\-\-build=source,any\fP (sinds dpkg 1.17.11). | |
150 | .TP | |
151 | \fB\-b\fP | |
152 | Het equivalent van \fB\-\-build=binary\fP of \fB\-\-build=any,all\fP. | |
153 | .TP | |
154 | \fB\-B\fP | |
155 | Het equivalent van \fB\-\-build=any\fP. | |
156 | .TP | |
157 | \fB\-A\fP | |
158 | Het equivalent van \fB\-\-build=all\fP. | |
159 | .TP | |
160 | \fB\-S\fP | |
161 | Het equivalent van \fB\-\-build=source\fP. | |
162 | .TP | |
163 | \fB\-F\fP | |
164 | Het equivalent van \fB\-\-build=full\fP, \fB\-\-build=source,binary\fP of | |
165 | \fB\-\-build=source,any,all\fP (sinds dpkg 1.15.8). | |
166 | .TP | |
167 | \fB\-\-target=\fP\fIdoel\fP[,...] | |
168 | .TQ | |
169 | \fB\-\-target \fP\fIdoel\fP[,...] | |
170 | .TQ | |
171 | \fB\-T\fP, \fB\-\-rules\-target=\fP\fIdoel\fP[,...] | |
172 | Roept na het opzetten van de bouwomgeving per opgegeven doel eenmaal | |
173 | \fBdebian/rules\fP \fIdoel\fP aan en stopt het proces van het bouwen van het | |
174 | pakket hier (sinds dpkg 1.15.0, de lange optie sinds dpkg 1.18.8, de | |
175 | ondersteuning voor meerdere doelen sinds dpkg 1.18.16). Indien ook | |
176 | \fB\-\-as\-root\fP opgegeven werd, dan wordt het commando als systeembeheerder | |
177 | uitgevoerd (zie \fB\-\-root\-command\fP). Merk op dat gekende doelen die verplicht | |
178 | als systeembeheerder moeten uitgevoerd worden, deze optie niet nodig hebben | |
179 | (d.w.z. de doelen \fBclean\fP, \fBbinary\fP, \fBbinary\-arch\fP en \fBbinary\-indep\fP). | |
180 | .TP | |
181 | \fB\-\-as\-root\fP | |
182 | Enkel zinvol in samenhang met \fB\-\-target\fP (sinds dpkg 1.15.0). Vereist dat | |
183 | het doel met systeembeheerdersrechten uitgevoerd wordt. | |
184 | .TP | |
185 | \fB\-si\fP | |
186 | .TQ | |
187 | \fB\-sa\fP | |
188 | .TQ | |
189 | \fB\-sd\fP | |
190 | .TQ | |
191 | \fB\-v\fP\fIversie\fP | |
192 | .TQ | |
193 | \fB\-C\fP\fIbeschrijving\-van\-de\-wijzigingen\fP | |
194 | .TQ | |
195 | \fB\-m\fP, \fB\-\-release\-by=\fP\fIadres\-van\-de\-pakketonderhouder\fP | |
196 | .TQ | |
197 | \fB\-e\fP, \fB\-\-build\-by=\fP\fIadres\-van\-de\-pakketonderhouder\fP | |
198 | Wordt ongewijzigd doorgegeven aan \fBdpkg\-genchanges\fP. Zie de man\-pagina | |
199 | ervan. | |
200 | .TP | |
201 | \fB\-a\fP, \fB\-\-host\-arch\fP \fIarchitectuur\fP | |
202 | Geef de Debian\-architectuur op waarvoor we bouwen (lange optie sinds dpkg | |
203 | 1.17.17). De architectuur van de machine waarop we bouwen, wordt automatisch | |
204 | vastgesteld en ze wordt ook als standaard genomen voor de hostmachine. | |
205 | .TP | |
206 | \fB\-t\fP, \fB\-\-host\-type\fP \fIgnu\-systeemtype\fP | |
207 | Geef het GNU\-systeemtype op waarvoor we bouwen (lange optie sinds dpkg | |
208 | 1.17.17). Het kan gebruikt worden in de plaats van \fB\-\-host\-arch\fP of als een | |
209 | aanvulling om het standaard GNU\-systeemtype voor de Debian\-architectuur van | |
210 | de host aan te passen. | |
211 | .TP | |
212 | \fB\-\-target\-arch\fP \fIarchitectuur\fP | |
213 | Geef de Debian\-architectuur op waarvoor de gebouwde programma's zullen | |
214 | bouwen (sinds dpkg 1.17.17). De standaardwaarde is de hostmachine. | |
215 | .TP | |
216 | \fB\-\-target\-type\fP \fIgnu\-systeemtype\fP | |
217 | Geef het GNU\-systeemtype op waarvoor de gebouwde programma's zullen bouwen | |
218 | (sinds dpkg 1.17.17). Het kan gebruikt worden in de plaats van | |
219 | \fB\-\-target\-arch\fP of als een aanvulling om het standaard GNU\-systeemtype voor | |
220 | de Debian doelarchitectuur aan te passen. | |
221 | .TP | |
222 | \fB\-P\fP, \fB\-\-build\-profiles=\fP\fIprofiel\fP[\fB,\fP...] | |
223 | Geef het/de profiel(en) die we bouwen op in een lijst met een komma als | |
224 | scheidingsteken (sinds dpkg 1.17.2, de lange optie sinds dpkg 1.18.8). Het | |
225 | standaardgedrag is om niet voor een specifiek profiel te bouwen. Stelt ze | |
226 | ook in (als een lijst met een spatie als scheidingsteken) als de | |
227 | omgevingsvariabele \fBDEB_BUILD_PROFILES\fP, hetgeen bijvoorbeeld toelaat aan | |
228 | \fBdebian/rules\fP\-bestanden om gebruik te maken van deze informatie bij | |
229 | voorwaardelijke bouwoperaties. | |
230 | .TP | |
231 | \fB\-j\fP, \fB\-\-jobs\fP[=\fItaken\fP|\fBauto\fP] | |
232 | Aantal taken dat gelijktijdig mag uitgevoerd worden, waarbij het aantal | |
233 | taken overeenkomt met het aantal beschikbare processoren als \fBauto\fP | |
234 | opgegeven werd (sinds dpkg 1.17.10), of onbeperkt is als \fItaken\fP niet | |
235 | opgegeven werd. Dit is het equivalent van de gelijknamige optie voor | |
236 | \fBmake\fP(1) (sinds dpkg 1.14.7, lange optie sinds dpkg 1.18.8). Het voegt | |
237 | zichzelf toe aan de omgevingsvariabele \fBMAKEFLAGS\fP, waardoor elke erop | |
238 | volgende aanroep van make de optie overerft en parallelle taakuitvoering dus | |
239 | opgelegd wordt bij het maken van pakketten (en mogelijks ook oplegt aan het | |
240 | bouwsysteem van de toeleveraar indien dat gebruik maakt van make), ongeacht | |
241 | het feit of er ondersteuning is voor het in parallel bouwen, hetgeen tot | |
242 | mislukkingen bij het bouwen kan leiden. Het voegt ook \fBparallel=\fP\fItaken\fP | |
243 | of \fBparallel\fP toe aan de omgevingsvariabele \fBDEB_BUILD_OPTIONS\fP, hetgeen | |
244 | debian/rules\-bestanden in staat stelt van deze informatie gebruik te maken | |
245 | voor eigen doeleinden. De waarde \fB\-j\fP heeft voorrang op de optie | |
246 | \fBparallel=\fP\fItaken\fP of \fBparallel\fP in de omgevingsvariabele | |
247 | \fBDEB_BUILD_OPTIONS\fP. Merk op dat de waarde \fBauto\fP zal vervangen worden | |
248 | door het effectieve aantal momenteel actieve processoren en ze dus als | |
249 | zodanig naar geen enkel onderliggend proces doorgegeven zal worden. Indien | |
250 | het aantal beschikbare processoren niet afgeleid kan worden, dan zal de code | |
251 | terugvallen op het gebruiken van seriële uitvoering (sinds dpkg 1.18.15), | |
252 | hoewel dit enkel zou mogen gebeuren op exotische en niet\-ondersteunde | |
253 | systemen. | |
254 | .TP | |
255 | \fB\-J\fP, \fB\-\-jobs\-try\fP[=\fItaken\fP|\fBauto\fP] | |
256 | Deze optie (sinds dpkg 1.18.2, de lange optie sinds dpkg 1.18.8) is het | |
257 | equivalent van de optie \fB\-j\fP, behalve dat ze de omgevingsvariabele | |
258 | \fBMAKEFLAGS\fP niet instelt. Als zodanig is het veiliger om ze te gebruiken | |
259 | met elk pakket, ook met die waarvoor het niet zeker is dat in parallel | |
260 | bouwen mogelijk is. | |
261 | ||
262 | \fBauto\fP is het standaardgedrag (sinds dpkg 1.18.11). Het aantal jobs | |
263 | instellen op 1 zal het seriële gedrag opnieuw instellen. | |
264 | .TP | |
265 | \fB\-D\fP, \fB\-\-check\-builddeps\fP | |
266 | Controleer bouwvereisten en tegenstrijdigheden en breek af als er niet aan | |
267 | voldaan is (de lange optie sinds dpkg 1.18.8). Dit is het standaardgedrag. | |
268 | .TP | |
269 | \fB\-d\fP, \fB\-\-no\-check\-builddeps\fP | |
270 | Controleer bouwvereisten en tegenstrijdigheden niet (de lange optie sinds | |
271 | dpkg 1.18.8). | |
272 | .TP | |
273 | \fB\-\-ignore\-builtin\-builddeps\fP | |
274 | Controleer ingebouwde bouwvereisten en tegenstrijdigheden niet (sinds dpkg | |
275 | 1.18.2). Dit zijn de distributiespecifieke impliciete bouwvereisten die | |
276 | gewoonlijk noodzakelijk zijn in een bouwomgeving, de zogenaamde set van | |
277 | pakketten van het type Build\-Essential. | |
278 | .TP | |
279 | \fB\-nc\fP, \fB\-\-no\-pre\-clean\fP | |
280 | Schoon de broncodeboom niet op (de lange optie sinds dpkg | |
281 | 1.18.8). Impliceert \fB\-b\fP indien geen van de opties \fB\-F\fP, \fB\-g\fP, \fB\-G\fP, | |
282 | \fB\-B\fP, \fB\-A\fP of \fB\-S\fP gekozen werd. Gecombineerd met \fB\-S\fP impliceert dit | |
283 | \fB\-d\fP (sinds dpkg 1.18.0). | |
284 | .TP | |
285 | \fB\-\-pre\-clean\fP | |
286 | Schoon voor het bouwen de broncodeboom op (sinds dpkg 1.18.8). | |
287 | .TP | |
288 | \fB\-tc\fP, \fB\-\-post\-clean\fP | |
289 | Schoon de broncodeboom op (met \fIcommando\-om\-root\-te\-worden\fP \fBdebian/rules | |
290 | clean\fP) nadat het pakket gebouwd werd (de lange optie sinds dpkg 1.18.8). | |
291 | .TP | |
292 | \fB\-r\fP, \fB\-\-root\-command=\fP\fIcommando\-om\-root\-te\-worden\fP | |
293 | Wanneer \fBdpkg\-buildpackage\fP een deel van het bouwproces in de hoedanigheid | |
294 | van root (systeembeheerder) moet uitvoeren, laat het het commando dat het | |
295 | uitvoert voorafgaan door \fIcommando\-om\-root\-te\-worden\fP indien er een | |
296 | opgegeven werd (de lange optie sinds dpkg 1.18.8). Anders, als er geen | |
297 | opgegeven werd, wordt standaard \fBfakeroot\fP gebruikt als het beschikbaar | |
298 | is. \fIcommando\-om\-root\-te\-worden\fP moet beginnen met de naam van een | |
299 | programma in het \fBPATH\fP en krijgt als argumenten de naam van het echte | |
300 | commando dat uitgevoerd moet worden en de argumenten die het moet | |
301 | krijgen. \fIcommando\-om\-root\-te\-worden\fP kan parameters bevatten (ze moeten | |
302 | met spaties van elkaar gescheiden worden) maar geen | |
303 | shell\-metatekens. Doorgaans is \fIcommando\-om\-root\-te\-worden\fP \fBfakeroot\fP, | |
304 | \fBsudo\fP, \fBsuper\fP of \fBreally\fP. \fBsu\fP is niet geschikt, aangezien het enkel | |
305 | de shell van de gebruiker kan aanroepen met \fB\-c\fP in plaats van | |
306 | afzonderlijke argumenten door te geven aan het uit te voeren commando. | |
307 | .TP | |
308 | \fB\-R\fP, \fB\-\-rules\-file=\fP\fIrules\-bestand\fP | |
309 | Een Debian\-pakket bouwen houdt meestal het aanroepen van \fBdebian/rules\fP in | |
310 | als een commando met verschillende standaardparameters (sinds dpkg 1.14.17, | |
311 | de lange optie sinds dpkg 1.18.8). Met deze optie is het mogelijk om een | |
312 | andere programma\-aanroep te gebruiken om het pakket te bouwen (ze kan | |
313 | parameters bevatten die onderling door spaties gescheiden | |
314 | worden). Anderzijds kan de optie ook gebruikt worden om het standaard | |
315 | rules\-bestand uit te voeren met een ander make\-programma (bijvoorbeeld door | |
316 | \fB/usr/local/bin/make \-f debian/rules\fP te gebruiken als \fIrules\-bestand\fP). | |
317 | .TP | |
318 | \fB\-\-check\-command=\fP\fIcontrolecommando\fP | |
319 | Commando dat gebruikt wordt om het bestand \fB.changes\fP zelf en eventuele | |
320 | gebouwde artefacten waarnaar in het bestand verwezen wordt, te controleren | |
321 | (sinds dpkg 1.17.6). Het commando moet als argument de padnaam van | |
322 | \&\fB.changes\fP krijgen. Gewoonlijk is dit commando \fBlintian\fP. | |
323 | .TP | |
324 | \fB\-\-check\-option=\fP\fIoptie\fP | |
325 | Geef optie \fIoptie\fP door aan het \fIcontrolecommando\fP dat gespecificeerd werd | |
326 | met \fBDEB_CHECK_COMMAND\fP of met \fB\-\-check\-command\fP (sinds dpkg 1.17.6). Kan | |
327 | meermaals gebruikt worden. | |
328 | .TP | |
329 | \fB\-\-hook\-\fP\fIhook\-naam\fP\fB=\fP\fIhook\-commando\fP | |
330 | Stelt de opgegeven shell\-code \fIhook\-commando\fP in als de uitbreiding (hook) | |
331 | \fIhook\-naam\fP, die zal uitgevoerd worden op de momenten die in de | |
332 | uitvoeringsstappen gepreciseerd worden (sinds dpkg 1.17.6). De uitbreidingen | |
333 | (hooks) zullen steeds uitgevoerd worden, zelfs als de volgende actie niet | |
334 | uitgevoerd wordt (met uitzondering voor de uitbreiding (hook) | |
335 | \fBbinary\fP). Alle uitbreidingen (hooks) zullen uitgevoerd worden in de map | |
336 | van de uitgepakte broncode. | |
337 | ||
338 | Opmerking: uitbreidingen (hooks) kunnen het bouwproces beïnvloeden en leiden | |
339 | tot het mislukken van de bouw als hun commando's falen. Wees dus alert voor | |
340 | onbedoelde consequenties. | |
341 | ||
342 | Momenteel worden de volgende \fIhook\-namen\fP ondersteund | |
343 | ||
344 | \fBinit preclean source build binary buildinfo changes postclean check sign | |
345 | done\fP | |
346 | ||
347 | Het \fIhook\-commando\fP ondersteunt de volgende | |
348 | substitutie\-indelingstekenreeksen, die er voorafgaand aan de uitvoering op | |
349 | toegepast zullen worden: | |
350 | ||
351 | .RS | |
352 | .TP | |
353 | \fB%%\fP | |
354 | Eén enkel %\-teken. | |
355 | .TP | |
356 | \fB%a\fP | |
357 | Een booleaanse waarde (0 of 1), die aangeeft of de volgende actie uitgevoerd | |
358 | wordt of niet. | |
359 | .TP | |
360 | \fB%p\fP | |
361 | De naam van het broncodepakket. | |
362 | .TP | |
363 | \fB%v\fP | |
364 | De versie van het broncodepakket. | |
365 | .TP | |
366 | \fB%s\fP | |
367 | De versie van het broncodepakket (zonder de epoch). | |
368 | .TP | |
369 | \fB%u\fP | |
370 | Het upstream versienummer (toeleveraarsversie). | |
371 | .RE | |
372 | .TP | |
373 | \fB\-\-buildinfo\-option=\fP\fIoptie\fP | |
374 | Geef optie \fIoptie\fP door aan \fBdpkg\-genbuildinfo\fP (sinds dpkg 1.18.11). Kan | |
375 | meermaals gebruikt worden. | |
376 | .TP | |
377 | \fB\-p\fP, \fB\-\-sign\-command=\fP\fIondertekeningscommando\fP | |
378 | Als \fBdpkg\-buildpackage\fP GPG moet uitvoeren om een controlebestand (\fB.dsc\fP) | |
379 | van de broncode of een bestand \fB.changes\fP te ondertekenen zal het | |
380 | \fIondertekeningscommando\fP (en indien nodig daarbij het \fBPATH\fP doorzoeken) | |
381 | uitvoeren in plaats van \fBgpg2\fP of \fBgpg\fP (de lange optie sinds dpkg | |
382 | 1.18.8). Aan \fIondertekeningscommando\fP zullen alle argumenten meegegeven | |
383 | worden die anders aan \fBgpg2\fP of \fBgpg\fP gegeven zouden | |
384 | zijn. \fIondertekeningscommando\fP mag geen spaties bevatten en geen andere | |
385 | shell\-metatekens. | |
386 | .TP | |
387 | \fB\-k\fP, \fB\-\-sign\-key=\fP\fIsleutel\-id\fP | |
388 | Geef de sleutel\-ID op die gebruikt moet worden om pakketten te ondertekenen | |
389 | (de lange optie sinds dpkg 1.18.8). | |
390 | .TP | |
391 | \fB\-us\fP, \fB\-\-unsigned\-source\fP | |
392 | Onderteken het broncodepakket niet (de lange optie sinds dpkg 1.18.8). | |
393 | .TP | |
394 | \fB\-ui\fP, \fB\-\-unsigned\-buildinfo\fP | |
395 | Onderteken het bestand \fB.buildinfo\fP niet (sinds dpkg 1.18.19). | |
396 | .TP | |
397 | \fB\-uc\fP, \fB\-\-unsigned\-changes\fP | |
398 | Onderteken de bestanden \fB.buildinfo\fP en \fB.changes\fP niet (de lange optie | |
399 | sinds dpkg 1.18.8). | |
400 | .TP | |
401 | \fB\-\-no\-sign\fP | |
402 | Onderteken geen enkel bestand; dit omvat het broncodepakket, het bestand | |
403 | \&\fB.buildinfo\fP en het bestand \fB.changes\fP (sinds dpkg 1.18.20). | |
404 | .TP | |
405 | \fB\-\-force\-sign\fP | |
406 | Verplicht het ondertekenen van de resulterende bestanden (sinds dpkg | |
407 | 1.17.0), ongeacht \fB\-us\fP, \fB\-\-unsigned\-source\fP, \fB\-ui\fP, | |
408 | \fB\-\-unsigned\-buildinfo\fP, \fB\-uc\fP, \fB\-\-unsigned\-changes\fP of overige interne | |
409 | heuristiek. | |
410 | .TP | |
411 | \fB\-sn\fP | |
412 | .TQ | |
413 | \fB\-ss\fP | |
414 | .TQ | |
415 | \fB\-sA\fP | |
416 | .TQ | |
417 | \fB\-sk\fP | |
418 | .TQ | |
419 | \fB\-su\fP | |
420 | .TQ | |
421 | \fB\-sr\fP | |
422 | .TQ | |
423 | \fB\-sK\fP | |
424 | .TQ | |
425 | \fB\-sU\fP | |
426 | .TQ | |
427 | \fB\-sR\fP | |
428 | .TQ | |
429 | \fB\-i\fP, \fB\-\-diff\-ignore\fP[=\fIregex\fP] | |
430 | .TQ | |
431 | \fB\-I\fP, \fB\-\-tar\-ignore\fP[=\fIpatroon\fP] | |
432 | .TQ | |
433 | \fB\-z\fP, \fB\-\-compression\-level=\fP\fIniveau\fP | |
434 | .TQ | |
435 | \fB\-Z\fP, \fB\-\-compression=\fP\fIcompressor\fP | |
436 | Wordt ongewijzigd doorgegeven aan \fBdpkg\-source\fP. Zie de man\-pagina ervan. | |
437 | .TP | |
438 | \fB\-\-source\-option=\fP\fIoptie\fP | |
439 | Geef optie \fIoptie\fP door aan \fBdpkg\-source\fP (sinds dpkg 1.15.6). Kan | |
440 | meermaals gebruikt worden. | |
441 | .TP | |
442 | \fB\-\-changes\-option=\fP\fIoptie\fP | |
443 | Geef optie \fIoptie\fP door aan \fBdpkg\-genchanges\fP (sinds dpkg 1.15.6). Kan | |
444 | meermaals gebruikt worden. | |
445 | .TP | |
446 | \fB\-\-admindir=\fP\fImap\fP | |
447 | .TQ | |
448 | \fB\-\-admindir \fP\fImap\fP | |
449 | Geef een andere locatie op voor de database van \fBdpkg\fP (sinds dpkg | |
450 | 1.14.0). De standaardlocatie is \fI%ADMINDIR%\fP. | |
451 | .TP | |
452 | \fB\-?\fP, \fB\-\-help\fP | |
453 | Toon info over het gebruik en sluit af. | |
454 | .TP | |
455 | \fB\-\-version\fP | |
456 | Toon de versie en sluit af. | |
457 | . | |
458 | .SH OMGEVING | |
459 | .SS "Externe omgeving" | |
460 | .TP | |
461 | \fBDEB_CHECK_COMMAND\fP | |
462 | Indien dit ingesteld werd, zal het gebruikt worden als het commando waarmee | |
463 | het bestand \fB.changes\fP gecontroleerd wordt (sinds dpkg 1.17.6). De optie | |
464 | \fB\-\-check\-command\fP heeft hierop voorrang. | |
465 | .TP | |
466 | \fBDEB_SIGN_KEYID\fP | |
467 | Indien dit ingesteld werd, zal het gebruikt worden om de bestanden | |
468 | \&\fB.changes\fP en \fB.dsc\fP te ondertekenen (sinds dpkg 1.17.2). De optie | |
469 | \fB\-\-sign\-key\fP heeft hierop voorrang. | |
470 | .TP | |
471 | \fBDEB_BUILD_OPTIONS\fP | |
472 | Indien dit ingesteld werd, bevat het een lijst van door spaties van elkaar | |
473 | gescheiden opties die het bouwproces kunnen beïnvloeden in \fIdebian/rules\fP | |
474 | en het gedrag van sommige dpkg\-commando's. | |
475 | ||
476 | Bij \fBnocheck\fP zal de variabele \fBDEB_CHECK_COMMAND\fP genegeerd worden. Bij | |
477 | \fBparallel=\fP\fIN\fP zal het aantal parallelle taken op \fIN\fP ingesteld worden, | |
478 | maar de optie \fB\-\-jobs\-try\fP heeft hierop voorrang. | |
479 | .TP | |
480 | \fBDEB_BUILD_PROFILES\fP | |
481 | Indien dit ingesteld werd, zal het gebruikt worden als het/de actieve | |
482 | bouwprofiel(en) voor het pakket dat gebouw wordt (sinds dpkg 1.17.2). Het is | |
483 | een lijst van profielnamen die onderling door een spatie gescheiden zijn. De | |
484 | optie \fB\-P\fP heeft hierop voorrang. | |
485 | .TP | |
486 | \fBDPKG_COLORS\fP | |
487 | Stelt de kleurmodus in (sinds dpkg 1.18.5). Waarden die momenteel gebruikt | |
488 | mogen worden zijn: \fBauto\fP (standaard), \fBalways\fP en \fBnever\fP. | |
489 | ||
490 | .SS "Interne omgeving" | |
491 | Zelfs al exporteert \fBdpkg\-buildpackage\fP sommige variabelen, toch mag | |
492 | \fBdebian/rules\fP er niet op rekenen dat ze aanwezig zijn en moet het in de | |
493 | plaats daarvan gebruik maken van de desbetreffende interface om de benodigde | |
494 | variabelen op te halen, aangezien dat bestand.het belangrijkste | |
495 | aanspreekpunt is voor het bouwen van pakketten en de op zichzelf staande | |
496 | uitvoering ervan ondersteund moet zijn. | |
497 | ||
498 | .TP | |
499 | \fBDEB_BUILD_*\fP | |
500 | .TQ | |
501 | \fBDEB_HOST_*\fP | |
502 | .TQ | |
503 | \fBDEB_TARGET_*\fP | |
504 | \fBdpkg\-architecture\fP wordt aangeroepen met de doorgegeven parameters \fB\-a\fP | |
505 | en \fB\-t\fP. Eventuele variabelen die zijn optie \fB\-s\fP als uitvoer geeft, | |
506 | worden in de bouwomgeving geïntegreerd. | |
507 | ||
508 | .TP | |
509 | \fBSOURCE_DATE_EPOCH\fP | |
510 | Deze variabele wordt ingesteld op de Unix\-tijd (timestamp) sinds het | |
511 | tijdstip (de epoch) van het laatste item in \fIdebian/changelog\fP, voor zover | |
512 | hij niet reeds gedefinieerd is. | |
513 | . | |
514 | .SH BESTANDEN | |
515 | .TP | |
516 | \fI%PKGCONFDIR%/buildpackage.conf\fP | |
517 | Configuratiebestand dat voor het hele systeem geldt | |
518 | .TP | |
519 | \fI$XDG_CONFIG_HOME/dpkg/buildpackage.conf\fP of | |
520 | .TQ | |
521 | \fI$HOME/.config/dpkg/buildpackage.conf\fP | |
522 | Configuratiebestand dat gebruikersafhankelijk is. | |
523 | . | |
524 | .SH OPMERKINGEN | |
525 | .SS "Compileervlaggen worden niet langer geëxporteerd" | |
526 | Tussen dpkg 1.14.17 en 1.16.1 exporteerde \fBdpkg\-buildpackage\fP | |
527 | compileervlaggen (\fBCFLAGS\fP, \fBCXXFLAGS\fP, \fBFFLAGS\fP, \fBCPPFLAGS\fP en | |
528 | \fBLDFLAGS\fP) met de waarden die door \fBdpkg\-buildflags\fP teruggegeven | |
529 | werden. Dit is niet langer het geval | |
530 | .SS "Standaard bouwdoelen" | |
531 | \fBdpkg\-buildpackage\fP gebruikt sinds dpkg 1.16.2 de doelen \fBbuild\-arch\fP en | |
532 | \fBbuild\-indep\fP. Deze doelen zijn dus verplicht. Maar om te vermijden dat | |
533 | bestaande pakketten defect raken en om de overgang te vergemakkelijken, zal | |
534 | het, indien het broncodepakket niet zowel architectuuronafhankelijke als | |
535 | architectuurspecifieke binaire pakketten bouwt (sinds dpkg 1.18.8), | |
536 | terugvallen op het gebruik van het doel \fBbuild\fP indien \fBmake \-f | |
537 | debian/rules \-qn\fP \fIbouwdoel\fP 2 teruggeeft als afsluitwaarde. | |
538 | .SH BUGS | |
539 | Het zou mogelijk moeten zijn om spaties en shell\-metatekens en initiële | |
540 | argumenten op te geven voor \fIcommando\-om\-root\-te\-worden\fP en | |
541 | \fIondertekeningscommando\fP. | |
542 | . | |
543 | .SH "ZIE OOK" | |
544 | .ad l | |
545 | \fBdpkg\-source\fP(1), \fBdpkg\-architecture\fP(1), \fBdpkg\-buildflags\fP(1), | |
546 | \fBdpkg\-genbuildinfo\fP(1), \fBdpkg\-genchanges\fP(1), \fBfakeroot\fP(1), | |
547 | \fBlintian\fP(1), \fBgpg2\fP(1), \fBgpg\fP(1). |