blob: cae7f20bbe2c07a7294338f8094bd3fbaa0fc550 [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
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000065config BUNZIP2
Eric Andersenc9f20d92002-12-05 08:41:41 +000066 bool "bunzip2"
67 default n
68 help
Eric Andersen88c916b2003-10-22 09:58:56 +000069 bunzip2 is a compression utility using the Burrows-Wheeler block
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000070 sorting text compression algorithm, and Huffman coding. Compression
Eric Andersen53601822002-12-05 21:12:42 +000071 is generally considerably better than that achieved by more
72 conventional LZ77/LZ78-based compressors, and approaches the
Eric Andersenc7bda1c2004-03-15 08:29:22 +000073 performance of the PPM family of statistical compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000074
Eric Andersen53601822002-12-05 21:12:42 +000075 Unless you have a specific application which requires bunzip2, you
76 should probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +000077
Denis Vlasenko77f1ec12007-10-13 03:36:03 +000078config BZIP2
79 bool "bzip2"
80 default n
81 help
82 bzip2 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
Denis Vlasenko77f1ec12007-10-13 03:36:03 +000084 is generally considerably better than that achieved by more
85 conventional LZ77/LZ78-based compressors, and approaches the
86 performance of the PPM family of statistical compressors.
87
88 Unless you have a specific application which requires bzip2, you
89 should probably say N here.
90
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000091config CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +000092 bool "cpio"
93 default n
94 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000095 cpio is an archival utility program used to create, modify, and
96 extract contents from archives.
Glenn L McGrath0337c462002-12-06 22:40:54 +000097 cpio has 110 bytes of overheads for every stored file.
98
99 This implementation of cpio can extract cpio archives created in the
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000100 "newc" or "crc" format, it cannot create or modify them.
Glenn L McGrath0337c462002-12-06 22:40:54 +0000101
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000102 Unless you have a specific application which requires cpio, you
103 should probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000104
Denis Vlasenko261f2372008-04-05 00:07:46 +0000105config FEATURE_CPIO_O
106 bool "Support for archive creation"
107 default n
108 depends on CPIO
109 help
110 This implementation of cpio can create cpio archives in the "newc"
111 format only.
112
Denis Vlasenko83518d12009-03-20 22:17:13 +0000113config FEATURE_CPIO_P
114 bool "Support for passthrough mode"
115 default n
116 depends on FEATURE_CPIO_O
117 help
118 Passthrough mode. Rarely used.
119
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000120config DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +0000121 bool "dpkg"
122 default n
Denis Vlasenko8854b352008-10-15 14:50:14 +0000123 select FEATURE_SEAMLESS_GZ
Eric Andersenc9f20d92002-12-05 08:41:41 +0000124 help
Denis Vlasenko0381d422008-07-10 23:06:00 +0000125 dpkg is a medium-level tool to install, build, remove and manage
126 Debian packages.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000127
Denis Vlasenko0381d422008-07-10 23:06:00 +0000128 This implementation of dpkg has a number of limitations,
129 you should use the official dpkg if possible.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000130
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000131config DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000132 bool "dpkg_deb"
133 default n
Denis Vlasenko8854b352008-10-15 14:50:14 +0000134 select FEATURE_SEAMLESS_GZ
Eric Andersenc9f20d92002-12-05 08:41:41 +0000135 help
Denis Vlasenko8854b352008-10-15 14:50:14 +0000136 dpkg-deb unpacks and provides information about Debian archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000137
Glenn L McGrath0337c462002-12-06 22:40:54 +0000138 This implementation of dpkg-deb cannot pack archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000139
Denis Vlasenko0381d422008-07-10 23:06:00 +0000140 Unless you have a specific application which requires dpkg-deb,
141 say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000142
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000143config FEATURE_DPKG_DEB_EXTRACT_ONLY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000144 bool "Extract only (-x)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000145 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000146 depends on DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000147 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000148 This reduces dpkg-deb to the equivalent of
149 "ar -p <deb> data.tar.gz | tar -zx". However it saves space as none
150 of the extra dpkg-deb, ar or tar options are needed, they are linked
151 to internally.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000152
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000153config GUNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000154 bool "gunzip"
155 default n
156 help
Eric Andersene5642112003-07-14 19:37:08 +0000157 gunzip is used to decompress archives created by gzip.
158 You can use the `-t' option to test the integrity of
159 an archive, without decompressing it.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000160
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000161config GZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000162 bool "gzip"
163 default n
164 help
Eric Andersene5642112003-07-14 19:37:08 +0000165 gzip is used to compress files.
Eric Andersen88c916b2003-10-22 09:58:56 +0000166 It's probably the most widely used UNIX compression program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000167
Denis Vlasenko052ad9a2009-04-29 12:01:51 +0000168config LZOP
169 bool "lzop"
170 default n
171 help
172 Lzop compression/decompresion.
173
174config LZOP_COMPR_HIGH
175 bool "lzop complession levels 7,8,9 (not very useful)"
176 default n
177 depends on LZOP
178 help
179 High levels (7,8,9) of lzop compression. These levels
180 are actually slower than gzip at equivalent compression ratios
181 and take up 3.2K of code.
182
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000183config RPM2CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +0000184 bool "rpm2cpio"
185 default n
186 help
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000187 Converts an RPM file into a CPIO archive.
188
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000189config RPM
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000190 bool "rpm"
191 default n
192 help
Bernhard Reutner-Fischerbfe19502007-01-04 15:44:49 +0000193 Mini RPM applet - queries and extracts RPM packages.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000194
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000195config TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000196 bool "tar"
197 default n
198 help
Eric Andersene5642112003-07-14 19:37:08 +0000199 tar is an archiving program. It's commonly used with gzip to
Eric Andersen88c916b2003-10-22 09:58:56 +0000200 create compressed archives. It's probably the most widely used
Eric Andersene5642112003-07-14 19:37:08 +0000201 UNIX archive program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000202
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000203if TAR
204
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000205config FEATURE_TAR_CREATE
Rob Landley2ec922e2006-04-13 23:22:16 +0000206 bool "Enable archive creation"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000207 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000208 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000209 help
Eric Andersene5642112003-07-14 19:37:08 +0000210 If you enable this option you'll be able to create
211 tar archives using the `-c' option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000212
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000213config FEATURE_TAR_AUTODETECT
Denys Vlasenkobcbd37d2009-06-18 13:23:58 +0200214 bool "Autodetect compressed tarballs"
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000215 default n
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000216 depends on FEATURE_SEAMLESS_Z || FEATURE_SEAMLESS_GZ || FEATURE_SEAMLESS_BZ2 || FEATURE_SEAMLESS_LZMA
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000217 help
Denys Vlasenkobcbd37d2009-06-18 13:23:58 +0200218 With this option tar can automatically detect compressed
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000219 tarballs. Currently it works only on files (not pipes etc).
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000220
221config FEATURE_TAR_FROM
222 bool "Enable -X (exclude from) and -T (include from) options)"
223 default n
224 depends on TAR
225 help
226 If you enable this option you'll be able to specify
227 a list of files to include or exclude from an archive.
228
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000229config FEATURE_TAR_OLDGNU_COMPATIBILITY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000230 bool "Support for old tar header format"
Glenn L McGrath21110a02003-01-28 01:45:48 +0000231 default N
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000232 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000233 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000234 This option is required to unpack archives created in
235 the old GNU format; help to kill this old format by
Glenn L McGrath21110a02003-01-28 01:45:48 +0000236 repacking your ancient archives with the new format.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000237
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000238config FEATURE_TAR_OLDSUN_COMPATIBILITY
239 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
240 default N
241 depends on TAR
242 help
243 This option is required to unpack archives created by some old
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000244 version of Sun's tar (it was calculating checksum using signed
245 arithmetic). It is said to be fixed in newer Sun tar, but "old"
246 tarballs still exist.
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000247
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000248config FEATURE_TAR_GNU_EXTENSIONS
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000249 bool "Support for GNU tar extensions (long filenames)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000250 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000251 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000252 help
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000253 With this option busybox supports GNU long filenames and
Eric Andersene5642112003-07-14 19:37:08 +0000254 linknames.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000255
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000256config FEATURE_TAR_LONG_OPTIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000257 bool "Enable long options"
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000258 default n
Denys Vlasenkof3b92d32009-06-19 12:10:38 +0200259 depends on TAR && LONG_OPTS
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000260 help
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000261 Enable use of long options, increases size by about 400 Bytes
262
263config FEATURE_TAR_UNAME_GNAME
264 bool "Enable use of user and group names"
265 default n
Denis Vlasenkoe7b43cf2008-02-19 23:42:22 +0000266 depends on TAR
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000267 help
268 Enables use of user and group names in tar. This affects contents
269 listings (-t) and preserving permissions when unpacking (-p).
270 +200 bytes.
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000271
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000272endif #tar
273
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000274config UNCOMPRESS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000275 bool "uncompress"
276 default n
277 help
Eric Andersene5642112003-07-14 19:37:08 +0000278 uncompress is used to decompress archives created by compress.
279 Not much used anymore, replaced by gzip/gunzip.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000280
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000281config UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000282 bool "unlzma"
283 default n
284 help
285 unlzma is a compression utility using the Lempel-Ziv-Markov chain
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000286 compression algorithm, and range coding. Compression
Rob Landleyc1d69902006-01-20 18:28:50 +0000287 is generally considerably better than that achieved by the bzip2
288 compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000289
Rob Landleyc1d69902006-01-20 18:28:50 +0000290 The BusyBox unlzma applet is limited to de-compression only.
291 On an x86 system, this applet adds about 4K.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000292
Rob Landleyc1d69902006-01-20 18:28:50 +0000293 Unless you have a specific application which requires unlzma, you
294 should probably say N here.
295
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000296config FEATURE_LZMA_FAST
Denis Vlasenkoffdcb412008-04-23 05:46:55 +0000297 bool "Optimize unlzma for speed"
Rob Landleyc1d69902006-01-20 18:28:50 +0000298 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000299 depends on UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000300 help
Denys Vlasenkof2c184b2009-09-15 23:40:08 +0200301 This option reduces decompression time by about 25% at the cost of
302 a 1K bigger binary.
Rob Landleyc1d69902006-01-20 18:28:50 +0000303
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000304config UNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000305 bool "unzip"
306 default n
307 help
Eric Andersene5642112003-07-14 19:37:08 +0000308 unzip will list or extract files from a ZIP archive,
309 commonly found on DOS/WIN systems. The default behavior
310 (with no options) is to extract the archive into the
311 current directory. Use the `-d' option to extract to a
312 directory of your choice.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000313
Eric Andersenc9f20d92002-12-05 08:41:41 +0000314endmenu