blob: 64b44c218c90f311614f8bb02de2089a29a35ea9 [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 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 Vlasenko7d219aa2006-10-05 10:17:08 +0000168config RPM2CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +0000169 bool "rpm2cpio"
170 default n
171 help
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000172 Converts an RPM file into a CPIO archive.
173
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000174config RPM
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000175 bool "rpm"
176 default n
177 help
Bernhard Reutner-Fischerbfe19502007-01-04 15:44:49 +0000178 Mini RPM applet - queries and extracts RPM packages.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000179
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000180config TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000181 bool "tar"
182 default n
183 help
Eric Andersene5642112003-07-14 19:37:08 +0000184 tar is an archiving program. It's commonly used with gzip to
Eric Andersen88c916b2003-10-22 09:58:56 +0000185 create compressed archives. It's probably the most widely used
Eric Andersene5642112003-07-14 19:37:08 +0000186 UNIX archive program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000187
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000188if TAR
189
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000190config FEATURE_TAR_CREATE
Rob Landley2ec922e2006-04-13 23:22:16 +0000191 bool "Enable archive creation"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000192 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000193 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000194 help
Eric Andersene5642112003-07-14 19:37:08 +0000195 If you enable this option you'll be able to create
196 tar archives using the `-c' option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000197
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000198config FEATURE_TAR_AUTODETECT
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000199 bool "Autodetect gz/bz2 compressed tarballs"
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000200 default n
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000201 depends on FEATURE_SEAMLESS_Z || FEATURE_SEAMLESS_GZ || FEATURE_SEAMLESS_BZ2 || FEATURE_SEAMLESS_LZMA
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000202 help
203 With this option tar can automatically detect gzip/bzip2 compressed
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000204 tarballs. Currently it works only on files (not pipes etc).
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000205
206config FEATURE_TAR_FROM
207 bool "Enable -X (exclude from) and -T (include from) options)"
208 default n
209 depends on TAR
210 help
211 If you enable this option you'll be able to specify
212 a list of files to include or exclude from an archive.
213
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000214config FEATURE_TAR_OLDGNU_COMPATIBILITY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000215 bool "Support for old tar header format"
Glenn L McGrath21110a02003-01-28 01:45:48 +0000216 default N
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000217 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000218 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000219 This option is required to unpack archives created in
220 the old GNU format; help to kill this old format by
Glenn L McGrath21110a02003-01-28 01:45:48 +0000221 repacking your ancient archives with the new format.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000222
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000223config FEATURE_TAR_OLDSUN_COMPATIBILITY
224 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
225 default N
226 depends on TAR
227 help
228 This option is required to unpack archives created by some old
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000229 version of Sun's tar (it was calculating checksum using signed
230 arithmetic). It is said to be fixed in newer Sun tar, but "old"
231 tarballs still exist.
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000232
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000233config FEATURE_TAR_GNU_EXTENSIONS
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000234 bool "Support for GNU tar extensions (long filenames)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000235 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000236 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000237 help
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000238 With this option busybox supports GNU long filenames and
Eric Andersene5642112003-07-14 19:37:08 +0000239 linknames.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000240
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000241config FEATURE_TAR_LONG_OPTIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000242 bool "Enable long options"
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000243 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000244 depends on TAR && GETOPT_LONG
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000245 help
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000246 Enable use of long options, increases size by about 400 Bytes
247
248config FEATURE_TAR_UNAME_GNAME
249 bool "Enable use of user and group names"
250 default n
Denis Vlasenkoe7b43cf2008-02-19 23:42:22 +0000251 depends on TAR
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000252 help
253 Enables use of user and group names in tar. This affects contents
254 listings (-t) and preserving permissions when unpacking (-p).
255 +200 bytes.
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000256
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000257endif #tar
258
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000259config UNCOMPRESS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000260 bool "uncompress"
261 default n
262 help
Eric Andersene5642112003-07-14 19:37:08 +0000263 uncompress is used to decompress archives created by compress.
264 Not much used anymore, replaced by gzip/gunzip.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000265
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000266config UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000267 bool "unlzma"
268 default n
269 help
270 unlzma is a compression utility using the Lempel-Ziv-Markov chain
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000271 compression algorithm, and range coding. Compression
Rob Landleyc1d69902006-01-20 18:28:50 +0000272 is generally considerably better than that achieved by the bzip2
273 compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000274
Rob Landleyc1d69902006-01-20 18:28:50 +0000275 The BusyBox unlzma applet is limited to de-compression only.
276 On an x86 system, this applet adds about 4K.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000277
Rob Landleyc1d69902006-01-20 18:28:50 +0000278 Unless you have a specific application which requires unlzma, you
279 should probably say N here.
280
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000281config FEATURE_LZMA_FAST
Denis Vlasenkoffdcb412008-04-23 05:46:55 +0000282 bool "Optimize unlzma for speed"
Rob Landleyc1d69902006-01-20 18:28:50 +0000283 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000284 depends on UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000285 help
Bernhard Reutner-Fischer5929edc2006-06-07 20:30:01 +0000286 This option reduces decompression time by about 33% at the cost of
Rob Landleyc1d69902006-01-20 18:28:50 +0000287 a 2K bigger binary.
288
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000289config UNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000290 bool "unzip"
291 default n
292 help
Eric Andersene5642112003-07-14 19:37:08 +0000293 unzip will list or extract files from a ZIP archive,
294 commonly found on DOS/WIN systems. The default behavior
295 (with no options) is to extract the archive into the
296 current directory. Use the `-d' option to extract to a
297 directory of your choice.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000298
Eric Andersenc9f20d92002-12-05 08:41:41 +0000299endmenu