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
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
|
/*
* dpkg-deb - construction and deconstruction of *.deb archives
* main.c - main program
*
* Copyright © 1994,1995 Ian Jackson <ijackson@chiark.greenend.org.uk>
* Copyright © 2006-2014 Guillem Jover <guillem@debian.org>
*
* This is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#include <config.h>
#include <compat.h>
#include <sys/types.h>
#include <sys/wait.h>
#include <limits.h>
#if HAVE_LOCALE_H
#include <locale.h>
#endif
#include <errno.h>
#include <string.h>
#include <dirent.h>
#include <unistd.h>
#include <stdlib.h>
#include <stdio.h>
#include <dpkg/macros.h>
#include <dpkg/i18n.h>
#include <dpkg/dpkg.h>
#include <dpkg/dpkg-db.h>
#include <dpkg/compress.h>
#include <dpkg/options.h>
#include "dpkg-deb.h"
const char *opt_showformat = "${Package}\t${Version}\n";
static int
printversion(const char *const *argv)
{
printf(_("Debian '%s' package archive backend version %s.\n"),
BACKEND, PACKAGE_RELEASE);
printf(_(
"This is free software; see the GNU General Public License version 2 or\n"
"later for copying conditions. There is NO warranty.\n"));
m_output(stdout, _("<standard output>"));
return 0;
}
static int
usage(const char *const *argv)
{
printf(_(
"Usage: %s [<option>...] <command>\n"
"\n"), BACKEND);
printf(_(
"Commands:\n"
" -b|--build <directory> [<deb>] Build an archive.\n"
" -c|--contents <deb> List contents.\n"
" -I|--info <deb> [<cfile>...] Show info to stdout.\n"
" -W|--show <deb> Show information on package(s)\n"
" -f|--field <deb> [<cfield>...] Show field(s) to stdout.\n"
" -e|--control <deb> [<directory>] Extract control info.\n"
" -x|--extract <deb> <directory> Extract files.\n"
" -X|--vextract <deb> <directory> Extract & list files.\n"
" -R|--raw-extract <deb> <directory>\n"
" Extract control info and files.\n"
" --ctrl-tarfile <deb> Output control tarfile.\n"
" --fsys-tarfile <deb> Output filesystem tarfile.\n"
"\n"));
printf(_(
" -?, --help Show this help message.\n"
" --version Show the version.\n"
"\n"));
printf(_(
"<deb> is the filename of a Debian format archive.\n"
"<cfile> is the name of an administrative file component.\n"
"<cfield> is the name of a field in the main 'control' file.\n"
"\n"));
printf(_(
"Options:\n"
" -v, --verbose Enable verbose output.\n"
" -D, --debug Enable debugging output.\n"
" --showformat=<format> Use alternative format for --show.\n"
" --deb-format=<format> Select archive format.\n"
" Allowed values: 0.939000, 2.0 (default).\n"
" --nocheck Suppress control file check (build bad\n"
" packages).\n"
" --root-owner-group Forces the owner and groups to root.\n"
" --threads-max=<threads> Use at most <threads> with compressor.\n"
" --[no-]uniform-compression Use the compression params on all members.\n"
" -z# Set the compression level when building.\n"
" -Z<type> Set the compression type used when building.\n"
" Allowed types: gzip, xz, zstd, none.\n"
" -S<strategy> Set the compression strategy when building.\n"
" Allowed values: none; extreme (xz);\n"
" filtered, huffman, rle, fixed (gzip).\n"
"\n"));
printf(_(
"Format syntax:\n"
" A format is a string that will be output for each package. The format\n"
" can include the standard escape sequences \\n (newline), \\r (carriage\n"
" return) or \\\\ (plain backslash). Package information can be included\n"
" by inserting variable references to package fields using the ${var[;width]}\n"
" syntax. Fields will be right-aligned unless the width is negative in which\n"
" case left alignment will be used.\n"));
printf(_(
"\n"
"Use 'dpkg' to install and remove packages from your system, or\n"
"'apt' or 'aptitude' for user-friendly package management. Packages\n"
"unpacked using 'dpkg-deb --extract' will be incorrectly installed !\n"));
m_output(stdout, _("<standard output>"));
return 0;
}
static const char printforhelp[] =
N_("Type dpkg-deb --help for help about manipulating *.deb files;\n"
"Type dpkg --help for help about installing and deinstalling packages.");
int opt_debug = 0;
int opt_nocheck = 0;
int opt_verbose = 0;
int opt_root_owner_group = 0;
int opt_uniform_compression = 1;
struct deb_version deb_format = DEB_VERSION(2, 0);
static void
set_deb_format(const struct cmdinfo *cip, const char *value)
{
const char *err;
err = deb_version_parse(&deb_format, value);
if (err)
badusage(_("invalid deb format version: %s"), err);
if ((deb_format.major == 2 && deb_format.minor == 0) ||
(deb_format.major == 0 && deb_format.minor == 939000))
return;
else
badusage(_("unknown deb format version: %s"), value);
}
struct compress_params compress_params_deb0 = {
.type = COMPRESSOR_TYPE_GZIP,
.strategy = COMPRESSOR_STRATEGY_NONE,
.level = -1,
.threads_max = -1,
};
struct compress_params compress_params = {
.type = DEB_DEFAULT_COMPRESSOR,
.strategy = COMPRESSOR_STRATEGY_NONE,
.level = -1,
.threads_max = -1,
};
static long
parse_compress_level(const char *str)
{
long value;
char *end;
errno = 0;
value = strtol(str, &end, 10);
if (str == end || *end != '\0' || errno != 0)
return 0;
return value;
}
static void
set_compress_level(const struct cmdinfo *cip, const char *value)
{
compress_params.level = dpkg_options_parse_arg_int(cip, value);
}
static void
set_compress_strategy(const struct cmdinfo *cip, const char *value)
{
compress_params.strategy = compressor_get_strategy(value);
if (compress_params.strategy == COMPRESSOR_STRATEGY_UNKNOWN)
badusage(_("unknown compression strategy '%s'!"), value);
}
static enum compressor_type
parse_compress_type(const char *value)
{
enum compressor_type type;
type = compressor_find_by_name(value);
if (type == COMPRESSOR_TYPE_UNKNOWN)
badusage(_("unknown compression type '%s'!"), value);
if (type == COMPRESSOR_TYPE_LZMA)
badusage(_("obsolete compression type '%s'; use xz instead"), value);
if (type == COMPRESSOR_TYPE_BZIP2)
badusage(_("obsolete compression type '%s'; use xz or gzip instead"), value);
return type;
}
static void
set_compress_type(const struct cmdinfo *cip, const char *value)
{
compress_params.type = parse_compress_type(value);
}
static long
parse_threads_max(const char *str)
{
long value;
char *end;
errno = 0;
value = strtol(str, &end, 10);
if (str == end || *end != '\0' || errno != 0)
return 0;
return value;
}
static void
set_threads_max(const struct cmdinfo *cip, const char *value)
{
compress_params.threads_max = dpkg_options_parse_arg_int(cip, value);
}
static const struct cmdinfo cmdinfos[]= {
ACTION("build", 'b', 0, do_build),
ACTION("contents", 'c', 0, do_contents),
ACTION("control", 'e', 0, do_control),
ACTION("info", 'I', 0, do_info),
ACTION("field", 'f', 0, do_field),
ACTION("extract", 'x', 0, do_extract),
ACTION("vextract", 'X', 0, do_vextract),
ACTION("raw-extract", 'R', 0, do_raw_extract),
ACTION("ctrl-tarfile", 0, 0, do_ctrltarfile),
ACTION("fsys-tarfile", 0, 0, do_fsystarfile),
ACTION("show", 'W', 0, do_showinfo),
ACTION("help", '?', 0, usage),
ACTION("version", 0, 0, printversion),
{ "deb-format", 0, 1, NULL, NULL, set_deb_format },
{ "debug", 'D', 0, &opt_debug, NULL, NULL, 1 },
{ "verbose", 'v', 0, &opt_verbose, NULL, NULL, 1 },
{ "nocheck", 0, 0, &opt_nocheck, NULL, NULL, 1 },
{ "root-owner-group", 0, 0, &opt_root_owner_group, NULL, NULL, 1 },
{ "threads-max", 0, 1, NULL, NULL, set_threads_max },
{ "uniform-compression", 0, 0, &opt_uniform_compression, NULL, NULL, 1 },
{ "no-uniform-compression", 0, 0, &opt_uniform_compression, NULL, NULL, 0 },
{ NULL, 'z', 1, NULL, NULL, set_compress_level },
{ NULL, 'Z', 1, NULL, NULL, set_compress_type },
{ NULL, 'S', 1, NULL, NULL, set_compress_strategy },
{ "showformat", 0, 1, NULL, &opt_showformat, NULL },
{ NULL, 0, 0, NULL, NULL, NULL }
};
int main(int argc, const char *const *argv) {
struct dpkg_error err;
char *env;
int ret;
dpkg_locales_init(PACKAGE);
dpkg_program_init(BACKEND);
/* XXX: Integrate this into options initialization/parsing. */
env = getenv("DPKG_DEB_THREADS_MAX");
if (str_is_set(env))
compress_params.threads_max = parse_threads_max(env);
env = getenv("DPKG_DEB_COMPRESSOR_TYPE");
if (str_is_set(env))
compress_params.type = parse_compress_type(env);
env = getenv("DPKG_DEB_COMPRESSOR_LEVEL");
if (str_is_set(env))
compress_params.level = parse_compress_level(env);
dpkg_options_parse(&argv, cmdinfos, printforhelp);
if (!cipaction) badusage(_("need an action option"));
if (!compressor_check_params(&compress_params, &err))
badusage(_("invalid compressor parameters: %s"), err.str);
if (!opt_uniform_compression && deb_format.major == 0)
badusage(_("unsupported deb format '%d.%d' with non-uniform compression"),
deb_format.major, deb_format.minor);
if (deb_format.major == 0)
compress_params = compress_params_deb0;
if (opt_uniform_compression &&
(compress_params.type != COMPRESSOR_TYPE_NONE &&
compress_params.type != COMPRESSOR_TYPE_GZIP &&
compress_params.type != COMPRESSOR_TYPE_ZSTD &&
compress_params.type != COMPRESSOR_TYPE_XZ))
badusage(_("unsupported compression type '%s' with uniform compression"),
compressor_get_name(compress_params.type));
ret = cipaction->action(argv);
dpkg_program_done();
dpkg_locales_done();
return ret;
}
|