blob: 49070da06fdff8acd665f8f5e3e62b31ad70e716 [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
Glenn L McGrath0337c462002-12-06 22:40:54 +000051 The BusyBox bunzip2 applet is limited to de-compression only.
Eric Andersen6d3c7e72003-08-22 21:15:07 +000052 On an x86 system, this applet adds about 11K.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000053
Eric Andersen53601822002-12-05 21:12:42 +000054 Unless you have a specific application which requires bunzip2, you
55 should probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +000056
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000057config CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +000058 bool "cpio"
59 default n
60 help
Glenn L McGrath0337c462002-12-06 22:40:54 +000061 cpio is an archival utility program used to create, modify, and extract
62 contents from archives.
63 cpio has 110 bytes of overheads for every stored file.
64
65 This implementation of cpio can extract cpio archives created in the
Eric Andersenc7bda1c2004-03-15 08:29:22 +000066 "newc" or "crc" format, it cannot create or modify them.
Glenn L McGrath0337c462002-12-06 22:40:54 +000067
68 Unless you have a specific application which requires cpio, you should
69 probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +000070
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000071config DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +000072 bool "dpkg"
73 default n
74 help
Glenn L McGrath0337c462002-12-06 22:40:54 +000075 dpkg is a medium-level tool to install, build, remove and manage Debian packages.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000076
Glenn L McGrath0337c462002-12-06 22:40:54 +000077 This implementation of dpkg has a number of limitations, you should use the
78 official dpkg if possible.
Eric Andersenc9f20d92002-12-05 08:41:41 +000079
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000080config DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +000081 bool "dpkg_deb"
82 default n
83 help
Glenn L McGrath0337c462002-12-06 22:40:54 +000084 dpkg-deb packs, unpacks and provides information about Debian archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000085
Glenn L McGrath0337c462002-12-06 22:40:54 +000086 This implementation of dpkg-deb cannot pack archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +000087
Glenn L McGrath0337c462002-12-06 22:40:54 +000088 Unless you have a specific application which requires dpkg-deb, you should
89 probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +000090
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000091config FEATURE_DPKG_DEB_EXTRACT_ONLY
Rob Landley2ec922e2006-04-13 23:22:16 +000092 bool "extract only (-x)"
Eric Andersenc9f20d92002-12-05 08:41:41 +000093 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000094 depends on DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +000095 help
Eric Andersen88c916b2003-10-22 09:58:56 +000096 This reduces dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx".
Eric Andersenc7bda1c2004-03-15 08:29:22 +000097 However it saves space as none of the extra dpkg-deb, ar or tar options are
Glenn L McGrath0337c462002-12-06 22:40:54 +000098 needed, they are linked to internally.
Eric Andersenc9f20d92002-12-05 08:41:41 +000099
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000100config GUNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000101 bool "gunzip"
102 default n
103 help
Eric Andersene5642112003-07-14 19:37:08 +0000104 gunzip is used to decompress archives created by gzip.
105 You can use the `-t' option to test the integrity of
106 an archive, without decompressing it.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000107
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000108config FEATURE_GUNZIP_UNCOMPRESS
Rob Landley2ec922e2006-04-13 23:22:16 +0000109 bool "Uncompress support"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000110 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000111 depends on GUNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000112 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000113 Enable if you want gunzip to have the ability to decompress
Eric Andersene5642112003-07-14 19:37:08 +0000114 archives created by the program compress (not much
115 used anymore).
Eric Andersenc9f20d92002-12-05 08:41:41 +0000116
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000117config GZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000118 bool "gzip"
119 default n
120 help
Eric Andersene5642112003-07-14 19:37:08 +0000121 gzip is used to compress files.
Eric Andersen88c916b2003-10-22 09:58:56 +0000122 It's probably the most widely used UNIX compression program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000123
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000124config RPM2CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +0000125 bool "rpm2cpio"
126 default n
127 help
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000128 Converts an RPM file into a CPIO archive.
129
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000130config RPM
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000131 bool "rpm"
132 default n
133 help
Bernhard Reutner-Fischerbfe19502007-01-04 15:44:49 +0000134 Mini RPM applet - queries and extracts RPM packages.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000135
Denis Vlasenkoc14d39e2007-06-08 13:05:39 +0000136config FEATURE_RPM_BZ2
137 bool "Enable handling of rpms with bzip2-compressed data inside"
138 default n
139 depends on RPM
140 help
141 Enable handling of rpms with bzip2-compressed data inside.
142
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000143config TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000144 bool "tar"
145 default n
146 help
Eric Andersene5642112003-07-14 19:37:08 +0000147 tar is an archiving program. It's commonly used with gzip to
Eric Andersen88c916b2003-10-22 09:58:56 +0000148 create compressed archives. It's probably the most widely used
Eric Andersene5642112003-07-14 19:37:08 +0000149 UNIX archive program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000150
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000151config FEATURE_TAR_CREATE
Rob Landley2ec922e2006-04-13 23:22:16 +0000152 bool "Enable archive creation"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000153 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000154 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000155 help
Eric Andersene5642112003-07-14 19:37:08 +0000156 If you enable this option you'll be able to create
157 tar archives using the `-c' option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000158
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000159config FEATURE_TAR_BZIP2
Rob Landley2ec922e2006-04-13 23:22:16 +0000160 bool "Enable -j option to handle .tar.bz2 files"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000161 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000162 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000163 help
Eric Andersene5642112003-07-14 19:37:08 +0000164 If you enable this option you'll be able to extract
165 archives compressed with bzip2.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000166
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000167config FEATURE_TAR_LZMA
Rob Landley2ec922e2006-04-13 23:22:16 +0000168 bool "Enable -a option to handle .tar.lzma files"
Rob Landleyc1d69902006-01-20 18:28:50 +0000169 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000170 depends on TAR
Rob Landleyc1d69902006-01-20 18:28:50 +0000171 help
172 If you enable this option you'll be able to extract
173 archives compressed with lzma.
174
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000175config FEATURE_TAR_FROM
Rob Landley2ec922e2006-04-13 23:22:16 +0000176 bool "Enable -X (exclude from) and -T (include from) options)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000177 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000178 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000179 help
Eric Andersene5642112003-07-14 19:37:08 +0000180 If you enable this option you'll be able to specify
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000181 a list of files to include or exclude from an archive.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000182
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000183config FEATURE_TAR_GZIP
Rob Landley2ec922e2006-04-13 23:22:16 +0000184 bool "Enable -z option"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000185 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000186 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000187 help
Eric Andersene5642112003-07-14 19:37:08 +0000188 If you enable this option tar will be able to call gzip,
189 when creating or extracting tar gziped archives.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000190
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000191config FEATURE_TAR_COMPRESS
Rob Landley2ec922e2006-04-13 23:22:16 +0000192 bool "Enable -Z option"
Glenn L McGrath56f16b42003-11-18 21:37:52 +0000193 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000194 depends on TAR
Glenn L McGrath56f16b42003-11-18 21:37:52 +0000195 help
196 If you enable this option tar will be able to call uncompress,
197 when extracting .tar.Z archives.
198
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000199config FEATURE_TAR_OLDGNU_COMPATIBILITY
Rob Landley2ec922e2006-04-13 23:22:16 +0000200 bool "Enable support for old tar header format"
Glenn L McGrath21110a02003-01-28 01:45:48 +0000201 default N
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000202 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000203 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000204 This option is required to unpack archives created in
205 the old GNU format; help to kill this old format by
Glenn L McGrath21110a02003-01-28 01:45:48 +0000206 repacking your ancient archives with the new format.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000207
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000208config FEATURE_TAR_OLDSUN_COMPATIBILITY
209 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
210 default N
211 depends on TAR
212 help
213 This option is required to unpack archives created by some old
214 version of Sun's tar (it was calculating checksum using signed arithmetic).
215 It is said to be fixed in newer Sun tar, but "old" tarballs still exist.
216
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000217config FEATURE_TAR_GNU_EXTENSIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000218 bool "Enable support for some GNU tar extensions"
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 Andersenc7bda1c2004-03-15 08:29:22 +0000222 With this option busybox supports GNU long filenames and
Eric Andersene5642112003-07-14 19:37:08 +0000223 linknames.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000224
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000225config FEATURE_TAR_LONG_OPTIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000226 bool "Enable long options"
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000227 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000228 depends on TAR && GETOPT_LONG
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000229 help
230 Enable use of long options, increases size by about 400 Bytes
231
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000232config UNCOMPRESS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000233 bool "uncompress"
234 default n
235 help
Eric Andersene5642112003-07-14 19:37:08 +0000236 uncompress is used to decompress archives created by compress.
237 Not much used anymore, replaced by gzip/gunzip.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000238
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000239config UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000240 bool "unlzma"
241 default n
242 help
243 unlzma is a compression utility using the Lempel-Ziv-Markov chain
244 compression algorithm, and range coding. Compression
245 is generally considerably better than that achieved by the bzip2
246 compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000247
Rob Landleyc1d69902006-01-20 18:28:50 +0000248 The BusyBox unlzma applet is limited to de-compression only.
249 On an x86 system, this applet adds about 4K.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000250
Rob Landleyc1d69902006-01-20 18:28:50 +0000251 Unless you have a specific application which requires unlzma, you
252 should probably say N here.
253
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000254config FEATURE_LZMA_FAST
Rob Landley2ec922e2006-04-13 23:22:16 +0000255 bool "Optimze unlzma for speed"
Rob Landleyc1d69902006-01-20 18:28:50 +0000256 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000257 depends on UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000258 help
Bernhard Reutner-Fischer5929edc2006-06-07 20:30:01 +0000259 This option reduces decompression time by about 33% at the cost of
Rob Landleyc1d69902006-01-20 18:28:50 +0000260 a 2K bigger binary.
261
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000262config UNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000263 bool "unzip"
264 default n
265 help
Eric Andersene5642112003-07-14 19:37:08 +0000266 unzip will list or extract files from a ZIP archive,
267 commonly found on DOS/WIN systems. The default behavior
268 (with no options) is to extract the archive into the
269 current directory. Use the `-d' option to extract to a
270 directory of your choice.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000271
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000272comment "Common options for cpio and tar"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000273 depends on CPIO || TAR
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000274
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000275config FEATURE_UNARCHIVE_TAPE
Rob Landley2ec922e2006-04-13 23:22:16 +0000276 bool "Enable tape drive support"
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000277 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000278 depends on CPIO || TAR
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000279 help
280 I don't think this is needed anymore.
281
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000282comment "Common options for dpkg and dpkg_deb"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000283 depends on DPKG || DPKG_DEB
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000284
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000285config FEATURE_DEB_TAR_GZ
Rob Landley2ec922e2006-04-13 23:22:16 +0000286 bool "gzip debian packages (normal)"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000287 default y if DPKG || DPKG_DEB
288 depends on DPKG || DPKG_DEB
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000289 help
290 This is the default compression method inside the debian ar file.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000291
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000292 If you want compatibility with standard .deb's you should say yes here.
293
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000294config FEATURE_DEB_TAR_BZ2
Rob Landley2ec922e2006-04-13 23:22:16 +0000295 bool "bzip2 debian packages"
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000296 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000297 depends on DPKG || DPKG_DEB
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000298 help
299 This allows dpkg and dpkg-deb to extract deb's that are compressed internally
300 with bzip2 instead of gzip.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000301
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000302 You only want this if you are creating your own custom debian packages that
303 use an internal control.tar.bz2 or data.tar.bz2.
304
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000305config FEATURE_DEB_TAR_LZMA
Rob Landley2ec922e2006-04-13 23:22:16 +0000306 bool "lzma debian packages"
Rob Landleyc1d69902006-01-20 18:28:50 +0000307 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000308 depends on DPKG || DPKG_DEB
Rob Landleyc1d69902006-01-20 18:28:50 +0000309 help
310 This allows dpkg and dpkg-deb to extract deb's that are compressed
Denis Vlasenkod031ffa2006-11-24 21:54:44 +0000311 internally with lzma instead of gzip.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000312
Rob Landleyc1d69902006-01-20 18:28:50 +0000313 You only want this if you are creating your own custom debian
Denis Vlasenkod031ffa2006-11-24 21:54:44 +0000314 packages that use an internal control.tar.lzma or data.tar.lzma.
Rob Landleyc1d69902006-01-20 18:28:50 +0000315
Eric Andersenc9f20d92002-12-05 08:41:41 +0000316endmenu