blob: 808757e28f73e965f76f2d262be054b40beceebb [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
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +000056 bool "Support for long filenames (not need 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
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000060 By default the ar format can only store the first 15 characters of
61 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 Vlasenko7d219aa2006-10-05 10:17:08 +0000113config DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +0000114 bool "dpkg"
115 default n
116 help
Denis Vlasenko0381d422008-07-10 23:06:00 +0000117 dpkg is a medium-level tool to install, build, remove and manage
118 Debian packages.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000119
Denis Vlasenko0381d422008-07-10 23:06:00 +0000120 This implementation of dpkg has a number of limitations,
121 you should use the official dpkg if possible.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000122
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000123config DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000124 bool "dpkg_deb"
125 default n
126 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000127 dpkg-deb packs, unpacks and provides information about Debian
128 archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000129
Glenn L McGrath0337c462002-12-06 22:40:54 +0000130 This implementation of dpkg-deb cannot pack archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000131
Denis Vlasenko0381d422008-07-10 23:06:00 +0000132 Unless you have a specific application which requires dpkg-deb,
133 say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000134
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000135config FEATURE_DPKG_DEB_EXTRACT_ONLY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000136 bool "Extract only (-x)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000137 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000138 depends on DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000139 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000140 This reduces dpkg-deb to the equivalent of
141 "ar -p <deb> data.tar.gz | tar -zx". However it saves space as none
142 of the extra dpkg-deb, ar or tar options are needed, they are linked
143 to internally.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000144
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000145config GUNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000146 bool "gunzip"
147 default n
148 help
Eric Andersene5642112003-07-14 19:37:08 +0000149 gunzip is used to decompress archives created by gzip.
150 You can use the `-t' option to test the integrity of
151 an archive, without decompressing it.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000152
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000153config GZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000154 bool "gzip"
155 default n
156 help
Eric Andersene5642112003-07-14 19:37:08 +0000157 gzip is used to compress files.
Eric Andersen88c916b2003-10-22 09:58:56 +0000158 It's probably the most widely used UNIX compression program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000159
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000160config RPM2CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +0000161 bool "rpm2cpio"
162 default n
163 help
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000164 Converts an RPM file into a CPIO archive.
165
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000166config RPM
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000167 bool "rpm"
168 default n
169 help
Bernhard Reutner-Fischerbfe19502007-01-04 15:44:49 +0000170 Mini RPM applet - queries and extracts RPM packages.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000171
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000172config TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000173 bool "tar"
174 default n
175 help
Eric Andersene5642112003-07-14 19:37:08 +0000176 tar is an archiving program. It's commonly used with gzip to
Eric Andersen88c916b2003-10-22 09:58:56 +0000177 create compressed archives. It's probably the most widely used
Eric Andersene5642112003-07-14 19:37:08 +0000178 UNIX archive program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000179
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000180if TAR
181
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000182config FEATURE_TAR_CREATE
Rob Landley2ec922e2006-04-13 23:22:16 +0000183 bool "Enable archive creation"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000184 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000185 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000186 help
Eric Andersene5642112003-07-14 19:37:08 +0000187 If you enable this option you'll be able to create
188 tar archives using the `-c' option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000189
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000190config FEATURE_TAR_AUTODETECT
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000191 bool "Autodetect gz/bz2 compressed tarballs"
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000192 default n
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000193 depends on FEATURE_SEAMLESS_Z || FEATURE_SEAMLESS_GZ || FEATURE_SEAMLESS_BZ2 || FEATURE_SEAMLESS_LZMA
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000194 help
195 With this option tar can automatically detect gzip/bzip2 compressed
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000196 tarballs. Currently it works only on files (not pipes etc).
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000197
198config FEATURE_TAR_FROM
199 bool "Enable -X (exclude from) and -T (include from) options)"
200 default n
201 depends on TAR
202 help
203 If you enable this option you'll be able to specify
204 a list of files to include or exclude from an archive.
205
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000206config FEATURE_TAR_OLDGNU_COMPATIBILITY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000207 bool "Support for old tar header format"
Glenn L McGrath21110a02003-01-28 01:45:48 +0000208 default N
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000209 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000210 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000211 This option is required to unpack archives created in
212 the old GNU format; help to kill this old format by
Glenn L McGrath21110a02003-01-28 01:45:48 +0000213 repacking your ancient archives with the new format.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000214
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000215config FEATURE_TAR_OLDSUN_COMPATIBILITY
216 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
217 default N
218 depends on TAR
219 help
220 This option is required to unpack archives created by some old
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000221 version of Sun's tar (it was calculating checksum using signed
222 arithmetic). It is said to be fixed in newer Sun tar, but "old"
223 tarballs still exist.
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000224
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000225config FEATURE_TAR_GNU_EXTENSIONS
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000226 bool "Support for GNU tar extensions (long filenames)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000227 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000228 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000229 help
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000230 With this option busybox supports GNU long filenames and
Eric Andersene5642112003-07-14 19:37:08 +0000231 linknames.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000232
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000233config FEATURE_TAR_LONG_OPTIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000234 bool "Enable long options"
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000235 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000236 depends on TAR && GETOPT_LONG
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000237 help
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000238 Enable use of long options, increases size by about 400 Bytes
239
240config FEATURE_TAR_UNAME_GNAME
241 bool "Enable use of user and group names"
242 default n
Denis Vlasenkoe7b43cf2008-02-19 23:42:22 +0000243 depends on TAR
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000244 help
245 Enables use of user and group names in tar. This affects contents
246 listings (-t) and preserving permissions when unpacking (-p).
247 +200 bytes.
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000248
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000249endif #tar
250
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000251config UNCOMPRESS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000252 bool "uncompress"
253 default n
254 help
Eric Andersene5642112003-07-14 19:37:08 +0000255 uncompress is used to decompress archives created by compress.
256 Not much used anymore, replaced by gzip/gunzip.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000257
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000258config UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000259 bool "unlzma"
260 default n
261 help
262 unlzma is a compression utility using the Lempel-Ziv-Markov chain
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000263 compression algorithm, and range coding. Compression
Rob Landleyc1d69902006-01-20 18:28:50 +0000264 is generally considerably better than that achieved by the bzip2
265 compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000266
Rob Landleyc1d69902006-01-20 18:28:50 +0000267 The BusyBox unlzma applet is limited to de-compression only.
268 On an x86 system, this applet adds about 4K.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000269
Rob Landleyc1d69902006-01-20 18:28:50 +0000270 Unless you have a specific application which requires unlzma, you
271 should probably say N here.
272
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000273config FEATURE_LZMA_FAST
Denis Vlasenkoffdcb412008-04-23 05:46:55 +0000274 bool "Optimize unlzma for speed"
Rob Landleyc1d69902006-01-20 18:28:50 +0000275 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000276 depends on UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000277 help
Bernhard Reutner-Fischer5929edc2006-06-07 20:30:01 +0000278 This option reduces decompression time by about 33% at the cost of
Rob Landleyc1d69902006-01-20 18:28:50 +0000279 a 2K bigger binary.
280
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000281config UNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000282 bool "unzip"
283 default n
284 help
Eric Andersene5642112003-07-14 19:37:08 +0000285 unzip will list or extract files from a ZIP archive,
286 commonly found on DOS/WIN systems. The default behavior
287 (with no options) is to extract the archive into the
288 current directory. Use the `-d' option to extract to a
289 directory of your choice.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000290
Eric Andersenc9f20d92002-12-05 08:41:41 +0000291endmenu