chiark / gitweb /
awful debugging hacking
[dpkg] / man / nl / dpkg-deb.man
1 .\" dpkg manual page - dpkg-deb(1)
2 .\"
3 .\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk>
4 .\" Copyright © 1999 Wichert Akkerman <wakkerma@debian.org>
5 .\" Copyright © 2006 Frank Lichtenheld <djpig@debian.org>
6 .\" Copyright © 2007-2015 Guillem Jover <guillem@debian.org>
7 .\"
8 .\" This is free software; you can redistribute it and/or modify
9 .\" it under the terms of the GNU General Public License as published by
10 .\" the Free Software Foundation; either version 2 of the License, or
11 .\" (at your option) any later version.
12 .\"
13 .\" This is distributed in the hope that it will be useful,
14 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
15 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 .\" GNU General Public License for more details.
17 .\"
18 .\" You should have received a copy of the GNU General Public License
19 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
20 .
21 .\"*******************************************************************
22 .\"
23 .\" This file was generated with po4a. Translate the source file.
24 .\"
25 .\"*******************************************************************
26 .TH dpkg\-deb 1 %RELEASE_DATE% %VERSION% dpkg\-suite
27 .nh
28 .SH NAAM
29 dpkg\-deb \- gereedschap voor het behandelen van een Debian pakketarchief
30 (.deb)
31 .
32 .SH OVERZICHT
33 \fBdpkg\-deb\fP [\fIoptie\fP...] \fIcommando\fP
34 .
35 .SH BESCHRIJVING
36 \fBdpkg\-deb\fP pakt Debian\-archieven in/uit en geeft er informatie over.
37 .PP
38 Gebruik \fBdpkg\fP om pakketten te installeren op uw systeem of ze ervan te
39 verwijderen.
40 .PP
41 U kunt \fBdpkg\-deb\fP ook inroepen door \fBdpkg\fP aan te roepen met alle opties
42 die u aan \fBdpkg\-deb\fP wilt doorgeven. \fBdpkg\fP zal merken dat u \fBdpkg\-deb\fP
43 wilde en het voor u uitvoeren.
44 .PP
45 De meeste commando's die als argument een invoerarchief verwachten, kunnen
46 dit archief lezen van de standaardinvoer indien als archiefnaam één enkel
47 min\-teken («\fB\-\fP») opgegeven wordt. In het andere geval zal het ontbreken
48 van ondersteuning hiervoor gedocumenteerd worden in de beschrijving van het
49 desbetreffende commando.
50 .
51 .SH COMMANDO'S
52 .TP 
53 \fB\-b\fP, \fB\-\-build\fP \fImap\-binair\-pakket\fP [\fIarchief\fP|\fImap\fP]
54 Maakt een debian\-archief van de bestandssysteemboom die in
55 \fImap\-binair\-pakket\fP staat. \fImap\-binair\-pakket\fP moet een onderliggende map
56 \fBDEBIAN\fP hebben waarin de bestanden met controle\-informatie opgeslagen
57 zijn, zoals het bestand control zelf. Deze map zal \fIniet\fP voorkomen in het
58 bestandssysteemarchief van het binaire pakket, maar in de plaats daarvan
59 zullen de bestanden daaruit in het conrole\-informatiegebied van het binaire
60 pakket geplaatst worden.
61
62 Tenzij u \fB\-\-nocheck\fP opgeeft, zal \fBdpkg\-deb\fP \fBDEBIAN/control\fP lezen en
63 het ontleden. Het zal het bestand controleren op syntaxisfouten en op andere
64 problemen en de naam tonen van het binaire pakket dat gebouwd
65 wordt. \fBdpkg\-deb\fP zal ook de toegangsrechten van de scripts van de
66 onderhouder nazien en van andere bestanden die te vinden zijn in de map
67 \fBDEBIAN\fP met controle\-informatie.
68
69 Indien geen \fIarchief\fP opgegeven werd, zal \fBdpkg\-deb\fP het pakket
70 wegschrijven in het bestand \fImap\-binair\-pakket\fP\fB.deb\fP.
71
72 Indien het te maken archief reeds bestaat, zal het overschreven worden.
73
74 Indien het tweede argument een map is, zal \fBdpkg\-deb\fP schrijven in het
75 bestand \fImap\fP\fB/\fP\fIpakket\fP\fB_\fP\fIversie\fP\fB_\fP\fIarch\fP\fB.deb\fP. Indien een
76 doelmap opgegeven werd, eerder dan een bestand, kan de optie \fB\-\-nocheck\fP
77 niet gebruikt worden (aangezien \fBdpkg\-deb\fP het control\-bestand van het
78 pakket moet lezen en ontleden om te kunnen uitmaken welke bestandsnaam
79 gebruikt moet worden).
80 .TP 
81 \fB\-I\fP, \fB\-\-info\fP \fIarchief\fP [\fInaam\-controlebestand\fP...]
82 Geeft informatie over een binair pakketarchief
83
84 Indien geen \fInaam\-controlebestand\fP(en) opgegeven werd(en) zal het een
85 samenvatting weergeven van de inhoud van het pakket en van zijn bestand
86 control.
87
88 Indien wel (een) \fInaam\-controlebestand\fP(en) opgegeven werd(en), zal
89 \fBdpkg\-deb\fP ze in de opgegeven volgorde weergeven. Indien er een of meerdere
90 componenten ontbraken, zal het een foutmelding weergeven op de standaard
91 foutuitvoer over elk van hen en afsluiten met de status 2.
92 .TP 
93 \fB\-W\fP, \fB\-\-show\fP \fIarchief\fP
94 Verschaft informatie over een binair pakketarchief in de indeling die
95 opgegeven werd met het argument \fB\-\-showformat\fP. De standaardindeling toont
96 de naam van het pakket en de versie op één regel, gescheiden door een tab.
97 .TP 
98 \fB\-f\fP, \fB\-\-field\fP \fIarchief\fP [\fIcontroleveldnaam\fP...]
99 Extraheert informatie uit het bestand control van een binair pakketarchief.
100
101 Indien er geen \fIcontroleveldna(a)m\fP(en) opgegeven werd(en) zal het het
102 volledige bestand control tonen.
103
104 Indien er wel opgegeven werden, zal \fBdpkg\-deb\fP hun inhoud weergeven in de
105 volgorde waarin zij in het bestand control voorkomen. Indien meer dan één
106 \fIcontroleveldnaam\fP opgegeven werd, zal \fBdpkg\-deb\fP telkens eerst de
107 veldnaam (en een dubbele punt en een spatie) plaatsen voor de inhoud van het
108 veld.
109
110 Er worden geen foutmeldingen gegeven voor aangevraagde velden die niet
111 gevonden werden.
112 .TP 
113 \fB\-c\fP, \fB\-\-contents\fP \fIarchief\fP
114 Geeft de inhoud weer van het archiefonderdeel van het pakketarchief dat de
115 bestandssysteemboom bevat. Hij wordt momenteel weergegeven volgens de manier
116 waarop \fBtar\fP een breedsprakige lijst genereert.
117 .TP 
118 \fB\-x\fP, \fB\-\-extract\fP \fIarchief map\fP
119 Extraheert de boom met het bestandssysteem uit een pakketarchief en plaatst
120 die in de opgegeven map.
121
122 Merk op dat een pakket naar de hoofdmap extraheren \fIniet\fP in een correcte
123 installatie resulteert! Maak gebruik van \fBdpkg\fP om pakketten te
124 installeren.
125
126 \fImap\fP (maar niet de bovenliggende mappen) zal indien nodig aangemaakt
127 worden en de toegangsrechten ervan zullen aangepast worden om overeen te
128 komen met de inhoud van het pakket.
129 .TP 
130 \fB\-X\fP, \fB\-\-vextract\fP \fIarchief map\fP
131 Is zoals \fB\-\-extract\fP (\fB\-x\fP) met \fB\-\-verbose\fP (\fB\-v\fP), hetgeen een lijst
132 van de geëxtraheerde bestanden toont terwijl de opdracht uitgevoerd wordt.
133 .TP 
134 \fB\-R\fP, \fB\-\-raw\-extract\fP \fIarchief map\fP
135 Extraheert de boom met het bestandssysteem uit een pakketarchief en plaatst
136 die in de opgegeven map en de bestanden met de controle\-informatie in een
137 daaronder liggende map \fBDEBIAN\fP (sinds dpkg 1.16.1).
138
139 Indien nodig zal de doelmap (maar niet de erboven liggende mappen)
140 aangemaakt worden.
141
142 Het invoerarchief wordt (momenteel) niet sequentieel verwerkt, waardoor het
143 van standaardinvoer («\fB\-\fP») lezen ervan \fBniet\fP ondersteund wordt.
144 .TP 
145 \fB\-\-ctrl\-tarfile\fP \fIarchief\fP
146 Extraheert de controlegegevens uit een binair pakket en stuurt ze naar de
147 standaarduitvoer in \fBtar\fP\-indeling (sinds dpkg 1.17.14). Samen met
148 \fBtar\fP(1) kan dit gebruikt worden om een specifiek controlebestand uit een
149 pakketarchief te extraheren. Het invoerarchief wordt steeds sequentieel
150 verwerkt.
151 .TP 
152 \fB\-\-fsys\-tarfile\fP \fIarchief\fP
153 Extraheert de gegevens van de bestandssysteemboom uit een binair pakket en
154 stuurt ze naar de standaarduitvoer in \fBtar\fP\-indeling. Samen met \fBtar\fP(1)
155 kan dit gebruikt worden om een specifiek bestand uit een pakketarchief te
156 extraheren. Het invoerarchief wordt steeds sequentieel verwerkt.
157 .TP 
158 \fB\-e\fP, \fB\-\-control\fP \fIarchief\fP [\fImap\fP]
159 Extraheert de bestanden met controle\-informatie uit een pakketarchief en
160 plaatst ze in de opgegeven map.
161
162 Indien geen map opgegeven werd, wordt een onder de huidige map liggende map
163 \fBDEBIAN\fP gebruikt.
164
165 Indien nodig zal de doelmap (maar niet de erboven liggende mappen)
166 aangemaakt worden.
167 .TP 
168 \fB\-?\fP, \fB\-\-help\fP
169 Toon info over het gebruik en sluit af.
170 .TP 
171 \fB\-\-version\fP
172 Toon de versie en sluit af.
173 .
174 .SH OPTIES
175 .TP 
176 \fB\-\-showformat=\fP\fIindeling\fP
177 Deze optie wordt gebruikt om op te geven in welke indeling \fB\-\-show\fP zijn
178 uitvoer moet produceren. De indeling is een tekenreeks die vorm geeft aan de
179 uitvoer die voor elk opgesomd pakket gegenereerd wordt.
180
181 De tekenreeks mag in de vorm “${\fIveldnaam\fP}” verwijzen naar elk
182 statusveld. Een lijst van geldige velden kan gemakkelijk bekomen worden door
183 voor hetzelfde pakket \fB\-I\fP te gebruiken. Een volledige uitleg over de
184 indelingsmogelijkheden (met inbegrip van stuurcodes en het bepalen van de
185 tussenruimte tussen velden) kan men vinden in de toelichting bij de optie
186 \fB\-\-showformat\fP van \fBdpkg\-query\fP(1).
187
188 De standaard voor dit veld is “${Package}\et${Version}\en”.
189 .TP 
190 \fB\-z\fP\fIcompressieniveau\fP
191 Geef op welk compressieniveau gebruikt moet worden door het
192 compressieprogramma bij het bouwen van het pakket (standaard is dat 9 voor
193 gzip, 6 voor xz). Bruikbare waarden zijn 0\-9, waarbij 0 vertaald wordt als
194 geen compressie voor gzip. Voor dpkg 1.16.2 was niveau 0 het equivalent van
195 geen compressie voor alle compressieprogramma's.
196 .TP 
197 \fB\-S\fP\fIcompressiestrategie\fP
198 Geef op welke compressiestrategie gebruikt moet worden door het
199 compressieprogramma bij het bouwen van een pakket (sinds dpkg
200 1.16.2). Toegestane waarden zijn \fBnone\fP (sinds dpkg 1.16.4), \fBfiltered\fP,
201 \fBhuffman\fP, \fBrle\fP en \fBfixed\fP voor gzip (sinds dpkg 1.17.0) en \fBextreme\fP
202 voor xz.
203 .TP 
204 \fB\-Z\fP\fIcompressietype\fP
205 Geef op welk compressietype bij het bouwen van een pakket gebruikt moet
206 worden. Toegestane waarden zijn \fBgzip\fP, \fBxz\fP (sinds dpkg 1.15.6) en
207 \fBnone\fP (standaard is \fBxz\fP).
208 .TP 
209 \fB\-\-uniform\-compression\fP
210 Geef aan dat dezelfde compressieparameters gebruikt moeten worden voor alle
211 archiefonderdelen (d.w.z. \fBcontrol.tar\fP en \fBdata.tar\fP; sinds dpkg
212 1.17.6). Anders zullen die parameters enkel voor het onderdeel \fBdata.tar\fP
213 gebruikt worden. De enige compressietypes waarvan het eenvormig gebruik
214 toegelaten is, zijn \fBnone\fP, \fBgzip\fP en \fBxz\fP.
215 .TP 
216 \fB\-\-deb\-format=\fP\fIindeling\fP
217 Stel in welke versie van archiefindeling bij het bouwen gebruikt moet worden
218 (sinds dpkg 1.17.0). Toegestane waarden zijn \fB2.0\fP voor de nieuwe indeling
219 en \fB0.939000\fP voor de oude (standaard is \fB2.0\fP).
220
221 De oude archiefindeling wordt door niet\-Debian gereedschap minder
222 gemakkelijk ontleed en wordt nu als verouderd beschouwd. Het enige nut ervan
223 is nog als pakketten gebouwd worden die moeten ontleed worden door versies
224 van dpkg die ouder zijn dan versie 0.93.76 (september 1995), die enkel
225 uitgegeven werd als een i386 a.out.
226 .TP 
227 \fB\-\-nocheck\fP
228 Dit onderdrukt de gebruikelijke controles die door \fBdpkg\-deb \-\-build\fP
229 uitgevoerd worden op de voorgestelde inhoud van een archief. Op die manier
230 kunt u gelijk welk archief bouwen, hoe onklaar het ook is.
231 .TP 
232 \fB\-v\fP, \fB\-\-verbose\fP
233 Activeert breedsprakige uitvoer (sinds dpkg 1.16.1). Momenteel heeft dit
234 enkel invloed op \fB\-\-extract\fP dat zich erdoor gaat gedragen als
235 \fB\-\-vextract\fP.
236 .TP 
237 \fB\-D\fP, \fB\-\-debug\fP
238 Activeert debug\-uitvoer. Dit is weinig interessant.
239 .
240 .SH AFSLUITSTATUS
241 .TP 
242 \fB0\fP
243 De gevraagde actie werd succesvol uitgevoerd.
244 .TP 
245 \fB2\fP
246 Fatale of onherstelbare fout die te wijten is aan ongeldig gebruik van de
247 commandoregel of aan interacties met het systeem, zoals het benaderen van de
248 database, het toewijzen van geheugen, enz.
249 .
250 .SH OMGEVING
251 .TP 
252 \fBTMPDIR\fP
253 Indien dit ingesteld werd, zal \fBdpkg\-deb\fP het gebruiken als de map waarin
254 tijdelijke bestanden en mappen aangemaakt worden.
255 .TP 
256 \fBSOURCE_DATE_EPOCH\fP
257 Indien dit ingesteld werd, zal het gebruikt worden als de tijdsaanduiding
258 (timestamp) (in seconden sinds de epoch) in de \fBar\fP(5)\-container van het
259 \fBdeb\fP(5)\-bestand en zal het ook gebruikt worden om de mtime vast te zetten
260 op de items uit het \fBtar\fP(5)\-bestand.
261 .
262 .SH OPMERKINGEN
263 Tracht met enkel maar \fBdpkg\-deb\fP geen software te installeren! U moet zoals
264 het hoort \fBdpkg\fP gebruiken om er zeker van te zijn dat alle bestanden op de
265 juiste plaats terechtkomen, dat de scripts van het pakket uitgevoerd worden
266 en dat zijn toestand en inhoud bijgehouden worden.
267 .
268 .SH BUGS
269 \fBdpkg\-deb \-I\fP \fIpakket1\fP\fB.deb\fP \fIpakket2\fP\fB.deb\fP doet de dingen fout.
270
271 Er gebeurt geen authenticatie van de \fB.deb\fP\-bestanden. Er gebeurt inderdaad
272 zelfs geen simpele toets van de controlesom. (Hoogwaardig gereedschap, zoals
273 APT, ondersteunt het authenticeren van pakketten die van een opgegeven
274 pakketbron opgehaald werden. En tegenwoordig hebben de meeste pakketten een
275 md5sum\-controlebestand dat door debian/rules gegenereerd werd. Dit wordt
276 echter niet rechtstreeks ondersteund door basaal gereedschap.)
277 .
278 .SH "ZIE OOK"
279 \fBdeb\fP(5), \fBdeb\-control\fP(5), \fBdpkg\fP(1), \fBdselect\fP(1).