- wrap overlong lines (Cristian Ionescu-Idbohrn)
[platform/upstream/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
37           the 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
72           extract 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
79           should 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
104           archives.
105
106           This implementation of dpkg-deb cannot pack archives.
107
108           Unless you have a specific application which requires dpkg-deb,
109           say N here.
110
111 config FEATURE_DPKG_DEB_EXTRACT_ONLY
112         bool "Extract only (-x)"
113         default n
114         depends on DPKG_DEB
115         help
116           This reduces dpkg-deb to the equivalent of
117           "ar -p <deb> data.tar.gz | tar -zx". However it saves space as none
118           of the extra dpkg-deb, ar or tar options are needed, they are linked
119           to internally.
120
121 config GUNZIP
122         bool "gunzip"
123         default n
124         help
125           gunzip is used to decompress archives created by gzip.
126           You can use the `-t' option to test the integrity of
127           an archive, without decompressing it.
128
129 config FEATURE_GUNZIP_UNCOMPRESS
130         bool "Uncompress support"
131         default n
132         depends on GUNZIP
133         help
134           Enable if you want gunzip to have the ability to decompress
135           archives created by the program compress (not much
136           used anymore).
137
138 config GZIP
139         bool "gzip"
140         default n
141         help
142           gzip is used to compress files.
143           It's probably the most widely used UNIX compression program.
144
145 config RPM2CPIO
146         bool "rpm2cpio"
147         default n
148         help
149           Converts an RPM file into a CPIO archive.
150
151 config RPM
152         bool "rpm"
153         default n
154         help
155           Mini RPM applet - queries and extracts RPM packages.
156
157 config FEATURE_RPM_BZ2
158         bool "Enable handling of rpms with bzip2-compressed data inside"
159         default n
160         depends on RPM
161         help
162           Enable handling of rpms with bzip2-compressed data inside.
163
164 config TAR
165         bool "tar"
166         default n
167         help
168           tar is an archiving program. It's commonly used with gzip to
169           create compressed archives. It's probably the most widely used
170           UNIX archive program.
171
172 if TAR
173
174 config FEATURE_TAR_CREATE
175         bool "Enable archive creation"
176         default y
177         depends on TAR
178         help
179           If you enable this option you'll be able to create
180           tar archives using the `-c' option.
181
182 config FEATURE_TAR_GZIP
183         bool "Enable -z option"
184         default y
185         depends on TAR
186         help
187           If you enable this option tar will be able to call gzip,
188           when creating or extracting tar gziped archives.
189
190 config FEATURE_TAR_BZIP2
191         bool "Enable -j option to handle .tar.bz2 files"
192         default n
193         depends on TAR
194         help
195           If you enable this option you'll be able to extract
196           archives compressed with bzip2.
197
198 config FEATURE_TAR_LZMA
199         bool "Enable -a option to handle .tar.lzma files"
200         default n
201         depends on TAR
202         help
203           If you enable this option you'll be able to extract
204           archives compressed with lzma.
205
206 config FEATURE_TAR_COMPRESS
207         bool "Enable -Z option"
208         default n
209         depends on TAR
210         help
211           If you enable this option tar will be able to call uncompress,
212           when extracting .tar.Z archives.
213
214 config FEATURE_TAR_AUTODETECT
215         bool "Autodetect gz/bz2 compresses tarballs"
216         default n
217         depends on FEATURE_TAR_GZIP || FEATURE_TAR_BZIP2
218         help
219           With this option tar can automatically detect gzip/bzip2 compressed
220           tarballs. Currently it works only on files (not pipes etc).
221
222 config FEATURE_TAR_FROM
223         bool "Enable -X (exclude from) and -T (include from) options)"
224         default n
225         depends on TAR
226         help
227           If you enable this option you'll be able to specify
228           a list of files to include or exclude from an archive.
229
230 config FEATURE_TAR_OLDGNU_COMPATIBILITY
231         bool "Support for old tar header format"
232         default N
233         depends on TAR
234         help
235           This option is required to unpack archives created in
236           the old GNU format; help to kill this old format by
237           repacking your ancient archives with the new format.
238
239 config FEATURE_TAR_OLDSUN_COMPATIBILITY
240         bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
241         default N
242         depends on TAR
243         help
244           This option is required to unpack archives created by some old
245           version of Sun's tar (it was calculating checksum using signed
246           arithmetic). It is said to be fixed in newer Sun tar, but "old"
247           tarballs still exist.
248
249 config FEATURE_TAR_GNU_EXTENSIONS
250         bool "Support for GNU tar extensions (long filenames)"
251         default y
252         depends on TAR
253         help
254           With this option busybox supports GNU long filenames and
255           linknames.
256
257 config FEATURE_TAR_LONG_OPTIONS
258         bool "Enable long options"
259         default n
260         depends on TAR && GETOPT_LONG
261         help
262           Enable use of long options, increases size by about 400 Bytes
263
264 config FEATURE_TAR_UNAME_GNAME
265         bool "Enable use of user and group names"
266         default n
267         depends on TAR
268         help
269           Enables use of user and group names in tar. This affects contents
270           listings (-t) and preserving permissions when unpacking (-p).
271           +200 bytes.
272
273 endif #tar
274
275 config UNCOMPRESS
276         bool "uncompress"
277         default n
278         help
279           uncompress is used to decompress archives created by compress.
280           Not much used anymore, replaced by gzip/gunzip.
281
282 config UNLZMA
283         bool "unlzma"
284         default n
285         help
286           unlzma is a compression utility using the Lempel-Ziv-Markov chain
287           compression algorithm, and range coding. Compression
288           is generally considerably better than that achieved by the bzip2
289           compressors.
290
291           The BusyBox unlzma applet is limited to de-compression only.
292           On an x86 system, this applet adds about 4K.
293
294           Unless you have a specific application which requires unlzma, you
295           should probably say N here.
296
297 config FEATURE_LZMA_FAST
298         bool "Optimize unlzma for speed"
299         default n
300         depends on UNLZMA
301         help
302           This option reduces decompression time by about 33% at the cost of
303           a 2K bigger binary.
304
305 config UNZIP
306         bool "unzip"
307         default n
308         help
309           unzip will list or extract files from a ZIP archive,
310           commonly found on DOS/WIN systems. The default behavior
311           (with no options) is to extract the archive into the
312           current directory. Use the `-d' option to extract to a
313           directory of your choice.
314
315 comment "Common options for cpio and tar"
316         depends on CPIO || TAR
317
318 comment "Common options for dpkg and dpkg_deb"
319         depends on DPKG || DPKG_DEB
320
321 config FEATURE_DEB_TAR_GZ
322         bool "gzip debian packages (normal)"
323         default y if DPKG || DPKG_DEB
324         depends on DPKG || DPKG_DEB
325         help
326           This is the default compression method inside the debian ar file.
327
328           If you want compatibility with standard .deb's you should say yes
329           here.
330
331 config FEATURE_DEB_TAR_BZ2
332         bool "bzip2 debian packages"
333         default n
334         depends on DPKG || DPKG_DEB
335         help
336           This allows dpkg and dpkg-deb to extract deb's that are compressed
337           internally with bzip2 instead of gzip.
338
339           You only want this if you are creating your own custom debian
340           packages that use an internal control.tar.bz2 or data.tar.bz2.
341
342 config FEATURE_DEB_TAR_LZMA
343         bool "lzma debian packages"
344         default n
345         depends on DPKG || DPKG_DEB
346         help
347           This allows dpkg and dpkg-deb to extract deb's that are compressed
348           internally with lzma instead of gzip.
349
350           You only want this if you are creating your own custom debian
351           packages that use an internal control.tar.lzma or data.tar.lzma.
352
353 endmenu