blob: 8d31ec77145328544bf90d6383674b1c82e9ecf5 [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
Rob Landley2ec922e2006-04-13 23:22:16 +000032 bool "Enable 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 Vlasenko7d219aa2006-10-05 10:17:08 +000081config DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +000082 bool "dpkg"
83 default n
84 help
Glenn L McGrath0337c462002-12-06 22:40:54 +000085 dpkg is a medium-level tool to install, build, remove and manage Debian packages.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000086
Glenn L McGrath0337c462002-12-06 22:40:54 +000087 This implementation of dpkg has a number of limitations, you should use the
88 official dpkg if possible.
Eric Andersenc9f20d92002-12-05 08:41:41 +000089
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000090config DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +000091 bool "dpkg_deb"
92 default n
93 help
Glenn L McGrath0337c462002-12-06 22:40:54 +000094 dpkg-deb packs, unpacks and provides information about Debian archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000095
Glenn L McGrath0337c462002-12-06 22:40:54 +000096 This implementation of dpkg-deb cannot pack archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000097
Glenn L McGrath0337c462002-12-06 22:40:54 +000098 Unless you have a specific application which requires dpkg-deb, you should
99 probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000100
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000101config FEATURE_DPKG_DEB_EXTRACT_ONLY
Rob Landley2ec922e2006-04-13 23:22:16 +0000102 bool "extract only (-x)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000103 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000104 depends on DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000105 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000106 This reduces dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx".
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000107 However it saves space as none of the extra dpkg-deb, ar or tar options are
Glenn L McGrath0337c462002-12-06 22:40:54 +0000108 needed, they are linked to internally.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000109
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000110config GUNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000111 bool "gunzip"
112 default n
113 help
Eric Andersene5642112003-07-14 19:37:08 +0000114 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.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000117
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000118config FEATURE_GUNZIP_UNCOMPRESS
Rob Landley2ec922e2006-04-13 23:22:16 +0000119 bool "Uncompress support"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000120 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000121 depends on GUNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000122 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000123 Enable if you want gunzip to have the ability to decompress
Eric Andersene5642112003-07-14 19:37:08 +0000124 archives created by the program compress (not much
125 used anymore).
Eric Andersenc9f20d92002-12-05 08:41:41 +0000126
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000127config GZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000128 bool "gzip"
129 default n
130 help
Eric Andersene5642112003-07-14 19:37:08 +0000131 gzip is used to compress files.
Eric Andersen88c916b2003-10-22 09:58:56 +0000132 It's probably the most widely used UNIX compression program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000133
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000134config RPM2CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +0000135 bool "rpm2cpio"
136 default n
137 help
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000138 Converts an RPM file into a CPIO archive.
139
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000140config RPM
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000141 bool "rpm"
142 default n
143 help
Bernhard Reutner-Fischerbfe19502007-01-04 15:44:49 +0000144 Mini RPM applet - queries and extracts RPM packages.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000145
Denis Vlasenkoc14d39e2007-06-08 13:05:39 +0000146config 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
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000153config TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000154 bool "tar"
155 default n
156 help
Eric Andersene5642112003-07-14 19:37:08 +0000157 tar is an archiving program. It's commonly used with gzip to
Eric Andersen88c916b2003-10-22 09:58:56 +0000158 create compressed archives. It's probably the most widely used
Eric Andersene5642112003-07-14 19:37:08 +0000159 UNIX archive program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000160
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000161config FEATURE_TAR_CREATE
Rob Landley2ec922e2006-04-13 23:22:16 +0000162 bool "Enable archive creation"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000163 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000164 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000165 help
Eric Andersene5642112003-07-14 19:37:08 +0000166 If you enable this option you'll be able to create
167 tar archives using the `-c' option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000168
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000169config FEATURE_TAR_BZIP2
Rob Landley2ec922e2006-04-13 23:22:16 +0000170 bool "Enable -j option to handle .tar.bz2 files"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000171 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000172 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000173 help
Eric Andersene5642112003-07-14 19:37:08 +0000174 If you enable this option you'll be able to extract
175 archives compressed with bzip2.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000176
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000177config FEATURE_TAR_LZMA
Rob Landley2ec922e2006-04-13 23:22:16 +0000178 bool "Enable -a option to handle .tar.lzma files"
Rob Landleyc1d69902006-01-20 18:28:50 +0000179 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000180 depends on TAR
Rob Landleyc1d69902006-01-20 18:28:50 +0000181 help
182 If you enable this option you'll be able to extract
183 archives compressed with lzma.
184
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000185config FEATURE_TAR_FROM
Rob Landley2ec922e2006-04-13 23:22:16 +0000186 bool "Enable -X (exclude from) and -T (include from) options)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000187 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000188 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000189 help
Eric Andersene5642112003-07-14 19:37:08 +0000190 If you enable this option you'll be able to specify
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000191 a list of files to include or exclude from an archive.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000192
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000193config FEATURE_TAR_GZIP
Rob Landley2ec922e2006-04-13 23:22:16 +0000194 bool "Enable -z option"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000195 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000196 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000197 help
Eric Andersene5642112003-07-14 19:37:08 +0000198 If you enable this option tar will be able to call gzip,
199 when creating or extracting tar gziped archives.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000200
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000201config FEATURE_TAR_COMPRESS
Rob Landley2ec922e2006-04-13 23:22:16 +0000202 bool "Enable -Z option"
Glenn L McGrath56f16b42003-11-18 21:37:52 +0000203 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000204 depends on TAR
Glenn L McGrath56f16b42003-11-18 21:37:52 +0000205 help
206 If you enable this option tar will be able to call uncompress,
207 when extracting .tar.Z archives.
208
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000209config FEATURE_TAR_OLDGNU_COMPATIBILITY
Rob Landley2ec922e2006-04-13 23:22:16 +0000210 bool "Enable support for old tar header format"
Glenn L McGrath21110a02003-01-28 01:45:48 +0000211 default N
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000212 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000213 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000214 This option is required to unpack archives created in
215 the old GNU format; help to kill this old format by
Glenn L McGrath21110a02003-01-28 01:45:48 +0000216 repacking your ancient archives with the new format.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000217
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000218config FEATURE_TAR_OLDSUN_COMPATIBILITY
219 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
220 default N
221 depends on TAR
222 help
223 This option is required to unpack archives created by some old
224 version of Sun's tar (it was calculating checksum using signed arithmetic).
225 It is said to be fixed in newer Sun tar, but "old" tarballs still exist.
226
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000227config FEATURE_TAR_GNU_EXTENSIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000228 bool "Enable support for some GNU tar extensions"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000229 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000230 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000231 help
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000232 With this option busybox supports GNU long filenames and
Eric Andersene5642112003-07-14 19:37:08 +0000233 linknames.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000234
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000235config FEATURE_TAR_LONG_OPTIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000236 bool "Enable long options"
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000237 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000238 depends on TAR && GETOPT_LONG
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000239 help
240 Enable use of long options, increases size by about 400 Bytes
241
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000242config UNCOMPRESS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000243 bool "uncompress"
244 default n
245 help
Eric Andersene5642112003-07-14 19:37:08 +0000246 uncompress is used to decompress archives created by compress.
247 Not much used anymore, replaced by gzip/gunzip.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000248
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000249config UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000250 bool "unlzma"
251 default n
252 help
253 unlzma is a compression utility using the Lempel-Ziv-Markov chain
254 compression algorithm, and range coding. Compression
255 is generally considerably better than that achieved by the bzip2
256 compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000257
Rob Landleyc1d69902006-01-20 18:28:50 +0000258 The BusyBox unlzma applet is limited to de-compression only.
259 On an x86 system, this applet adds about 4K.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000260
Rob Landleyc1d69902006-01-20 18:28:50 +0000261 Unless you have a specific application which requires unlzma, you
262 should probably say N here.
263
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000264config FEATURE_LZMA_FAST
Rob Landley2ec922e2006-04-13 23:22:16 +0000265 bool "Optimze unlzma for speed"
Rob Landleyc1d69902006-01-20 18:28:50 +0000266 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000267 depends on UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000268 help
Bernhard Reutner-Fischer5929edc2006-06-07 20:30:01 +0000269 This option reduces decompression time by about 33% at the cost of
Rob Landleyc1d69902006-01-20 18:28:50 +0000270 a 2K bigger binary.
271
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000272config UNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000273 bool "unzip"
274 default n
275 help
Eric Andersene5642112003-07-14 19:37:08 +0000276 unzip will list or extract files from a ZIP archive,
277 commonly found on DOS/WIN systems. The default behavior
278 (with no options) is to extract the archive into the
279 current directory. Use the `-d' option to extract to a
280 directory of your choice.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000281
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000282comment "Common options for cpio and tar"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000283 depends on CPIO || TAR
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000284
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000285config FEATURE_UNARCHIVE_TAPE
Rob Landley2ec922e2006-04-13 23:22:16 +0000286 bool "Enable tape drive support"
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000287 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000288 depends on CPIO || TAR
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000289 help
290 I don't think this is needed anymore.
291
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000292comment "Common options for dpkg and dpkg_deb"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000293 depends on DPKG || DPKG_DEB
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000294
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000295config FEATURE_DEB_TAR_GZ
Rob Landley2ec922e2006-04-13 23:22:16 +0000296 bool "gzip debian packages (normal)"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000297 default y if DPKG || DPKG_DEB
298 depends on DPKG || DPKG_DEB
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000299 help
300 This is the default compression method inside the debian ar file.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000301
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000302 If you want compatibility with standard .deb's you should say yes here.
303
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000304config FEATURE_DEB_TAR_BZ2
Rob Landley2ec922e2006-04-13 23:22:16 +0000305 bool "bzip2 debian packages"
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000306 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000307 depends on DPKG || DPKG_DEB
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000308 help
309 This allows dpkg and dpkg-deb to extract deb's that are compressed internally
310 with bzip2 instead of gzip.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000311
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000312 You only want this if you are creating your own custom debian packages that
313 use an internal control.tar.bz2 or data.tar.bz2.
314
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000315config FEATURE_DEB_TAR_LZMA
Rob Landley2ec922e2006-04-13 23:22:16 +0000316 bool "lzma debian packages"
Rob Landleyc1d69902006-01-20 18:28:50 +0000317 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000318 depends on DPKG || DPKG_DEB
Rob Landleyc1d69902006-01-20 18:28:50 +0000319 help
320 This allows dpkg and dpkg-deb to extract deb's that are compressed
Denis Vlasenkod031ffa2006-11-24 21:54:44 +0000321 internally with lzma instead of gzip.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000322
Rob Landleyc1d69902006-01-20 18:28:50 +0000323 You only want this if you are creating your own custom debian
Denis Vlasenkod031ffa2006-11-24 21:54:44 +0000324 packages that use an internal control.tar.lzma or data.tar.lzma.
Rob Landleyc1d69902006-01-20 18:28:50 +0000325
Eric Andersenc9f20d92002-12-05 08:41:41 +0000326endmenu