dpkg_deb: slight code shrink
[oweals/busybox.git] / archival / Config.in
1 #
2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
4 #
5
6 menu "Archival Utilities"
7
8 config AR
9         bool "ar"
10         default n
11         help
12           ar is an archival utility program used to create, modify, and
13           extract contents from archives.  An archive is a single file holding
14           a collection of other files in a structure that makes it possible to
15           retrieve the original individual files (called archive members).
16           The original files' contents, mode (permissions), timestamp, owner,
17           and group are preserved in the archive, and can be restored on
18           extraction.
19
20           The stored filename is limited to 15 characters. (for more information
21           see long filename support).
22           ar has 60 bytes of overheads for every stored file.
23
24           This implementation of ar can extract archives, it cannot create or
25           modify them.
26           On an x86 system, the ar applet adds about 1K.
27
28           Unless you have a specific application which requires ar, you should
29           probably say N here.
30
31 config FEATURE_AR_LONG_FILENAMES
32         bool "Support for long filenames (not need for debs)"
33         default n
34         depends on AR
35         help
36           By default the ar format can only store the first 15 characters of the
37           filename, this option removes that limitation.
38           It supports the GNU ar long filename method which moves multiple long
39           filenames into a the data section of a new ar entry.
40
41 config BUNZIP2
42         bool "bunzip2"
43         default n
44         help
45           bunzip2 is a compression utility using the Burrows-Wheeler block
46           sorting text compression algorithm, and Huffman coding.  Compression
47           is generally considerably better than that achieved by more
48           conventional LZ77/LZ78-based compressors, and approaches the
49           performance of the PPM family of statistical compressors.
50
51           Unless you have a specific application which requires bunzip2, you
52           should probably say N here.
53
54 config BZIP2
55         bool "bzip2"
56         default n
57         help
58           bzip2 is a compression utility using the Burrows-Wheeler block
59           sorting text compression algorithm, and Huffman coding.  Compression
60           is generally considerably better than that achieved by more
61           conventional LZ77/LZ78-based compressors, and approaches the
62           performance of the PPM family of statistical compressors.
63
64           Unless you have a specific application which requires bzip2, you
65           should probably say N here.
66
67 config CPIO
68         bool "cpio"
69         default n
70         help
71           cpio is an archival utility program used to create, modify, and extract
72           contents from archives.
73           cpio has 110 bytes of overheads for every stored file.
74
75           This implementation of cpio can extract cpio archives created in the
76           "newc" or "crc" format, it cannot create or modify them.
77
78           Unless you have a specific application which requires cpio, you should
79           probably say N here.
80
81 config FEATURE_CPIO_O
82         bool "Support for archive creation"
83         default n
84         depends on CPIO
85         help
86           This implementation of cpio can create cpio archives in the "newc"
87           format only.
88
89 config DPKG
90         bool "dpkg"
91         default n
92         help
93           dpkg is a medium-level tool to install, build, remove and manage
94           Debian packages.
95
96           This implementation of dpkg has a number of limitations,
97           you should use the official dpkg if possible.
98
99 config DPKG_DEB
100         bool "dpkg_deb"
101         default n
102         help
103           dpkg-deb packs, unpacks and provides information about Debian archives.
104
105           This implementation of dpkg-deb cannot pack archives.
106
107           Unless you have a specific application which requires dpkg-deb,
108           say N here.
109
110 config FEATURE_DPKG_DEB_EXTRACT_ONLY
111         bool "Extract only (-x)"
112         default n
113         depends on DPKG_DEB
114         help
115           This reduces dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx".
116           However it saves space as none of the extra dpkg-deb, ar or tar options are
117           needed, they are linked to internally.
118
119 config GUNZIP
120         bool "gunzip"
121         default n
122         help
123           gunzip is used to decompress archives created by gzip.
124           You can use the `-t' option to test the integrity of
125           an archive, without decompressing it.
126
127 config FEATURE_GUNZIP_UNCOMPRESS
128         bool "Uncompress support"
129         default n
130         depends on GUNZIP
131         help
132           Enable if you want gunzip to have the ability to decompress
133           archives created by the program compress (not much
134           used anymore).
135
136 config GZIP
137         bool "gzip"
138         default n
139         help
140           gzip is used to compress files.
141           It's probably the most widely used UNIX compression program.
142
143 config RPM2CPIO
144         bool "rpm2cpio"
145         default n
146         help
147           Converts an RPM file into a CPIO archive.
148
149 config RPM
150         bool "rpm"
151         default n
152         help
153           Mini RPM applet - queries and extracts RPM packages.
154
155 config FEATURE_RPM_BZ2
156         bool "Enable handling of rpms with bzip2-compressed data inside"
157         default n
158         depends on RPM
159         help
160           Enable handling of rpms with bzip2-compressed data inside.
161
162 config TAR
163         bool "tar"
164         default n
165         help
166           tar is an archiving program. It's commonly used with gzip to
167           create compressed archives. It's probably the most widely used
168           UNIX archive program.
169
170 config FEATURE_TAR_CREATE
171         bool "Enable archive creation"
172         default y
173         depends on TAR
174         help
175           If you enable this option you'll be able to create
176           tar archives using the `-c' option.
177
178 config FEATURE_TAR_GZIP
179         bool "Enable -z option"
180         default y
181         depends on TAR
182         help
183           If you enable this option tar will be able to call gzip,
184           when creating or extracting tar gziped archives.
185
186 config FEATURE_TAR_BZIP2
187         bool "Enable -j option to handle .tar.bz2 files"
188         default n
189         depends on TAR
190         help
191           If you enable this option you'll be able to extract
192           archives compressed with bzip2.
193
194 config FEATURE_TAR_LZMA
195         bool "Enable -a option to handle .tar.lzma files"
196         default n
197         depends on TAR
198         help
199           If you enable this option you'll be able to extract
200           archives compressed with lzma.
201
202 config FEATURE_TAR_COMPRESS
203         bool "Enable -Z option"
204         default n
205         depends on TAR
206         help
207           If you enable this option tar will be able to call uncompress,
208           when extracting .tar.Z archives.
209
210 config FEATURE_TAR_AUTODETECT
211         bool "Let tar autodetect gz/bz2 compresses tarballs"
212         default n
213         depends on FEATURE_TAR_GZIP || FEATURE_TAR_BZIP2
214         help
215           With this option tar can automatically detect gzip/bzip2 compressed
216           tarballs. Currently it works only on seekable streams.
217
218 config FEATURE_TAR_FROM
219         bool "Enable -X (exclude from) and -T (include from) options)"
220         default n
221         depends on TAR
222         help
223           If you enable this option you'll be able to specify
224           a list of files to include or exclude from an archive.
225
226 config FEATURE_TAR_OLDGNU_COMPATIBILITY
227         bool "Support for old tar header format"
228         default N
229         depends on TAR
230         help
231           This option is required to unpack archives created in
232           the old GNU format; help to kill this old format by
233           repacking your ancient archives with the new format.
234
235 config FEATURE_TAR_OLDSUN_COMPATIBILITY
236         bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
237         default N
238         depends on TAR
239         help
240           This option is required to unpack archives created by some old
241           version of Sun's tar (it was calculating checksum using signed arithmetic).
242           It is said to be fixed in newer Sun tar, but "old" tarballs still exist.
243
244 config FEATURE_TAR_GNU_EXTENSIONS
245         bool "Support for GNU tar extensions (long filenames)"
246         default y
247         depends on TAR
248         help
249           With this option busybox supports GNU long filenames and
250           linknames.
251
252 config FEATURE_TAR_LONG_OPTIONS
253         bool "Enable long options"
254         default n
255         depends on TAR && GETOPT_LONG
256         help
257           Enable use of long options, increases size by about 400 Bytes
258
259 config FEATURE_TAR_UNAME_GNAME
260         bool "Enable use of user and group names"
261         default n
262         depends on TAR
263         help
264           Enables use of user and group names in tar. This affects contents
265           listings (-t) and preserving permissions when unpacking (-p).
266           +200 bytes.
267
268 config UNCOMPRESS
269         bool "uncompress"
270         default n
271         help
272           uncompress is used to decompress archives created by compress.
273           Not much used anymore, replaced by gzip/gunzip.
274
275 config UNLZMA
276         bool "unlzma"
277         default n
278         help
279           unlzma is a compression utility using the Lempel-Ziv-Markov chain
280           compression algorithm, and range coding.  Compression
281           is generally considerably better than that achieved by the bzip2
282           compressors.
283
284           The BusyBox unlzma applet is limited to de-compression only.
285           On an x86 system, this applet adds about 4K.
286
287           Unless you have a specific application which requires unlzma, you
288           should probably say N here.
289
290 config FEATURE_LZMA_FAST
291         bool "Optimize unlzma for speed"
292         default n
293         depends on UNLZMA
294         help
295           This option reduces decompression time by about 33% at the cost of
296           a 2K bigger binary.
297
298 config UNZIP
299         bool "unzip"
300         default n
301         help
302           unzip will list or extract files from a ZIP archive,
303           commonly found on DOS/WIN systems. The default behavior
304           (with no options) is to extract the archive into the
305           current directory. Use the `-d' option to extract to a
306           directory of your choice.
307
308 comment "Common options for cpio and tar"
309         depends on CPIO || TAR
310
311 comment "Common options for dpkg and dpkg_deb"
312         depends on DPKG || DPKG_DEB
313
314 config FEATURE_DEB_TAR_GZ
315         bool "gzip debian packages (normal)"
316         default y if DPKG || DPKG_DEB
317         depends on DPKG || DPKG_DEB
318         help
319           This is the default compression method inside the debian ar file.
320
321           If you want compatibility with standard .deb's you should say yes here.
322
323 config FEATURE_DEB_TAR_BZ2
324         bool "bzip2 debian packages"
325         default n
326         depends on DPKG || DPKG_DEB
327         help
328           This allows dpkg and dpkg-deb to extract deb's that are compressed internally
329           with bzip2 instead of gzip.
330
331           You only want this if you are creating your own custom debian packages that
332           use an internal control.tar.bz2 or data.tar.bz2.
333
334 config FEATURE_DEB_TAR_LZMA
335         bool "lzma debian packages"
336         default n
337         depends on DPKG || DPKG_DEB
338         help
339           This allows dpkg and dpkg-deb to extract deb's that are compressed
340           internally with lzma instead of gzip.
341
342           You only want this if you are creating your own custom debian
343           packages that use an internal control.tar.lzma or data.tar.lzma.
344
345 endmenu