blob: 4f762e860d0f5eb2288d3c0262317c321e7e9d76 [file] [log] [blame]
Eric Andersenc9f20d92002-12-05 08:41:41 +00001#
2# For a description of the syntax of this configuration file,
3# see scripts/kbuild/config-language.txt.
4#
5
6menu "Archival Utilities"
7
Denys Vlasenko602ce692010-05-30 03:35:18 +02008config FEATURE_SEAMLESS_XZ
9 bool "Make tar, rpm, modprobe etc understand .xz data"
10 default n
11 help
12 Make tar, rpm, modprobe etc understand .xz data.
13
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +000014config FEATURE_SEAMLESS_LZMA
Denis Vlasenko540baf62008-08-05 13:16:18 +000015 bool "Make tar, rpm, modprobe etc understand .lzma data"
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +000016 default n
17 help
Denis Vlasenko540baf62008-08-05 13:16:18 +000018 Make tar, rpm, modprobe etc understand .lzma data.
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +000019
20config FEATURE_SEAMLESS_BZ2
Denis Vlasenko540baf62008-08-05 13:16:18 +000021 bool "Make tar, rpm, modprobe etc understand .bz2 data"
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +000022 default n
23 help
Denis Vlasenko540baf62008-08-05 13:16:18 +000024 Make tar, rpm, modprobe etc understand .bz2 data.
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +000025
26config FEATURE_SEAMLESS_GZ
Denis Vlasenko540baf62008-08-05 13:16:18 +000027 bool "Make tar, rpm, modprobe etc understand .gz data"
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +000028 default n
29 help
Denis Vlasenko540baf62008-08-05 13:16:18 +000030 Make tar, rpm, modprobe etc understand .gz data.
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +000031
32config FEATURE_SEAMLESS_Z
33 bool "Make tar and gunzip understand .Z data"
34 default n
35 help
36 Make tar and gunzip understand .Z data.
37
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000038config AR
Eric Andersenc9f20d92002-12-05 08:41:41 +000039 bool "ar"
40 default n
41 help
Eric Andersen53601822002-12-05 21:12:42 +000042 ar is an archival utility program used to create, modify, and
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000043 extract contents from archives. An archive is a single file holding
Eric Andersen53601822002-12-05 21:12:42 +000044 a collection of other files in a structure that makes it possible to
45 retrieve the original individual files (called archive members).
46 The original files' contents, mode (permissions), timestamp, owner,
47 and group are preserved in the archive, and can be restored on
Glenn L McGrath0337c462002-12-06 22:40:54 +000048 extraction.
Eric Andersen6d3c7e72003-08-22 21:15:07 +000049
Glenn L McGrath0337c462002-12-06 22:40:54 +000050 The stored filename is limited to 15 characters. (for more information
51 see long filename support).
52 ar has 60 bytes of overheads for every stored file.
53
54 This implementation of ar can extract archives, it cannot create or
55 modify them.
Eric Andersen6d3c7e72003-08-22 21:15:07 +000056 On an x86 system, the ar applet adds about 1K.
Eric Andersen53601822002-12-05 21:12:42 +000057
58 Unless you have a specific application which requires ar, you should
59 probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +000060
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000061config FEATURE_AR_LONG_FILENAMES
Denys Vlasenkobcbd37d2009-06-18 13:23:58 +020062 bool "Support for long filenames (not needed for debs)"
Eric Andersenc9f20d92002-12-05 08:41:41 +000063 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000064 depends on AR
Eric Andersenc9f20d92002-12-05 08:41:41 +000065 help
Denys Vlasenkobcbd37d2009-06-18 13:23:58 +020066 By default the ar format can only store the first 15 characters
67 of the filename, this option removes that limitation.
Glenn L McGrath0337c462002-12-06 22:40:54 +000068 It supports the GNU ar long filename method which moves multiple long
69 filenames into a the data section of a new ar entry.
Eric Andersenc9f20d92002-12-05 08:41:41 +000070
Alexander Shishkin535584c2010-03-15 15:38:09 +010071config FEATURE_AR_CREATE
72 bool "Support archive creation"
73 default n
74 depends on AR
75 help
76 This enables archive creation (-c and -r) with busybox ar.
77
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000078config BUNZIP2
Eric Andersenc9f20d92002-12-05 08:41:41 +000079 bool "bunzip2"
80 default n
81 help
Eric Andersen88c916b2003-10-22 09:58:56 +000082 bunzip2 is a compression utility using the Burrows-Wheeler block
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000083 sorting text compression algorithm, and Huffman coding. Compression
Eric Andersen53601822002-12-05 21:12:42 +000084 is generally considerably better than that achieved by more
85 conventional LZ77/LZ78-based compressors, and approaches the
Eric Andersenc7bda1c2004-03-15 08:29:22 +000086 performance of the PPM family of statistical compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000087
Eric Andersen53601822002-12-05 21:12:42 +000088 Unless you have a specific application which requires bunzip2, you
89 should probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +000090
Denis Vlasenko77f1ec12007-10-13 03:36:03 +000091config BZIP2
92 bool "bzip2"
93 default n
94 help
95 bzip2 is a compression utility using the Burrows-Wheeler block
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000096 sorting text compression algorithm, and Huffman coding. Compression
Denis Vlasenko77f1ec12007-10-13 03:36:03 +000097 is generally considerably better than that achieved by more
98 conventional LZ77/LZ78-based compressors, and approaches the
99 performance of the PPM family of statistical compressors.
100
101 Unless you have a specific application which requires bzip2, you
102 should probably say N here.
103
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000104config CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +0000105 bool "cpio"
106 default n
107 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000108 cpio is an archival utility program used to create, modify, and
109 extract contents from archives.
Glenn L McGrath0337c462002-12-06 22:40:54 +0000110 cpio has 110 bytes of overheads for every stored file.
111
112 This implementation of cpio can extract cpio archives created in the
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000113 "newc" or "crc" format, it cannot create or modify them.
Glenn L McGrath0337c462002-12-06 22:40:54 +0000114
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000115 Unless you have a specific application which requires cpio, you
116 should probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000117
Denis Vlasenko261f2372008-04-05 00:07:46 +0000118config FEATURE_CPIO_O
119 bool "Support for archive creation"
120 default n
121 depends on CPIO
122 help
123 This implementation of cpio can create cpio archives in the "newc"
124 format only.
125
Denis Vlasenko83518d12009-03-20 22:17:13 +0000126config FEATURE_CPIO_P
127 bool "Support for passthrough mode"
128 default n
129 depends on FEATURE_CPIO_O
130 help
131 Passthrough mode. Rarely used.
132
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000133config DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +0000134 bool "dpkg"
135 default n
Denis Vlasenko8854b352008-10-15 14:50:14 +0000136 select FEATURE_SEAMLESS_GZ
Eric Andersenc9f20d92002-12-05 08:41:41 +0000137 help
Denis Vlasenko0381d422008-07-10 23:06:00 +0000138 dpkg is a medium-level tool to install, build, remove and manage
139 Debian packages.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000140
Denis Vlasenko0381d422008-07-10 23:06:00 +0000141 This implementation of dpkg has a number of limitations,
142 you should use the official dpkg if possible.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000143
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000144config DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000145 bool "dpkg_deb"
146 default n
Denis Vlasenko8854b352008-10-15 14:50:14 +0000147 select FEATURE_SEAMLESS_GZ
Eric Andersenc9f20d92002-12-05 08:41:41 +0000148 help
Denis Vlasenko8854b352008-10-15 14:50:14 +0000149 dpkg-deb unpacks and provides information about Debian archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000150
Glenn L McGrath0337c462002-12-06 22:40:54 +0000151 This implementation of dpkg-deb cannot pack archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000152
Denis Vlasenko0381d422008-07-10 23:06:00 +0000153 Unless you have a specific application which requires dpkg-deb,
154 say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000155
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000156config FEATURE_DPKG_DEB_EXTRACT_ONLY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000157 bool "Extract only (-x)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000158 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000159 depends on DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000160 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000161 This reduces dpkg-deb to the equivalent of
162 "ar -p <deb> data.tar.gz | tar -zx". However it saves space as none
163 of the extra dpkg-deb, ar or tar options are needed, they are linked
164 to internally.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000165
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000166config GUNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000167 bool "gunzip"
168 default n
169 help
Eric Andersene5642112003-07-14 19:37:08 +0000170 gunzip is used to decompress archives created by gzip.
171 You can use the `-t' option to test the integrity of
172 an archive, without decompressing it.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000173
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000174config GZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000175 bool "gzip"
176 default n
177 help
Eric Andersene5642112003-07-14 19:37:08 +0000178 gzip is used to compress files.
Eric Andersen88c916b2003-10-22 09:58:56 +0000179 It's probably the most widely used UNIX compression program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000180
Matheus Izvekov839fd712010-01-06 08:54:49 +0100181config FEATURE_GZIP_LONG_OPTIONS
182 bool "Enable long options"
183 default n
184 depends on GZIP && LONG_OPTS
185 help
186 Enable use of long options, increases size by about 106 Bytes
187
Denis Vlasenko052ad9a2009-04-29 12:01:51 +0000188config LZOP
189 bool "lzop"
190 default n
191 help
192 Lzop compression/decompresion.
193
194config LZOP_COMPR_HIGH
195 bool "lzop complession levels 7,8,9 (not very useful)"
196 default n
197 depends on LZOP
198 help
199 High levels (7,8,9) of lzop compression. These levels
200 are actually slower than gzip at equivalent compression ratios
201 and take up 3.2K of code.
202
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000203config RPM2CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +0000204 bool "rpm2cpio"
205 default n
206 help
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000207 Converts an RPM file into a CPIO archive.
208
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000209config RPM
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000210 bool "rpm"
211 default n
212 help
Bernhard Reutner-Fischerbfe19502007-01-04 15:44:49 +0000213 Mini RPM applet - queries and extracts RPM packages.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000214
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000215config TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000216 bool "tar"
217 default n
218 help
Eric Andersene5642112003-07-14 19:37:08 +0000219 tar is an archiving program. It's commonly used with gzip to
Eric Andersen88c916b2003-10-22 09:58:56 +0000220 create compressed archives. It's probably the most widely used
Eric Andersene5642112003-07-14 19:37:08 +0000221 UNIX archive program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000222
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000223config FEATURE_TAR_CREATE
Rob Landley2ec922e2006-04-13 23:22:16 +0000224 bool "Enable archive creation"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000225 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000226 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000227 help
Eric Andersene5642112003-07-14 19:37:08 +0000228 If you enable this option you'll be able to create
229 tar archives using the `-c' option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000230
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000231config FEATURE_TAR_AUTODETECT
Denys Vlasenkobcbd37d2009-06-18 13:23:58 +0200232 bool "Autodetect compressed tarballs"
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000233 default n
Denys Vlasenko602ce692010-05-30 03:35:18 +0200234 depends on TAR && (FEATURE_SEAMLESS_Z || FEATURE_SEAMLESS_GZ || FEATURE_SEAMLESS_BZ2 || FEATURE_SEAMLESS_LZMA || FEATURE_SEAMLESS_XZ)
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000235 help
Denys Vlasenkobcbd37d2009-06-18 13:23:58 +0200236 With this option tar can automatically detect compressed
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000237 tarballs. Currently it works only on files (not pipes etc).
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000238
239config FEATURE_TAR_FROM
240 bool "Enable -X (exclude from) and -T (include from) options)"
241 default n
242 depends on TAR
243 help
244 If you enable this option you'll be able to specify
245 a list of files to include or exclude from an archive.
246
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000247config FEATURE_TAR_OLDGNU_COMPATIBILITY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000248 bool "Support for old tar header format"
Glenn L McGrath21110a02003-01-28 01:45:48 +0000249 default N
Kim B. Heino820874e2010-03-08 09:19:51 +0200250 depends on TAR || DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +0000251 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000252 This option is required to unpack archives created in
253 the old GNU format; help to kill this old format by
Glenn L McGrath21110a02003-01-28 01:45:48 +0000254 repacking your ancient archives with the new format.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000255
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000256config FEATURE_TAR_OLDSUN_COMPATIBILITY
257 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
258 default N
Kim B. Heino820874e2010-03-08 09:19:51 +0200259 depends on TAR || DPKG
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000260 help
261 This option is required to unpack archives created by some old
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000262 version of Sun's tar (it was calculating checksum using signed
263 arithmetic). It is said to be fixed in newer Sun tar, but "old"
264 tarballs still exist.
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000265
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000266config FEATURE_TAR_GNU_EXTENSIONS
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000267 bool "Support for GNU tar extensions (long filenames)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000268 default y
Kim B. Heino820874e2010-03-08 09:19:51 +0200269 depends on TAR || DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +0000270 help
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000271 With this option busybox supports GNU long filenames and
Eric Andersene5642112003-07-14 19:37:08 +0000272 linknames.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000273
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000274config FEATURE_TAR_LONG_OPTIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000275 bool "Enable long options"
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000276 default n
Denys Vlasenkof3b92d32009-06-19 12:10:38 +0200277 depends on TAR && LONG_OPTS
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000278 help
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000279 Enable use of long options, increases size by about 400 Bytes
280
281config FEATURE_TAR_UNAME_GNAME
282 bool "Enable use of user and group names"
283 default n
Denis Vlasenkoe7b43cf2008-02-19 23:42:22 +0000284 depends on TAR
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000285 help
286 Enables use of user and group names in tar. This affects contents
287 listings (-t) and preserving permissions when unpacking (-p).
288 +200 bytes.
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000289
Mikhail Gusarov0d478332010-01-19 20:22:30 +0600290config FEATURE_TAR_NOPRESERVE_TIME
291 bool "Enable -m (do not preserve time) option"
292 default n
293 depends on TAR
294 help
Denys Vlasenko6b01b712010-01-24 22:52:21 +0100295 With this option busybox supports GNU tar -m
296 (do not preserve time) option.
Mikhail Gusarov0d478332010-01-19 20:22:30 +0600297
J. Tang77a2c512010-03-19 14:48:51 +0100298config FEATURE_TAR_SELINUX
299 bool "Support for extracting SELinux labels"
300 default n
301 depends on TAR && SELINUX
302 help
303 With this option busybox supports restoring SELinux labels
304 when extracting files from tar archives.
305
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000306config UNCOMPRESS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000307 bool "uncompress"
308 default n
309 help
Eric Andersene5642112003-07-14 19:37:08 +0000310 uncompress is used to decompress archives created by compress.
311 Not much used anymore, replaced by gzip/gunzip.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000312
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000313config UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000314 bool "unlzma"
315 default n
316 help
317 unlzma is a compression utility using the Lempel-Ziv-Markov chain
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000318 compression algorithm, and range coding. Compression
Rob Landleyc1d69902006-01-20 18:28:50 +0000319 is generally considerably better than that achieved by the bzip2
320 compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000321
Rob Landleyc1d69902006-01-20 18:28:50 +0000322 The BusyBox unlzma applet is limited to de-compression only.
323 On an x86 system, this applet adds about 4K.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000324
Rob Landleyc1d69902006-01-20 18:28:50 +0000325 Unless you have a specific application which requires unlzma, you
326 should probably say N here.
327
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000328config FEATURE_LZMA_FAST
Denis Vlasenkoffdcb412008-04-23 05:46:55 +0000329 bool "Optimize unlzma for speed"
Rob Landleyc1d69902006-01-20 18:28:50 +0000330 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000331 depends on UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000332 help
Denys Vlasenkof2c184b2009-09-15 23:40:08 +0200333 This option reduces decompression time by about 25% at the cost of
334 a 1K bigger binary.
Rob Landleyc1d69902006-01-20 18:28:50 +0000335
Denys Vlasenkoe04c8672010-05-30 03:33:50 +0200336config LZMA
Denys Vlasenkoccb88a62010-05-27 02:22:54 +0200337 bool "Provide lzma alias which supports only unpacking"
338 default n
339 depends on UNLZMA
340 help
341 Enable this option if you want commands like "lzma -d" to work.
342 IOW: you'll get lzma applet, but it will always require -d option.
343
Denys Vlasenko602ce692010-05-30 03:35:18 +0200344config UNXZ
345 bool "unxz"
346 default n
347 help
348 unxz is a unlzma successor.
349
350config XZ
351 bool "Provide xz alias which supports only unpacking"
352 default n
353 depends on UNXZ
354 help
355 Enable this option if you want commands like "xz -d" to work.
356 IOW: you'll get xz applet, but it will always require -d option.
357
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000358config UNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000359 bool "unzip"
360 default n
361 help
Eric Andersene5642112003-07-14 19:37:08 +0000362 unzip will list or extract files from a ZIP archive,
363 commonly found on DOS/WIN systems. The default behavior
364 (with no options) is to extract the archive into the
365 current directory. Use the `-d' option to extract to a
366 directory of your choice.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000367
Eric Andersenc9f20d92002-12-05 08:41:41 +0000368endmenu