summaryrefslogtreecommitdiffstats
path: root/man/nl/dpkg-deb.pod
blob: dd52e7148cc022a46562eef113a8fca8c6672c0d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NAAM

dpkg-deb - gereedschap voor het behandelen van een Debian pakketarchief (.deb)

=head1 OVERZICHT

B<dpkg-deb> [I<optie>...] I<commando>

=head1 BESCHRIJVING

B<dpkg-deb> pakt Debian-archieven in/uit en geeft er informatie over.

Gebruik B<dpkg> om pakketten te installeren op uw systeem of ze ervan te verwijderen.

U kunt B<dpkg-deb> ook inroepen door B<dpkg> aan te roepen met alle opties die u aan B<dpkg-deb> wilt doorgeven. B<dpkg> zal merken dat u B<dpkg-deb> wilde en het voor u uitvoeren.

De meeste commando's die als argument een invoerarchief verwachten, kunnen dit archief lezen van de standaardinvoer indien als archiefnaam één enkel min-teken («B<->») opgegeven wordt. In het andere geval zal het ontbreken van ondersteuning hiervoor gedocumenteerd worden in de beschrijving van het desbetreffende commando.

=head1 COMMANDO'S

=over 

=item B<-b>, B<--build> I<map-binair-pakket> [I<archief>|I<map>]

Maakt een debian-archief van de bestandssysteemboom die in I<map-binair-pakket> staat. I<map-binair-pakket> moet een onderliggende map B<DEBIAN> hebben waarin de bestanden met controle-informatie opgeslagen zijn, zoals het bestand control zelf. Deze map zal I<niet> voorkomen in het bestandssysteemarchief van het binaire pakket, maar in de plaats daarvan zullen de bestanden daaruit in het conrole-informatiegebied van het binaire pakket geplaatst worden.

Tenzij u B<--nocheck> opgeeft, zal B<dpkg-deb> B<DEBIAN/control> lezen en het ontleden. Het zal het bestand controleren op syntaxisfouten en op andere problemen en de naam tonen van het binaire pakket dat gebouwd wordt. B<dpkg-deb> zal ook de toegangsrechten van de scripts van de beheerder nazien en van andere bestanden die te vinden zijn in de map B<DEBIAN> met controle-informatie.

Indien geen I<archief> opgegeven werd, zal B<dpkg-deb> het pakket wegschrijven in het bestand I<map-binair-pakket>B<.deb>.

Indien het te maken archief reeds bestaat, zal het overschreven worden.

Indien het tweede argument een map is, zal B<dpkg-deb> schrijven in het bestand I<map>B</>I<pakket>B<_>I<versie>B<_>I<arch>B<.deb>. Indien een doelmap opgegeven werd, eerder dan een bestand, kan de optie B<--nocheck> niet gebruikt worden (aangezien B<dpkg-deb> het control-bestand van het pakket moet lezen en ontleden om te kunnen uitmaken welke bestandsnaam gebruikt moet worden).

=item B<-I>, B<--info> I<archief> [I<naam-controlebestand>...]

Geeft informatie over een binair pakketarchief.

Indien geen I<naam-controlebestand>(en) opgegeven werd(en) zal het een samenvatting weergeven van de inhoud van het pakket en van zijn bestand control.

Indien wel (een) I<naam-controlebestand>(en) opgegeven werd(en), zal B<dpkg-deb> ze in de opgegeven volgorde weergeven. Indien er een of meerdere componenten ontbraken, zal het een foutmelding weergeven op de standaard foutuitvoer over elk van hen en afsluiten met de status 2.

=item B<-W>, B<--show> I<archief>

Verschaft informatie over een binair pakketarchief in de indeling die opgegeven werd met het argument B<--showformat>. De standaardindeling toont de naam van het pakket en de versie op één regel, gescheiden door een tab.

=item B<-f>, B<--field> I<archief> [I<controleveldnaam>...]

Extraheert informatie uit het bestand control van een binair pakketarchief.

Indien er geen I<controleveldna(a)m>(en) opgegeven werd(en) zal het het volledige bestand control tonen.

Indien er wel opgegeven werden, zal B<dpkg-deb> hun inhoud weergeven in de volgorde waarin zij in het bestand control voorkomen. Indien meer dan één I<controleveldnaam> opgegeven werd, zal B<dpkg-deb> telkens eerst de veldnaam (en een dubbele punt en een spatie) plaatsen voor de inhoud van het veld.

Er worden geen foutmeldingen gegeven voor aangevraagde velden die niet gevonden werden.

=item B<-c>, B<--contents> I<archief>

Geeft de inhoud weer van het archiefonderdeel van het pakketarchief dat de bestandssysteemboom bevat. Hij wordt momenteel weergegeven volgens de manier waarop B<tar> een breedsprakige lijst genereert.

=item B<-x>, B<--extract> I<archief> I<map>

Extraheert de boom met het bestandssysteem uit een pakketarchief en plaatst die in de opgegeven map.

Merk op dat een pakket naar de hoofdmap extraheren I<niet> in een correcte installatie resulteert! Maak gebruik van B<dpkg> om pakketten te installeren.

I<map> (maar niet de bovenliggende mappen) zal indien nodig aangemaakt worden en de toegangsrechten ervan zullen aangepast worden om overeen te komen met de inhoud van het pakket.

=item B<-X>, B<--vextract> I<archief> I<map>

Is zoals B<--extract> (B<-x>) met B<--verbose> (B<-v>), hetgeen een lijst van de geëxtraheerde bestanden toont terwijl de opdracht uitgevoerd wordt.

=item B<-R>, B<--raw-extract> I<archief> I<map>

Extraheert de boom met het bestandssysteem uit een pakketarchief en plaatst die in de opgegeven map en de bestanden met de controle-informatie in een daaronder liggende map B<DEBIAN> (sinds dpkg 1.16.1).

Indien nodig zal de doelmap (maar niet de erboven liggende mappen) aangemaakt worden.

Het invoerarchief wordt (momenteel) niet sequentieel verwerkt, waardoor het van standaardinvoer («B<->») lezen ervan B<niet> ondersteund wordt.

=item B<--ctrl-tarfile> I<archief>

Extraheert de controlegegevens uit een binair pakket en stuurt ze naar de standaarduitvoer in B<tar>-indeling (sinds dpkg 1.17.14). Samen met L<tar(1)> kan dit gebruikt worden om een specifiek controlebestand uit een pakketarchief te extraheren. Het invoerarchief wordt steeds sequentieel verwerkt.

=item B<--fsys-tarfile> I<archief>

Extraheert de gegevens van de bestandssysteemboom uit een binair pakket en stuurt ze naar de standaarduitvoer in B<tar>-indeling. Samen met L<tar(1)> kan dit gebruikt worden om een specifiek bestand uit een pakketarchief te extraheren. Het invoerarchief wordt steeds sequentieel verwerkt.

=item B<-e>, B<--control> I<archief> [I<map>]

Extraheert de bestanden met controle-informatie uit een pakketarchief en plaatst ze in de opgegeven map.

Indien geen map opgegeven werd, wordt een onder de huidige map liggende map B<DEBIAN> gebruikt.

Indien nodig zal de doelmap (maar niet de erboven liggende mappen) aangemaakt worden.

=item B<-?>, B<--help>

Info tonen over het gebruik en afsluiten.

=item B<--version>

De versie tonen en afsluiten.

=back

=head1 OPTIES

=over 

=item B<--showformat=>I<indeling>

Deze optie wordt gebruikt om op te geven in welke indeling B<--show> zijn uitvoer moet produceren. De indeling is een tekenreeks die vorm geeft aan de uitvoer die voor elk opgesomd pakket gegenereerd wordt.

De tekenreeks mag in de vorm “${I<veldnaam>}” verwijzen naar elk statusveld. Een lijst van geldige velden kan gemakkelijk bekomen worden door voor hetzelfde pakket B<-I> te gebruiken. Een volledige uitleg over de indelingsmogelijkheden (met inbegrip van stuurcodes en het bepalen van de tussenruimte tussen velden) kan men vinden in de toelichting bij de optie B<--showformat> van L<dpkg-query(1)>.

De standaard voor dit veld is “${Package}\t${Version}\n”.

=item B<-z>I<compressieniveau>

Specificeren welk compressieniveau gebruikt moet worden door het compressieprogramma bij het bouwen van het pakket (standaard is dat 9 voor gzip, 6 voor xz, 3 voor zstd). Toegestane waarden zijn compressorafhankelijk. Voor gzip is dat 0-9, waarbij 0 vertaald wordt als geen compressie. Voor xz is dat 0-9. Voor zstd is dat 0-22, waarbij de niveaus 20 tot 22 de ultra-modus activeren. Voor dpkg 1.16.2 was niveau 0 het equivalent van geen compressie voor alle compressieprogramma's.

=item B<-S>I<compressiestrategie>

Specificeren welke compressiestrategie gebruikt moet worden door het compressieprogramma bij het bouwen van een pakket (sinds dpkg 1.16.2). Toegestane waarden zijn B<none> (sinds dpkg 1.16.4), B<filtered>, B<huffman>, B<rle> en B<fixed> voor gzip (sinds dpkg 1.17.0) en B<extreme> voor xz.

=item B<-Z>I<compressietype>

Specificeren welk compressietype bij het bouwen van een pakket gebruikt moet worden. Toegestane waarden zijn B<gzip>, B<xz> (sinds dpkg 1.15.6), B<zstd> (sinds dpkg 1.21.18) en B<none> (standaard is B<%DEB_DEFAULT_COMPRESSOR%>).

=item B<--[no-]uniform-compression>

Specificeren dat dezelfde compressieparameters gebruikt moeten worden voor alle archiefonderdelen (d.w.z. B<control.tar> en B<data.tar>; sinds dpkg 1.17.6). Anders zullen die parameters enkel voor het onderdeel B<data.tar> gebruikt worden. De enige ondersteunde compressietypes waarvan het eenvormig gebruik toegelaten is, zijn B<none>, B<gzip>, B<xz> en B<zstd>. De optie B<--no-uniform-compression> schakelt uniforme compressie uit (sinds dpkg 1.19.0). Uniforme compressie is de standaard (sinds dpkg 1.19.0).

=item B<--threads-max=>I<threads>

Stelt het maximum aantal threads in dat is toegestaan voor compressors die multi-threaded operaties ondersteunen (sinds dpkg 1.21.9).

=item B<--root-owner-group>

Voor elk gegevensitem van de bestandssysteemboom de eigenaar en de groep instellen op 'root' met het id 0 (sinds dpkg 1.19.0).

B<Noot>: Deze optie kan nuttig zijn voor een root-loze bouw (zie I<rootless-builds.txt>), maar zou B<niet> gebruikt mogen worden wanneer de eigenaar of de groep van de items niet 'root' is. Daarvoor zal later ondersteuning toegevoegd worden in de vorm van een meta-manifest.

=item B<--deb-format=>I<indeling>

Instellen welke versie van archiefindeling bij het bouwen gebruikt moet worden (sinds dpkg 1.17.0). Toegestane waarden zijn B<2.0> voor de nieuwe indeling en B<0.939000> voor de oude (standaard is B<2.0>).

De oude archiefindeling wordt door niet-Debian gereedschap minder gemakkelijk ontleed en wordt nu als verouderd beschouwd. Het enige nut ervan is nog als pakketten gebouwd worden die moeten ontleed worden door versies van dpkg die ouder zijn dan versie 0.93.76 (september 1995), die enkel uitgegeven werd als een i386 a.out.

=item B<--nocheck>

Dit onderdrukt de gebruikelijke controles die door B<dpkg-deb --build> uitgevoerd worden op de voorgestelde inhoud van een archief. Op die manier kunt u gelijk welk archief bouwen, hoe onklaar het ook is.

=item B<-v>, B<--verbose>

Activeert breedsprakige uitvoer (sinds dpkg 1.16.1). Momenteel heeft dit enkel invloed op B<--extract> dat zich erdoor gaat gedragen als B<--vextract>.

=item B<-D>, B<--debug>

Activeert debug-uitvoer. Dit is weinig interessant.

=back

=head1 AFSLUITSTATUS

=over 

=item B<0>

De gevraagde actie werd succesvol uitgevoerd.

=item B<2>

Fatale of onherstelbare fout die te wijten is aan ongeldig gebruik van de commandoregel of aan interacties met het systeem, zoals het benaderen van de database, het toewijzen van geheugen, enz.

=back

=head1 OMGEVING

=over 

=item B<DPKG_DEB_THREADS_MAX>

Stelt het maximum aantal threads in dat is toegestaan voor compressors die multi-threaded operaties ondersteunen (sinds dpkg 1.21.9).

De optie B<--threads-max> heft deze waarde op.

=item B<DPKG_DEB_COMPRESSOR_TYPE>

Stelt het te gebruiken datacompressietype in (sinds dpkg 1.21.10).

De optie B<-Z> heeft voorrang op deze waarde.

=item B<DPKG_DEB_COMPRESSOR_LEVEL>

Stelt het te gebruiken datacompressieniveau in (sinds dpkg 1.21.10).

De optie B<-z> heeft voorrang op deze waarde.

=item B<DPKG_COLORS>

Stelt de kleurmodus in (sinds dpkg 1.18.5). Waarden die momenteel gebruikt mogen worden zijn: B<auto> (standaard), B<always> en B<never>.

=item B<TMPDIR>

Indien dit ingesteld werd, zal B<dpkg-deb> het gebruiken als de map waarin tijdelijke bestanden en mappen aangemaakt worden.

=item B<SOURCE_DATE_EPOCH>

Indien dit ingesteld werd, zal het gebruikt worden als de tijdsaanduiding (timestamp) (in seconden sinds de epoch) in de L<ar(5)>-container van het L<deb(5)>-bestand en zal het ook gebruikt worden om de mtime vast te zetten op de items uit het L<tar(5)>-bestand.

Since dpkg 1.18.8.

=back

=head1 OPMERKINGEN

Tracht geen software te installeren met enkel maar B<dpkg-deb>! U moet zoals het hoort B<dpkg> gebruiken om er zeker van te zijn dat alle bestanden op de juiste plaats terechtkomen, dat de scripts van het pakket uitgevoerd worden en dat zijn toestand en inhoud bijgehouden worden.

=head1 BEVEILIGING

Het onderzoeken van niet-vertrouwde pakketarchieven of het uitpakken ervan in staging-mappen moet worden beschouwd als een grens van veiligheid en elke doorbreking van die grens als gevolg van deze handelingen moet worden beschouwd als een veiligheidslek. Het omgaan met niet-vertrouwde pakketarchieven mag niet lichtvaardig gebeuren, aangezien het totale gebied elke ondersteunde compressiebibliotheek omvat, naast de archiefindelingen en controlebestanden zelf. Het uitvoeren van deze operaties op basis van niet-vertrouwde gegevens als root wordt sterk afgeraden.

Het bouwen van pakketarchieven mag alleen worden uitgevoerd op basis van vertrouwde gegevens.

=head1 BUGS

B<dpkg-deb -I> I<pakket1>B<.deb> I<pakket2>B<.deb> doet de dingen fout.

Er gebeurt geen authenticatie van de B<.deb>-bestanden. Er gebeurt inderdaad zelfs geen simpele toets van de controlesom. (Hoogwaardig gereedschap, zoals APT, ondersteunt het authenticeren van pakketten die van een opgegeven pakketbron opgehaald werden. En tegenwoordig hebben de meeste pakketten een md5sum-controlebestand dat door debian/rules gegenereerd werd. Dit wordt echter niet rechtstreeks ondersteund door basaal gereedschap.)

=head1 ZIE OOK

F<%PKGDOCDIR%/spec/rootless-builds.txt>, L<deb(5)>, L<deb-control(5)>, L<dpkg(1)>, L<dselect(1)>.