blob: deacc28222289afc1250fd009e0ee973461c52c9 [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
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +00008config FEATURE_SEAMLESS_LZMA
Denis Vlasenko540baf62008-08-05 13:16:18 +00009 bool "Make tar, rpm, modprobe etc understand .lzma data"
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +000010 default n
11 help
Denis Vlasenko540baf62008-08-05 13:16:18 +000012 Make tar, rpm, modprobe etc understand .lzma data.
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +000013
14config FEATURE_SEAMLESS_BZ2
Denis Vlasenko540baf62008-08-05 13:16:18 +000015 bool "Make tar, rpm, modprobe etc understand .bz2 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 .bz2 data.
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +000019
20config FEATURE_SEAMLESS_GZ
Denis Vlasenko540baf62008-08-05 13:16:18 +000021 bool "Make tar, rpm, modprobe etc understand .gz 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 .gz data.
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +000025
26config FEATURE_SEAMLESS_Z
27 bool "Make tar and gunzip understand .Z data"
28 default n
29 help
30 Make tar and gunzip understand .Z data.
31
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000032config AR
Eric Andersenc9f20d92002-12-05 08:41:41 +000033 bool "ar"
34 default n
35 help
Eric Andersen53601822002-12-05 21:12:42 +000036 ar is an archival utility program used to create, modify, and
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000037 extract contents from archives. An archive is a single file holding
Eric Andersen53601822002-12-05 21:12:42 +000038 a collection of other files in a structure that makes it possible to
39 retrieve the original individual files (called archive members).
40 The original files' contents, mode (permissions), timestamp, owner,
41 and group are preserved in the archive, and can be restored on
Glenn L McGrath0337c462002-12-06 22:40:54 +000042 extraction.
Eric Andersen6d3c7e72003-08-22 21:15:07 +000043
Glenn L McGrath0337c462002-12-06 22:40:54 +000044 The stored filename is limited to 15 characters. (for more information
45 see long filename support).
46 ar has 60 bytes of overheads for every stored file.
47
48 This implementation of ar can extract archives, it cannot create or
49 modify them.
Eric Andersen6d3c7e72003-08-22 21:15:07 +000050 On an x86 system, the ar applet adds about 1K.
Eric Andersen53601822002-12-05 21:12:42 +000051
52 Unless you have a specific application which requires ar, you should
53 probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +000054
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000055config FEATURE_AR_LONG_FILENAMES
Denys Vlasenkobcbd37d2009-06-18 13:23:58 +020056 bool "Support for long filenames (not needed for debs)"
Eric Andersenc9f20d92002-12-05 08:41:41 +000057 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000058 depends on AR
Eric Andersenc9f20d92002-12-05 08:41:41 +000059 help
Denys Vlasenkobcbd37d2009-06-18 13:23:58 +020060 By default the ar format can only store the first 15 characters
61 of the filename, this option removes that limitation.
Glenn L McGrath0337c462002-12-06 22:40:54 +000062 It supports the GNU ar long filename method which moves multiple long
63 filenames into a the data section of a new ar entry.
Eric Andersenc9f20d92002-12-05 08:41:41 +000064
Alexander Shishkin535584c2010-03-15 15:38:09 +010065config FEATURE_AR_CREATE
66 bool "Support archive creation"
67 default n
68 depends on AR
69 help
70 This enables archive creation (-c and -r) with busybox ar.
71
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000072config BUNZIP2
Eric Andersenc9f20d92002-12-05 08:41:41 +000073 bool "bunzip2"
74 default n
75 help
Eric Andersen88c916b2003-10-22 09:58:56 +000076 bunzip2 is a compression utility using the Burrows-Wheeler block
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000077 sorting text compression algorithm, and Huffman coding. Compression
Eric Andersen53601822002-12-05 21:12:42 +000078 is generally considerably better than that achieved by more
79 conventional LZ77/LZ78-based compressors, and approaches the
Eric Andersenc7bda1c2004-03-15 08:29:22 +000080 performance of the PPM family of statistical compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000081
Eric Andersen53601822002-12-05 21:12:42 +000082 Unless you have a specific application which requires bunzip2, you
83 should probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +000084
Denis Vlasenko77f1ec12007-10-13 03:36:03 +000085config BZIP2
86 bool "bzip2"
87 default n
88 help
89 bzip2 is a compression utility using the Burrows-Wheeler block
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000090 sorting text compression algorithm, and Huffman coding. Compression
Denis Vlasenko77f1ec12007-10-13 03:36:03 +000091 is generally considerably better than that achieved by more
92 conventional LZ77/LZ78-based compressors, and approaches the
93 performance of the PPM family of statistical compressors.
94
95 Unless you have a specific application which requires bzip2, you
96 should probably say N here.
97
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000098config CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +000099 bool "cpio"
100 default n
101 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000102 cpio is an archival utility program used to create, modify, and
103 extract contents from archives.
Glenn L McGrath0337c462002-12-06 22:40:54 +0000104 cpio has 110 bytes of overheads for every stored file.
105
106 This implementation of cpio can extract cpio archives created in the
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000107 "newc" or "crc" format, it cannot create or modify them.
Glenn L McGrath0337c462002-12-06 22:40:54 +0000108
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000109 Unless you have a specific application which requires cpio, you
110 should probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000111
Denis Vlasenko261f2372008-04-05 00:07:46 +0000112config FEATURE_CPIO_O
113 bool "Support for archive creation"
114 default n
115 depends on CPIO
116 help
117 This implementation of cpio can create cpio archives in the "newc"
118 format only.
119
Denis Vlasenko83518d12009-03-20 22:17:13 +0000120config FEATURE_CPIO_P
121 bool "Support for passthrough mode"
122 default n
123 depends on FEATURE_CPIO_O
124 help
125 Passthrough mode. Rarely used.
126
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000127config DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +0000128 bool "dpkg"
129 default n
Denis Vlasenko8854b352008-10-15 14:50:14 +0000130 select FEATURE_SEAMLESS_GZ
Eric Andersenc9f20d92002-12-05 08:41:41 +0000131 help
Denis Vlasenko0381d422008-07-10 23:06:00 +0000132 dpkg is a medium-level tool to install, build, remove and manage
133 Debian packages.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000134
Denis Vlasenko0381d422008-07-10 23:06:00 +0000135 This implementation of dpkg has a number of limitations,
136 you should use the official dpkg if possible.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000137
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000138config DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000139 bool "dpkg_deb"
140 default n
Denis Vlasenko8854b352008-10-15 14:50:14 +0000141 select FEATURE_SEAMLESS_GZ
Eric Andersenc9f20d92002-12-05 08:41:41 +0000142 help
Denis Vlasenko8854b352008-10-15 14:50:14 +0000143 dpkg-deb unpacks and provides information about Debian archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000144
Glenn L McGrath0337c462002-12-06 22:40:54 +0000145 This implementation of dpkg-deb cannot pack archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000146
Denis Vlasenko0381d422008-07-10 23:06:00 +0000147 Unless you have a specific application which requires dpkg-deb,
148 say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000149
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000150config FEATURE_DPKG_DEB_EXTRACT_ONLY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000151 bool "Extract only (-x)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000152 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000153 depends on DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000154 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000155 This reduces dpkg-deb to the equivalent of
156 "ar -p <deb> data.tar.gz | tar -zx". However it saves space as none
157 of the extra dpkg-deb, ar or tar options are needed, they are linked
158 to internally.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000159
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000160config GUNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000161 bool "gunzip"
162 default n
163 help
Eric Andersene5642112003-07-14 19:37:08 +0000164 gunzip is used to decompress archives created by gzip.
165 You can use the `-t' option to test the integrity of
166 an archive, without decompressing it.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000167
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000168config GZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000169 bool "gzip"
170 default n
171 help
Eric Andersene5642112003-07-14 19:37:08 +0000172 gzip is used to compress files.
Eric Andersen88c916b2003-10-22 09:58:56 +0000173 It's probably the most widely used UNIX compression program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000174
Matheus Izvekov839fd712010-01-06 08:54:49 +0100175config FEATURE_GZIP_LONG_OPTIONS
176 bool "Enable long options"
177 default n
178 depends on GZIP && LONG_OPTS
179 help
180 Enable use of long options, increases size by about 106 Bytes
181
Denis Vlasenko052ad9a2009-04-29 12:01:51 +0000182config LZOP
183 bool "lzop"
184 default n
185 help
186 Lzop compression/decompresion.
187
188config LZOP_COMPR_HIGH
189 bool "lzop complession levels 7,8,9 (not very useful)"
190 default n
191 depends on LZOP
192 help
193 High levels (7,8,9) of lzop compression. These levels
194 are actually slower than gzip at equivalent compression ratios
195 and take up 3.2K of code.
196
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000197config RPM2CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +0000198 bool "rpm2cpio"
199 default n
200 help
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000201 Converts an RPM file into a CPIO archive.
202
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000203config RPM
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000204 bool "rpm"
205 default n
206 help
Bernhard Reutner-Fischerbfe19502007-01-04 15:44:49 +0000207 Mini RPM applet - queries and extracts RPM packages.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000208
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000209config TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000210 bool "tar"
211 default n
212 help
Eric Andersene5642112003-07-14 19:37:08 +0000213 tar is an archiving program. It's commonly used with gzip to
Eric Andersen88c916b2003-10-22 09:58:56 +0000214 create compressed archives. It's probably the most widely used
Eric Andersene5642112003-07-14 19:37:08 +0000215 UNIX archive program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000216
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000217config FEATURE_TAR_CREATE
Rob Landley2ec922e2006-04-13 23:22:16 +0000218 bool "Enable archive creation"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000219 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000220 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000221 help
Eric Andersene5642112003-07-14 19:37:08 +0000222 If you enable this option you'll be able to create
223 tar archives using the `-c' option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000224
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000225config FEATURE_TAR_AUTODETECT
Denys Vlasenkobcbd37d2009-06-18 13:23:58 +0200226 bool "Autodetect compressed tarballs"
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000227 default n
Kim B. Heino820874e2010-03-08 09:19:51 +0200228 depends on TAR && (FEATURE_SEAMLESS_Z || FEATURE_SEAMLESS_GZ || FEATURE_SEAMLESS_BZ2 || FEATURE_SEAMLESS_LZMA)
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000229 help
Denys Vlasenkobcbd37d2009-06-18 13:23:58 +0200230 With this option tar can automatically detect compressed
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000231 tarballs. Currently it works only on files (not pipes etc).
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000232
233config FEATURE_TAR_FROM
234 bool "Enable -X (exclude from) and -T (include from) options)"
235 default n
236 depends on TAR
237 help
238 If you enable this option you'll be able to specify
239 a list of files to include or exclude from an archive.
240
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000241config FEATURE_TAR_OLDGNU_COMPATIBILITY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000242 bool "Support for old tar header format"
Glenn L McGrath21110a02003-01-28 01:45:48 +0000243 default N
Kim B. Heino820874e2010-03-08 09:19:51 +0200244 depends on TAR || DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +0000245 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000246 This option is required to unpack archives created in
247 the old GNU format; help to kill this old format by
Glenn L McGrath21110a02003-01-28 01:45:48 +0000248 repacking your ancient archives with the new format.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000249
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000250config FEATURE_TAR_OLDSUN_COMPATIBILITY
251 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
252 default N
Kim B. Heino820874e2010-03-08 09:19:51 +0200253 depends on TAR || DPKG
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000254 help
255 This option is required to unpack archives created by some old
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000256 version of Sun's tar (it was calculating checksum using signed
257 arithmetic). It is said to be fixed in newer Sun tar, but "old"
258 tarballs still exist.
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000259
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000260config FEATURE_TAR_GNU_EXTENSIONS
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000261 bool "Support for GNU tar extensions (long filenames)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000262 default y
Kim B. Heino820874e2010-03-08 09:19:51 +0200263 depends on TAR || DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +0000264 help
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000265 With this option busybox supports GNU long filenames and
Eric Andersene5642112003-07-14 19:37:08 +0000266 linknames.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000267
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000268config FEATURE_TAR_LONG_OPTIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000269 bool "Enable long options"
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000270 default n
Denys Vlasenkof3b92d32009-06-19 12:10:38 +0200271 depends on TAR && LONG_OPTS
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000272 help
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000273 Enable use of long options, increases size by about 400 Bytes
274
275config FEATURE_TAR_UNAME_GNAME
276 bool "Enable use of user and group names"
277 default n
Denis Vlasenkoe7b43cf2008-02-19 23:42:22 +0000278 depends on TAR
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000279 help
280 Enables use of user and group names in tar. This affects contents
281 listings (-t) and preserving permissions when unpacking (-p).
282 +200 bytes.
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000283
Mikhail Gusarov0d478332010-01-19 20:22:30 +0600284config FEATURE_TAR_NOPRESERVE_TIME
285 bool "Enable -m (do not preserve time) option"
286 default n
287 depends on TAR
288 help
Denys Vlasenko6b01b712010-01-24 22:52:21 +0100289 With this option busybox supports GNU tar -m
290 (do not preserve time) option.
Mikhail Gusarov0d478332010-01-19 20:22:30 +0600291
J. Tang77a2c512010-03-19 14:48:51 +0100292config FEATURE_TAR_SELINUX
293 bool "Support for extracting SELinux labels"
294 default n
295 depends on TAR && SELINUX
296 help
297 With this option busybox supports restoring SELinux labels
298 when extracting files from tar archives.
299
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000300config UNCOMPRESS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000301 bool "uncompress"
302 default n
303 help
Eric Andersene5642112003-07-14 19:37:08 +0000304 uncompress is used to decompress archives created by compress.
305 Not much used anymore, replaced by gzip/gunzip.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000306
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000307config UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000308 bool "unlzma"
309 default n
310 help
311 unlzma is a compression utility using the Lempel-Ziv-Markov chain
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000312 compression algorithm, and range coding. Compression
Rob Landleyc1d69902006-01-20 18:28:50 +0000313 is generally considerably better than that achieved by the bzip2
314 compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000315
Rob Landleyc1d69902006-01-20 18:28:50 +0000316 The BusyBox unlzma applet is limited to de-compression only.
317 On an x86 system, this applet adds about 4K.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000318
Rob Landleyc1d69902006-01-20 18:28:50 +0000319 Unless you have a specific application which requires unlzma, you
320 should probably say N here.
321
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000322config FEATURE_LZMA_FAST
Denis Vlasenkoffdcb412008-04-23 05:46:55 +0000323 bool "Optimize unlzma for speed"
Rob Landleyc1d69902006-01-20 18:28:50 +0000324 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000325 depends on UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000326 help
Denys Vlasenkof2c184b2009-09-15 23:40:08 +0200327 This option reduces decompression time by about 25% at the cost of
328 a 1K bigger binary.
Rob Landleyc1d69902006-01-20 18:28:50 +0000329
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000330config UNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000331 bool "unzip"
332 default n
333 help
Eric Andersene5642112003-07-14 19:37:08 +0000334 unzip will list or extract files from a ZIP archive,
335 commonly found on DOS/WIN systems. The default behavior
336 (with no options) is to extract the archive into the
337 current directory. Use the `-d' option to extract to a
338 directory of your choice.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000339
Eric Andersenc9f20d92002-12-05 08:41:41 +0000340endmenu