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