blob: 5d5087bcef0ef3228cc3b14489474e5de216bdac [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 Vlasenko7d219aa2006-10-05 10:17:08 +00008config AR
Eric Andersenc9f20d92002-12-05 08:41:41 +00009 bool "ar"
10 default n
11 help
Eric Andersen53601822002-12-05 21:12:42 +000012 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
Glenn L McGrath0337c462002-12-06 22:40:54 +000018 extraction.
Eric Andersen6d3c7e72003-08-22 21:15:07 +000019
Glenn L McGrath0337c462002-12-06 22:40:54 +000020 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.
Eric Andersen6d3c7e72003-08-22 21:15:07 +000026 On an x86 system, the ar applet adds about 1K.
Eric Andersen53601822002-12-05 21:12:42 +000027
28 Unless you have a specific application which requires ar, you should
29 probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +000030
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000031config FEATURE_AR_LONG_FILENAMES
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +000032 bool "Support for long filenames (not need for debs)"
Eric Andersenc9f20d92002-12-05 08:41:41 +000033 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000034 depends on AR
Eric Andersenc9f20d92002-12-05 08:41:41 +000035 help
Glenn L McGrath0337c462002-12-06 22:40:54 +000036 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.
Eric Andersenc9f20d92002-12-05 08:41:41 +000040
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000041config BUNZIP2
Eric Andersenc9f20d92002-12-05 08:41:41 +000042 bool "bunzip2"
43 default n
44 help
Eric Andersen88c916b2003-10-22 09:58:56 +000045 bunzip2 is a compression utility using the Burrows-Wheeler block
Eric Andersen53601822002-12-05 21:12:42 +000046 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
Eric Andersenc7bda1c2004-03-15 08:29:22 +000049 performance of the PPM family of statistical compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000050
Eric Andersen53601822002-12-05 21:12:42 +000051 Unless you have a specific application which requires bunzip2, you
52 should probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +000053
Denis Vlasenko77f1ec12007-10-13 03:36:03 +000054config 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
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000067config CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +000068 bool "cpio"
69 default n
70 help
Glenn L McGrath0337c462002-12-06 22:40:54 +000071 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
Eric Andersenc7bda1c2004-03-15 08:29:22 +000076 "newc" or "crc" format, it cannot create or modify them.
Glenn L McGrath0337c462002-12-06 22:40:54 +000077
78 Unless you have a specific application which requires cpio, you should
79 probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +000080
Denis Vlasenko261f2372008-04-05 00:07:46 +000081config 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
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000089config DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +000090 bool "dpkg"
91 default n
92 help
Denis Vlasenko0381d422008-07-10 23:06:00 +000093 dpkg is a medium-level tool to install, build, remove and manage
94 Debian packages.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000095
Denis Vlasenko0381d422008-07-10 23:06:00 +000096 This implementation of dpkg has a number of limitations,
97 you should use the official dpkg if possible.
Eric Andersenc9f20d92002-12-05 08:41:41 +000098
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000099config DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000100 bool "dpkg_deb"
101 default n
102 help
Glenn L McGrath0337c462002-12-06 22:40:54 +0000103 dpkg-deb packs, unpacks and provides information about Debian archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000104
Glenn L McGrath0337c462002-12-06 22:40:54 +0000105 This implementation of dpkg-deb cannot pack archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000106
Denis Vlasenko0381d422008-07-10 23:06:00 +0000107 Unless you have a specific application which requires dpkg-deb,
108 say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000109
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000110config FEATURE_DPKG_DEB_EXTRACT_ONLY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000111 bool "Extract only (-x)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000112 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000113 depends on DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000114 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000115 This reduces dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx".
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000116 However it saves space as none of the extra dpkg-deb, ar or tar options are
Glenn L McGrath0337c462002-12-06 22:40:54 +0000117 needed, they are linked to internally.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000118
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000119config GUNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000120 bool "gunzip"
121 default n
122 help
Eric Andersene5642112003-07-14 19:37:08 +0000123 gunzip is used to decompress archives created by gzip.
124 You can use the `-t' option to test the integrity of
125 an archive, without decompressing it.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000126
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000127config FEATURE_GUNZIP_UNCOMPRESS
Rob Landley2ec922e2006-04-13 23:22:16 +0000128 bool "Uncompress support"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000129 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000130 depends on GUNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000131 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000132 Enable if you want gunzip to have the ability to decompress
Eric Andersene5642112003-07-14 19:37:08 +0000133 archives created by the program compress (not much
134 used anymore).
Eric Andersenc9f20d92002-12-05 08:41:41 +0000135
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000136config GZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000137 bool "gzip"
138 default n
139 help
Eric Andersene5642112003-07-14 19:37:08 +0000140 gzip is used to compress files.
Eric Andersen88c916b2003-10-22 09:58:56 +0000141 It's probably the most widely used UNIX compression program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000142
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000143config RPM2CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +0000144 bool "rpm2cpio"
145 default n
146 help
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000147 Converts an RPM file into a CPIO archive.
148
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000149config RPM
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000150 bool "rpm"
151 default n
152 help
Bernhard Reutner-Fischerbfe19502007-01-04 15:44:49 +0000153 Mini RPM applet - queries and extracts RPM packages.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000154
Denis Vlasenkoc14d39e2007-06-08 13:05:39 +0000155config FEATURE_RPM_BZ2
156 bool "Enable handling of rpms with bzip2-compressed data inside"
157 default n
158 depends on RPM
159 help
160 Enable handling of rpms with bzip2-compressed data inside.
161
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000162config TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000163 bool "tar"
164 default n
165 help
Eric Andersene5642112003-07-14 19:37:08 +0000166 tar is an archiving program. It's commonly used with gzip to
Eric Andersen88c916b2003-10-22 09:58:56 +0000167 create compressed archives. It's probably the most widely used
Eric Andersene5642112003-07-14 19:37:08 +0000168 UNIX archive program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000169
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000170if TAR
171
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000172config FEATURE_TAR_CREATE
Rob Landley2ec922e2006-04-13 23:22:16 +0000173 bool "Enable archive creation"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000174 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000175 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000176 help
Eric Andersene5642112003-07-14 19:37:08 +0000177 If you enable this option you'll be able to create
178 tar archives using the `-c' option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000179
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000180config FEATURE_TAR_GZIP
181 bool "Enable -z option"
182 default y
183 depends on TAR
184 help
185 If you enable this option tar will be able to call gzip,
186 when creating or extracting tar gziped archives.
187
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000188config FEATURE_TAR_BZIP2
Rob Landley2ec922e2006-04-13 23:22:16 +0000189 bool "Enable -j option to handle .tar.bz2 files"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000190 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000191 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000192 help
Eric Andersene5642112003-07-14 19:37:08 +0000193 If you enable this option you'll be able to extract
194 archives compressed with bzip2.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000195
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000196config FEATURE_TAR_LZMA
Rob Landley2ec922e2006-04-13 23:22:16 +0000197 bool "Enable -a option to handle .tar.lzma files"
Rob Landleyc1d69902006-01-20 18:28:50 +0000198 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000199 depends on TAR
Rob Landleyc1d69902006-01-20 18:28:50 +0000200 help
201 If you enable this option you'll be able to extract
202 archives compressed with lzma.
203
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000204config FEATURE_TAR_COMPRESS
Rob Landley2ec922e2006-04-13 23:22:16 +0000205 bool "Enable -Z option"
Glenn L McGrath56f16b42003-11-18 21:37:52 +0000206 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000207 depends on TAR
Glenn L McGrath56f16b42003-11-18 21:37:52 +0000208 help
209 If you enable this option tar will be able to call uncompress,
210 when extracting .tar.Z archives.
211
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000212config FEATURE_TAR_AUTODETECT
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000213 bool "Autodetect gz/bz2 compresses tarballs"
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000214 default n
215 depends on FEATURE_TAR_GZIP || FEATURE_TAR_BZIP2
216 help
217 With this option tar can automatically detect gzip/bzip2 compressed
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000218 tarballs. Currently it works only on files (not pipes etc).
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000219
220config FEATURE_TAR_FROM
221 bool "Enable -X (exclude from) and -T (include from) options)"
222 default n
223 depends on TAR
224 help
225 If you enable this option you'll be able to specify
226 a list of files to include or exclude from an archive.
227
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000228config FEATURE_TAR_OLDGNU_COMPATIBILITY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000229 bool "Support for old tar header format"
Glenn L McGrath21110a02003-01-28 01:45:48 +0000230 default N
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000231 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000232 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000233 This option is required to unpack archives created in
234 the old GNU format; help to kill this old format by
Glenn L McGrath21110a02003-01-28 01:45:48 +0000235 repacking your ancient archives with the new format.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000236
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000237config FEATURE_TAR_OLDSUN_COMPATIBILITY
238 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
239 default N
240 depends on TAR
241 help
242 This option is required to unpack archives created by some old
243 version of Sun's tar (it was calculating checksum using signed arithmetic).
244 It is said to be fixed in newer Sun tar, but "old" tarballs still exist.
245
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000246config FEATURE_TAR_GNU_EXTENSIONS
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000247 bool "Support for GNU tar extensions (long filenames)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000248 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000249 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000250 help
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000251 With this option busybox supports GNU long filenames and
Eric Andersene5642112003-07-14 19:37:08 +0000252 linknames.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000253
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000254config FEATURE_TAR_LONG_OPTIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000255 bool "Enable long options"
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000256 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000257 depends on TAR && GETOPT_LONG
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000258 help
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000259 Enable use of long options, increases size by about 400 Bytes
260
261config FEATURE_TAR_UNAME_GNAME
262 bool "Enable use of user and group names"
263 default n
Denis Vlasenkoe7b43cf2008-02-19 23:42:22 +0000264 depends on TAR
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000265 help
266 Enables use of user and group names in tar. This affects contents
267 listings (-t) and preserving permissions when unpacking (-p).
268 +200 bytes.
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000269
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000270endif #tar
271
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000272config UNCOMPRESS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000273 bool "uncompress"
274 default n
275 help
Eric Andersene5642112003-07-14 19:37:08 +0000276 uncompress is used to decompress archives created by compress.
277 Not much used anymore, replaced by gzip/gunzip.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000278
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000279config UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000280 bool "unlzma"
281 default n
282 help
283 unlzma is a compression utility using the Lempel-Ziv-Markov chain
284 compression algorithm, and range coding. Compression
285 is generally considerably better than that achieved by the bzip2
286 compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000287
Rob Landleyc1d69902006-01-20 18:28:50 +0000288 The BusyBox unlzma applet is limited to de-compression only.
289 On an x86 system, this applet adds about 4K.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000290
Rob Landleyc1d69902006-01-20 18:28:50 +0000291 Unless you have a specific application which requires unlzma, you
292 should probably say N here.
293
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000294config FEATURE_LZMA_FAST
Denis Vlasenkoffdcb412008-04-23 05:46:55 +0000295 bool "Optimize unlzma for speed"
Rob Landleyc1d69902006-01-20 18:28:50 +0000296 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000297 depends on UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000298 help
Bernhard Reutner-Fischer5929edc2006-06-07 20:30:01 +0000299 This option reduces decompression time by about 33% at the cost of
Rob Landleyc1d69902006-01-20 18:28:50 +0000300 a 2K bigger binary.
301
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000302config UNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000303 bool "unzip"
304 default n
305 help
Eric Andersene5642112003-07-14 19:37:08 +0000306 unzip will list or extract files from a ZIP archive,
307 commonly found on DOS/WIN systems. The default behavior
308 (with no options) is to extract the archive into the
309 current directory. Use the `-d' option to extract to a
310 directory of your choice.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000311
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000312comment "Common options for cpio and tar"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000313 depends on CPIO || TAR
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000314
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000315comment "Common options for dpkg and dpkg_deb"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000316 depends on DPKG || DPKG_DEB
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000317
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000318config FEATURE_DEB_TAR_GZ
Rob Landley2ec922e2006-04-13 23:22:16 +0000319 bool "gzip debian packages (normal)"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000320 default y if DPKG || DPKG_DEB
321 depends on DPKG || DPKG_DEB
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000322 help
323 This is the default compression method inside the debian ar file.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000324
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000325 If you want compatibility with standard .deb's you should say yes here.
326
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000327config FEATURE_DEB_TAR_BZ2
Rob Landley2ec922e2006-04-13 23:22:16 +0000328 bool "bzip2 debian packages"
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000329 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000330 depends on DPKG || DPKG_DEB
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000331 help
332 This allows dpkg and dpkg-deb to extract deb's that are compressed internally
333 with bzip2 instead of gzip.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000334
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000335 You only want this if you are creating your own custom debian packages that
336 use an internal control.tar.bz2 or data.tar.bz2.
337
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000338config FEATURE_DEB_TAR_LZMA
Rob Landley2ec922e2006-04-13 23:22:16 +0000339 bool "lzma debian packages"
Rob Landleyc1d69902006-01-20 18:28:50 +0000340 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000341 depends on DPKG || DPKG_DEB
Rob Landleyc1d69902006-01-20 18:28:50 +0000342 help
343 This allows dpkg and dpkg-deb to extract deb's that are compressed
Denis Vlasenkod031ffa2006-11-24 21:54:44 +0000344 internally with lzma instead of gzip.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000345
Rob Landleyc1d69902006-01-20 18:28:50 +0000346 You only want this if you are creating your own custom debian
Denis Vlasenkod031ffa2006-11-24 21:54:44 +0000347 packages that use an internal control.tar.lzma or data.tar.lzma.
Rob Landleyc1d69902006-01-20 18:28:50 +0000348
Eric Andersenc9f20d92002-12-05 08:41:41 +0000349endmenu